Schnellstart: Konfigurieren von Wechselspeicher als Gerät mit automatischer Wiedergabe (HTML)

Artikel
12/12/2015

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

Sie können ein Volumegerät wie eine Speicherkarte oder ein USB-Laufwerk als Gerät zur automatischen Wiedergabe identifizieren, wenn das Volumegerät an einen PC angeschlossen wird. Das ist vor allem dann sehr nützlich, wenn Sie möchten, dass dem Benutzer bei der automatischen Wiedergabe eine bestimmte App für Ihr Volumegerät angeboten wird.

Im Folgenden zeigen wir, wie Sie Ihr Volumegerät als Gerät zur automatischen Wiedergabe identifizieren.

Identifizieren Sie Ihr Volumegerät als Gerät zur automatischen Wiedergabe, indem Sie dem Stammverzeichnis des Geräts eine Datei autorun.inf hinzufügen. Fügen Sie in der Datei autorun.inf den CustomEvent-Schlüssel im Abschnitt AutoRun hinzu. Wenn Ihr Volumegerät an einen PC angeschlossen wird, findet die automatische Wiedergabe die Datei autorun.inf und behandelt Ihr Volume als ein Gerät. Die automatische Wiedergabe erstellt anhand des Namens, den Sie für den CustomEvent-Schlüssel angegeben haben, ein Ereignis zur automatischen Wiedergabe. Sie können eine App erstellen und sie dann als Handler für dieses Ereignis zur automatischen Wiedergabe registrieren. Wenn das Gerät an den PC angeschlossen wird, bietet die automatische Wiedergabe Ihre App als Handler für Ihr Volumegerät an. Weitere Informationen zu autorun.inf-Dateien finden Sie unter Autorun.inf-Einträge.

Gerätehersteller:: Die automatische Wiedergabe lädt die App, die Sie als Handler für Ihr Gerät erstellen, nicht automatisch herunter. Benutzer können Ihre App aber wie gewohnt im Windows Store herunterladen. Für eine bessere Benutzererfahrung sollten Sie Gerätemetadaten verwenden, um Ihre App mit dem Gerät zu verknüpfen. Wenn Sie Ihre App der Experience-ID des Geräts als automatisch installierte App zuordnen, findet das Betriebssystem diese Zuordnung, wenn Ihr Gerät an einen PC angeschlossen wird. Ist Ihre App nicht auf dem PC installiert, wird sie vom Betriebssystem automatisch heruntergeladen und installiert. Die automatische Wiedergabe bietet Ihre App als erste Option an, wenn der Benutzer den Handler für das Gerät auswählt. Weitere Informationen finden Sie im Thema zu AutoPlay für Windows Store-Geräte-Apps.

Ziel: Erstellen Sie eine App zum Behandeln eines benutzerdefiniertes Ereignisses zur automatischen Wiedergabe für ein Volumegerät.

Voraussetzungen

Sie müssen über ein Volumegerät wie einen USB-Speicher oder eine Speicherkarte verfügen, um die Anleitungen in diesem Schnellstartartikel abschließen zu können.

Microsoft Visual Studio

Anweisungen

1. Erstellen einer "autorun.inf"-Datei

Fügen Sie im Stammverzeichnis Ihres Volumegeräts eine Datei namens autorun.inf hinzu. Öffnen Sie die Datei autorun.inf, und fügen Sie den folgenden Text hinzu.
```
[AutoRun]
CustomEvent=AutoPlayCustomEventQuickstart
```

2. Erstellen eines neuen Projekts und Hinzufügen von Deklarationen für die automatische Wiedergabe

Öffnen Sie Visual Studio, und wählen Sie im Menü Datei die Option Neues Projekt aus. Wählen Sie im Abschnitt JavaScript die Option Windows Store aus. Versehen Sie die App mit dem Namen AutoPlayCustomEvent, und klicken Sie anschließend auf OK.
Öffnen Sie die Datei Package.appxmanifest, und klicken Sie auf die Registerkarte Funktionen. Wählen Sie die Funktion Wechselmedien. Damit erhält Ihre App Zugriff auf die Dateien und Ordner auf dem Wechselmediengerät.
Klicken Sie in der Manifestdatei auf die Registerkarte Deklarationen. Wählen Sie in der Dropdownliste Verfügbare Deklarationen die Option Inhalt automatisch wiedergeben aus, und klicken Sie anschließend auf Hinzufügen. Wählen Sie das neue Element vom Typ Inhalt automatisch wiedergeben aus, das der Liste Unterstützte Deklarationen hinzugefügt wurde.

