Guida introduttiva: Configurare un archivio rimovibile come dispositivo AutoPlay (HTML)

Articolo
12/11/2015

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Puoi identificare un dispositivo del volume, come una scheda di memoria o una chiavetta USB, come dispositivo AutoPlay quando il dispositivo del volume viene connesso a un PC. Ciò è particolarmente utile quando vuoi associare un'app specifica per AutoPlay da presentare all'utente per il tuo dispositivo del volume.

In questo articolo illustriamo come identificare il dispositivo del volume come dispositivo AutoPlay.

Per identificare il tuo dispositivo del volume come dispositivo AutoPlay, aggiungi un file autorun.inf all'unità radice del dispositivo. Nel file autorun.inf aggiungi una chiave CustomEvent alla sezione AutoRun. Quando il dispositivo del volume viene collegato a un PC, AutoPlay individua il file autorun.inf e considera il volume come un dispositivo. AutoPlay crea un evento AutoPlay usando il nome specificato per la chiave CustomEvent. Puoi quindi creare un'app e registrarla come gestore dell'evento AutoPlay. Quando il dispositivo è connesso al PC, AutoPlay visualizza l'app come gestore del dispositivo del volume. Per altre info sui file autorun.inf, vedi l'argomento relativo alle voci di autorun.inf.

Produttori di dispositivi:: AutoPlay non carica automaticamente l'app creata come gestore per il dispositivo. Come sempre, però, gli utenti possono ottenere la tua app da Windows Store. Per creare un'esperienza utente più semplice, usa i metadati di dispositivo per associare l'app al tuo dispositivo. Se associ l'app come app a installazione automatica per l'ID esperienza del dispositivo, il sistema operativo individuerà l'associazione quando il dispositivo viene collegato a un PC. Se l'app non è installata nel PC, il sistema operativo la scaricherà e installerà automaticamente. AutoPlay presenterà l'app all'utente come la prima scelta tra i gestori disponibili per il dispositivo. Per altre informazioni, vedi AutoPlay per le app di Windows Store per dispositivo.

Obiettivo: Crea un'app per gestire un evento AutoPlay personalizzato per un dispositivo del volume.

Prerequisiti

Per completare le istruzioni di questa guida introduttiva, devi disporre di un dispositivo del volume come una scheda di memoria o una chiavetta.

Microsoft Visual Studio

Istruzioni

1. Creare un file autorun.inf

Nell'unità radice del dispositivo del volume aggiungi un file denominato autorun.inf. Apri il file autorun.inf e aggiungi il testo seguente.
```
[AutoRun]
CustomEvent=AutoPlayCustomEventQuickstart
```

2. Creare un nuovo progetto e aggiungere le dichiarazioni AutoPlay

Apri Visual Studio e scegli Nuovo progetto dal menu File. Nella sezione Javascript seleziona Windows Store. Assegna all'app il nome AutoPlayCustomEvent e fai clic su OK.
Apri il file Package.appxmanifest e fai clic sulla scheda Funzionalità. Seleziona la funzionalità Archivi rimovibili. In questo modo l'app avrà accesso ai file e alle cartelle nei dispositivi di archivi rimovibili.
Nel file manifesto seleziona la scheda Dichiarazioni. Seleziona Contenuto AutoPlay nell'elenco a discesa Dichiarazioni disponibili, quindi fai clic su Aggiungi. Seleziona la nuova voce Contenuto AutoPlay aggiunta all'elenco Dichiarazioni supportate.

Nota In alternativa puoi anche scegliere di aggiungere una dichiarazione Dispositivo AutoPlay per il tuo evento AutoPlay personalizzato.
Nella sezione Azioni di avvio della dichiarazione dell'evento Contenuto AutoPlay immetti i valori seguenti per la prima azione di avvio.

Impostazione Valore

Verbo show

Nome visualizzato azione Mostra cartelle

Evento contenuto AutoPlayCustomEventQuickstart

Il valore Evento contenuto è il testo specificato per la chiave CustomEvent nel file autorun.inf. L'impostazione Nome visualizzato azione identifica la stringa visualizzata da AutoPlay per la tua app. L'impostazione Verbo identifica un valore che viene passato all'app per l'opzione selezionata. Puoi specificare più azioni di avvio per un evento AutoPlay e usare l'impostazione Verbo per determinare quale opzione ha selezionato un utente per la tua app. Puoi verificare l'azione che l'utente ha selezionato controllando la proprietà verb degli argomenti dell'evento di avvio passati alla tua app. Puoi usare qualsiasi valore per l'impostazione Verbo eccetto open, che è riservata.
Seleziona Associazione tipi file nell'elenco a discesa Dichiarazioni disponibili e fai clic su Aggiungi. Nelle Proprietà della nuova dichiarazione Associazioni tipi file imposta il campo Nome visualizzato su Show .ms Files e il campo Nome su ms_association. Nella sezione Tipi di file supportati fai clic su Aggiungi nuovo. Imposta il campo Tipo di file su .ms. Per quanto riguarda gli eventi contenuto, AutoPlay filtra ed esclude tutti i tipi di file non esplicitamente associati alla tua app.
Salva e chiudi il file manifesto.

Impostazione	Valore
Verbo	show
Nome visualizzato azione	Mostra cartelle
Evento contenuto	AutoPlayCustomEventQuickstart

3. Aggiungi l'interfaccia utente HTML

Apri il file Default.html e aggiungi il codice HTML seguente alla sezione <body>.

<h2>Files</h2>
<div id="files" style="width:400px;height:600px;font-size:large;" />

4. Aggiungere il codice di attivazione

Il codice in questo passaggio chiama una funzione per visualizzare le cartelle nell'unità radice del dispositivo del volume. Per quanto riguarda gli eventi di contenuto AutoPlay, AutoPlay passa la cartella radice del dispositivo di archiviazione negli argomenti di avvio passati all'app. Puoi recuperare questa cartella dal primo elemento della proprietà detail.files. Puoi stabilire che l'app è stata avviata come gestore di un evento di contenuto AutoPlay se la proprietà detail.kind degli argomenti dell'evento di attivazione restituisce il valore Windows.ApplicationModel.Activation.ActivationKind.file.

Apri la cartella js. Apri il file Default.js e sostituisci la funzione predefinita onactivated con il codice seguente.

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. Aggiungere il codice per la visualizzazione dei nomi delle cartelle

Nel file Default.js aggiungi il codice seguente dopo la funzione 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. Compilare ed eseguire l'app

Premi F5 per compilare e distribuire l'app in modalità debug.
Per eseguire l'app, inserisci nel PC una scheda di memoria o un altro dispositivo di archiviazione. Seleziona quindi la tua app nell'elenco delle opzioni per i gestori AutoPlay.

Riepilogo e passaggi successivi

In questa esercitazione hai identificato un dispositivo del volume come dispositivo AutoPlay definendo un nome di evento AutoPlay personalizzato in un file autorun.inf. Hai quindi creato un'app che si registra come gestore per tale evento personalizzato.

Argomenti correlati

Avvio automatico con AutoPlay

Condividi tramite