Démarrage rapide : configurer un stockage amovible en tant que périphérique de lecture automatique (HTML)

Article
12/11/2015

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Vous pouvez identifier un périphérique de volume, tel qu’une carte mémoire ou une clé USB, comme périphérique de lecture automatique lorsque le périphérique de volume est connecté à un PC. Cette fonctionnalité est particulièrement utile lorsque vous voulez associer une application spécifique pour la lecture automatique à présenter à l’utilisateur pour votre périphérique de volume.

Voici comment identifier votre périphérique de volume comme périphérique de lecture automatique.

Pour identifier votre périphérique de volume comme périphérique de lecture automatique, ajoutez un fichier autorun.inf au lecteur racine de votre périphérique. Dans le fichier autorun.inf, ajoutez une clé CustomEvent à la section AutoRun. Lorsque votre périphérique de volume se connecte à un PC, la lecture automatique trouve le fichier autorun.inf et traite votre volume comme un périphérique. La lecture automatique crée un événement de lecture automatique à l’aide du nom que vous avez fourni dans la clé CustomEvent. Vous pouvez alors créer une application et l’inscrire en tant que gestionnaire de cet événement de lecture automatique. Lorsque le périphérique est connecté au PC, la lecture automatique affiche votre application comme gestionnaire de votre périphérique de volume. Pour plus d’informations sur les fichiers autorun.inf, voir Entrées du fichier Autorun.inf.

Fabricants de périphériques :: La lecture automatique ne télécharge pas automatiquement l’application que vous créez en tant que gestionnaire pour votre périphérique. Cependant, comme toujours, les utilisateurs peuvent obtenir votre application dans le Windows Store. Pour créer une expérience plus rationalisée, utilisez les métadonnées du périphérique pour associer votre application à votre périphérique. Si vous associez votre application en tant qu’application à installation automatique pour l’ID d’expérience de votre périphérique, le système d’exploitation détecte cette association quand votre périphérique est connecté à un PC. Si votre application n’est pas installée sur votre PC, le système d’exploitation la télécharge et l’installe automatiquement. La lecture automatique présente votre application comme première option que l’utilisateur peut choisir comme gestionnaire de votre périphérique. Pour plus d’informations, voir Lecture automatique pour les applications du Windows Store pour périphérique.

Objectif: Créez une application pour gérer un événement de lecture automatique personnalisé pour un périphérique de volume.

Prérequis

Vous devez disposer d’un périphérique de volume tel qu’une clé USB ou une carte mémoire pour effectuer les instructions figurant dans ce guide de démarrage rapide.

Microsoft Visual Studio

Instructions

1. Créer un fichier autorun.inf

Dans le lecteur racine de votre appareil de volume, ajoutez un fichier nommé autorun.inf. Ouvrez le fichier autorun.inf et ajoutez le texte suivant.
```
[AutoRun]
CustomEvent=AutoPlayCustomEventQuickstart
```

2. Créer un projet et ajouter les déclarations de lecture automatique

Ouvrez Visual Studio et sélectionnez Nouveau projet dans le menu Fichier. Dans la section JavaScript, sélectionnez Windows Store. Attribuez à l’application le nom AutoPlayCustomEvent, puis cliquez sur OK.
Ouvrez le fichier Package.appxmanifest, puis sélectionnez l’onglet Capacités. Sélectionnez la fonctionnalité Stockage amovible. Cela permet à l’application d’accéder aux fichiers et dossiers situés sur les périphériques de stockage amovibles.
Dans le fichier manifeste, sélectionnez l’onglet Déclarations. Dans la liste déroulante Déclarations disponibles, sélectionnez Contenu de lecture automatique, puis cliquez sur Ajouter. Sélectionnez le nouvel élément Contenu de lecture automatique ajouté à la liste Déclarations prises en charge.

Remarque Vous pouvez également choisir d’ajouter une déclaration Périphérique de lecture automatique pour votre événement de lecture automatique personnalisé.
Dans la section Actions de lancement de votre déclaration d’événement Contenu de lecture automatique, entrez les valeurs suivantes pour la première action de lancement.

Paramètre Valeur

Verbe show

Nom complet de l’action Afficher les dossiers