Hinweis Alternativ können Sie auch eine Gerät automatisch wiedergeben-Deklaration für Ihr benutzerdefiniertes Ereignis zur automatischen Wiedergabe hinzufügen.
Geben Sie im Abschnitt Startaktionen Ihrer Inhalt automatisch Wiedergeben-Ereignisdeklaration die folgenden Werte für die Aktion beim ersten Start ein.

Einstellung Wert

Verb show

Anzeigename der Aktion Show Folders

Inhaltsereignis AutoPlayCustomEventQuickstart

Der Inhaltsereignis-Wert ist der Text, den Sie für den CustomEvent-Schlüssel in Ihrer Datei autorun.inf angegeben haben. Die Einstellung Anzeigename der Aktion dient zum Angeben der Zeichenfolge, die die automatische Wiedergabe für Ihre App anzeigt. Die Einstellung Verb dient zum Angeben eines Werts, der für die ausgewählte Option an Ihre App übergeben wird. Sie können mehrere Startaktionen für Ereignisse der automatischen Wiedergabe angeben und mit der Einstellung Verb ermitteln, welche Option ein Benutzer für Ihre App ausgewählt hat. Für welche Option sich der Benutzer entschieden hat, erfahren Sie durch Überprüfen der verb-Eigenschaft der an die App übergebenen Startereignisargumente. Für die Einstellung Verb können Sie einen beliebigen Wert verwenden. Einzige Ausnahme ist open: Dieser Wert ist reserviert.
Wählen Sie in der Dropdownliste Verfügbare Deklarationen die Option Dateitypzuordnungen aus, und klicken Sie anschließend auf Hinzufügen. Legen Sie in den Eigenschaften der neuen Deklaration vom Typ Dateitypzuordnungen das Feld Anzeigename auf Show .ms Files und das Feld Name auf ms_association fest. Klicken Sie im Abschnitt Unterstützte Dateitypen auf Neu hinzufügen. Legen Sie im Feld Dateityp die Option .ms fest. Für Inhaltsereignisse filtert die automatische Wiedergabe Dateitypen heraus, die nicht explizit Ihrer App zugeordnet sind.
Speichern und schließen Sie die Manifestdatei.

Einstellung	Wert
Verb	show
Anzeigename der Aktion	Show Folders
Inhaltsereignis	AutoPlayCustomEventQuickstart

3. Hinzufügen einer HTML-Benutzeroberfläche

Öffnen Sie die Datei Default.html, und fügen Sie im Abschnitt <body> den folgenden HTML-Code hinzu.
```
<h2>Files</h2>
<div id="files" style="width:400px;height:600px;font-size:large;" />
```

4. Hinzufügen von Aktivierungscode

Der Code bei diesem Schritt ruft eine Funktion zur Anzeige der Ordner im Stammlaufwerk Ihres Volumegeräts auf. Für Inhaltsereignisse zur automatischen Wiedergabe übergibt die automatische Wiedergabe den Stammordner des Speichergeräts in den Startargumenten, die ihrerseits an die App übergeben wurden. Sie können diesen Ordner aus dem ersten Element der detail.files-Eigenschaft abrufen. Sie wissen, dass die App als Handler für ein Inhaltsereignis zur automatischen Wiedergabe gestartet wurde, wenn die detail.kind-Eigenschaft des Aktivierungsereignisarguments einen Wert von Windows.ApplicationModel.Activation.ActivationKind.file zurückgibt.

Öffnen Sie den Ordner js. Öffnen Sie die Datei Default.js, und ersetzen Sie die standardmäßige onactivated-Funktion durch den folgenden Code.

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. Hinzufügen von Code zur Anzeige von Ordnernamen

Fügen Sie in der Datei Default.js den folgenden Code nach der onactivated-Funktion hinzu.

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. Erstellen und Ausführen der App

Drücken Sie F5, um die App zu erstellen und bereitzustellen (im Debugmodus).
Legen Sie eine Speicherkarte oder ein anderes Speichergerät in Ihren PC ein, um Ihre App auszuführen. Wählen Sie die App anschließend in der Liste mit den Handleroptionen für die automatische Wiedergabe aus.

Zusammenfassung und nächste Schritte

In diesem Lernprogramm haben Sie ein Volumegerät als Gerät zur automatischen Wiedergabe identifiziert, indem Sie ein benutzerdefiniertes Ereignis zur automatischen Wiedergabe in einer autorun.inf-Datei definiert haben. Anschließend haben Sie eine App erstellt, die als Handler für dieses benutzerdefinierte Ereignis registriert wird.