Événement de contenu AutoPlayCustomEventQuickstart

La valeur Événement de contenu correspond au texte que vous avez fourni pour la clé CustomEvent dans votre fichier autorun.inf. Le paramètre Nom complet de l’action identifie la chaîne que la lecture automatique affiche pour votre application. Le paramètre Verbe identifie une valeur qui est transmise à votre application pour l’option sélectionnée. Vous pouvez spécifier plusieurs options de lancement pour un événement de lecture automatique et utiliser le paramètre Verbe pour déterminer quelle option l’utilisateur a sélectionnée pour votre application. Vous pouvez vérifier quelle option a été sélectionnée par l’utilisateur par le biais de la propriété verb des arguments d’événement de démarrage transmis à votre application. Vous pouvez attribuer n’importe quelle valeur au paramètre Verbe, sauf la valeur open qui est réservée.
Dans la liste déroulante Déclarations disponibles, sélectionnez Associations de types de fichiers, puis cliquez sur Ajouter. Dans les propriétés de la nouvelle déclaration Associations de types de fichiers, attribuez au champ Nom complet la valeur Show .ms Files et au champ Nom la valeur ms_association. Dans la section Types de fichiers pris en charge, cliquez sur Ajouter nouveau. Attribuez au champ Type de fichier la valeur .ms. Pour les événements de contenu, la lecture automatique filtre les types de fichiers qui ne sont pas explicitement associés à votre application.
Enregistrez et fermez le fichier manifeste.

Paramètre	Valeur
Verbe	show
Nom complet de l’action	Afficher les dossiers
Événement de contenu	AutoPlayCustomEventQuickstart

3. Ajouter une interface utilisateur HTML

Ouvrez le fichier Default.html et placez le code HTML suivant dans la section <body>.
```
<h2>Files</h2>
<div id="files" style="width:400px;height:600px;font-size:large;" />
```
.

4. Ajouter du code d’activation

Dans les étapes suivantes, le code appelle une fonction destinée à afficher les dossiers présents dans le lecteur racine de votre périphérique de volume. Pour les événements de contenu de lecture automatique, la lecture automatique passe le dossier racine du périphérique de stockage dans les arguments de démarrage qui sont transmis à l’application. Vous pouvez récupérer ce dossier à partir du premier élément de la propriété detail.files. Vous pouvez savoir que l’application a été lancée en tant que gestionnaire pour un événement de contenu de lecture automatique si la propriété detail.kind des arguments d’événement d’activation retourne la valeur Windows.ApplicationModel.Activation.ActivationKind.file.

Ouvrez le dossier js. Ouvrez le fichier Default.js et remplacez la fonction onactivated par défaut par le code suivant.

var filesDiv;

app.onactivated = function (args) {
    if (args.detail.kind === activation.ActivationKind.file) {
        filesDiv = document.getElementById("files");
        displayFiles(args.detail.files[0]);
    }

    args.setPromise(WinJS.UI.processAll());
};

5. Ajouter du code pour afficher des noms de dossiers

Dans le fichier Default.js, ajoutez le code suivant après la fonction onactivated.

function displayFiles(folder) {
    var options = new Windows.Storage.Search.QueryOptions();
    options.fileTypeFilter.append(".ms");
    var query = folder.createFileQueryWithOptions(options);
    query.getFilesAsync().done(
        function (files) {
            files.forEach(
                function (f) {
                    filesDiv.innerHTML += "&nbsp;&nbsp;" + f.name + "<br/>";
            });
        });
}

6. Créer et exécuter l’application

Appuyez sur F5 pour créer et déployer l’application (en mode débogage).
Pour exécuter votre application, insérez une carte mémoire ou un autre périphérique de stockage dans votre PC. Sélectionnez ensuite votre application dans la liste des options de gestionnaire de lecture automatique.

Récapitulatif et étapes suivantes

Dans ce didacticiel, vous avez identifié un périphérique de volume comme périphérique de lecture automatique en définissant un événement de lecture automatique personnalisé dans un fichier autorun.inf. Vous avez ensuite créé une application qui s’inscrit en tant que gestionnaire de cet événement personnalisé.

Rubriques associées

Démarrage automatique avec lecture automatique