AutoPlay voor UWP-apparaat-apps

2025-07-02

Belangrijk

Metagegevens van apparaten zijn afgeschaft en worden verwijderd in een toekomstige versie van Windows. Zie Containermetagegevens voor stuurprogrammapakketten voor informatie over de vervanging voor deze functionaliteit.

Apparaatfabrikanten kunnen hun UWP-apparaat-app opgeven als een AutoPlay-handler voor hun apparaat. Ze kunnen ook andere UWP-apps laten fungeren als AutoPlay-handlers voor hun apparaat. In dit artikel wordt beschreven hoe u de wizard Bewerking van apparaatmetagegevens gebruikt om Automatisch afspelen in te schakelen. Ook wordt beschreven hoe u activeringen van Automatisch afspelen in uw app kunt afhandelen. Zie Meet UWP-apparaat-apps voor meer informatie over apparaat-apps.

U hoeft geen apparaatmetagegevens te gebruiken voor alle typen AutoPlay. Zonder apparaatmetagegevens kunt u met AutoPlay uw app als optie opgeven wanneer een gebruiker een apparaat verbindt met een pc. Deze apparaten zijn niet-volume dragende apparaten, zoals een camera of mediaspeler, of volumedragende apparaten, zoals een USB-stick, SD-kaart of DVD. Met AutoPlay kunt u uw app ook registreren als optie wanneer gebruikers bestanden delen tussen twee computers met behulp van Proximity (tikken). Maar uw app kan niet automatisch worden geïnstalleerd zonder apparaatmetagegevens. Zie Automatisch starten met Automatisch afspelen voor meer informatie over het gebruik van Automatisch afspelen wanneer metagegevens van apparaten niet vereist zijn.

Overzicht van AutoPlay

Afhankelijk van de versie van uw app kunt u Automatisch afspelen op de volgende manieren inschakelen:

Alleen uw UWP-apparaat-app kan de AutoPlay-activatie voor uw apparaat afhandelen (ondersteund in Windows 8, Windows 8.1).
Andere UWP-apps kunnen de AutoPlay-activering voor uw apparaat afhandelen (alleen ondersteund in Windows 8.1).
Uw UWP-apparaat-app en andere UWP-apps kunnen de AutoPlay-activering voor uw apparaat behandelen (alleen ondersteund op Windows 8.1).

In dit voorbeeld ziet u een dialoogvenster voor automatisch afspelen voor een app met de naam Contoso Dashboard die is geregistreerd als de AutoPlay-handler voor het apparaat Contoso Pedometer.

voorbeeld van een dialoogvenster voor automatisch afspelen voor een apparaat.

AutoPlay ondersteunt deze apparaattypen bij het gebruik van apparaatmetagegevens met uw app:

Apparaatklasse	Automatisch afspelen ondersteund in Windows 8	Automatisch afspelen ondersteund in Windows 8.1
Digitale still camera
Digitale videocamera
Draagbare mediaspeler
Mobieltje
Mobiele breedband
Webcam
Menselijke Interface Apparatuur (HID)
Printers, scanners, fax
PC
Chipkaart
Algemene poort
Bluetooth-apparaat

Voordat u begint

Zorg ervoor dat u de Wizard voor het maken van apparaatspecifieke metadata hebt. U hebt deze nodig om Automatisch afspelen in te schakelen. In deze release is deze wizard opgenomen in Microsoft Visual Studio Professional en Microsoft Visual Studio Ultimate. Maar als u Microsoft Visual Studio Express voor Windows hebt, moet u de zelfstandige SDK voor Windows 8.1 downloaden om de wizard op te halen.
Koppel uw app aan de Microsoft Store. U hebt de pakketgegevens van uw app nodig om Automatisch afspelen in te schakelen. Zie de sectie Uw app koppelen aan de Microsoft Store in stap 1 voor meer informatie: Een UWP-apparaat-app maken.
Maak de metagegevens van het apparaat. Zie stap 2: Apparaatmetagegevens maken in de stapsgewijze handleiding een UWP-apparaat-app maken voor meer informatie.

Automatisch afspelen inschakelen

Met de Apparaatmetagegevenswizard kunt u uw UWP-app declareren als de standaardhandler voor AutoPlay op uw apparaat. U kunt ook andere UWP-apps laten fungeren als AutoPlay-handlers voor uw apparaat. U kunt een van deze opties of beide van deze opties kiezen.

Automatisch afspelen inschakelen met de Device Metadata Authoring Wizard**

Start de Apparaatmetagegevens-auteurwizard vanuit %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86 door op DeviceMetadataWizard.exe te dubbelklikken.
Als u het bestaande metagegevenspakket van het apparaat wilt bewerken, selecteert u Apparaatmetagegevens bewerken.
Zoek in de dialoogvenster Open het met de UWP-apparaat-app geassocieerde metagegevenspakket. (Het heeft een devicemetadata-ms bestandsextensie.)
(Optioneel.) Als u de pakketnaam, de naam van de uitgever en de app-id van uw apparaat-app niet bij de hand hebt, selecteert u App-informatie om de pakketgegevens voor uw UWP-apparaat-app weer te geven.
Selecteer Windows-gegevens om details van Automatisch afspelen op te geven.
Als u een app wilt opgeven als standaardhandler voor Automatisch afspelen voor uw apparaat, selecteert u Een UWP-apparaat-app gebruiken. U kunt een UWP-app of een UWP-apparaat-app selecteren. Deze app moet echter de activering van Automatisch afspelen voor uw apparaat afhandelen. De app moet ook de bijbehorende ervarings-id opgeven in het manifest van het app-pakket (zoals opgegeven in de volgende procedure).
- Pakketnaam: In het manifest van het app-pakket is Pakketnaam het kenmerk Naam van het element Identiteit.
- Naam van uitgever: In het manifest van het app-pakket is publisher-naam het kenmerk Publisher van het element Identiteit.
- App-id: In het manifest van het app-pakket is app-id het id-kenmerk van het toepassingselement.
- Werkwoord: Werkwoord is de id voor de activering van Automatisch afspelen. Uw app gebruikt deze om te bepalen of de activering afkomstig is van uw apparaat. U kunt elke waarde voor de instelling Werkwoord gebruiken, met uitzondering van openen, die is gereserveerd.
- Gebeurtenistype Automatisch afspelen: laat dit veld ingesteld op Apparaat. In de metagegevens van het apparaat geeft de wizard automatisch de ervarings-id op die is gekoppeld aan uw UWP-apparaat-app.
Als u andere apps wilt laten fungeren als AutoPlay-handlers voor uw apparaat, selecteert u Automatisch afspelen inschakelen voor geregistreerde apps.
Wanneer u klaar bent, selecteert u Volgende.
Wanneer u de pagina Voltooien ziet, schrijft u de ervarings-id op. U hebt deze nodig in de volgende procedure wanneer u de activering van Automatisch afspelen in uw app afhandelt.
Verifieer uw Opslaginformatie en selecteer Opslaan om het metagegevenspakket van uw apparaat bij te werken.

Activering van Automatisch afspelen verwerken

Als u een activering van Automatisch afspelen in uw app wilt afhandelen, registreert u zich voor een windows.autoPlayDevice extensie in het manifest van het app-pakket. Vervolgens moet u deze gebeurtenis afhandelen in het OnActivated geval van het toepassingsobject. Uw app kan zich registreren als een AutoPlay-handler voor meerdere apparaten.

Uw app registreren als een AutoPlay-handler

Registreer uw app als een AutoPlay-handler voor uw apparaat door de ervarings-ID die verbonden is met uw UWP-apparaat-app op te geven, het AutoPlay Werkwoord, en ActionDisplayName die wordt gebruikt om uw app te activeren.

Open het project van uw app in Microsoft Visual Studio.
Klik in Solution Explorer met de rechtermuisknop op het bestand Package.appxmanifest en selecteer Code weergeven. Met deze optie wordt het app-pakketmanifest weergegeven in de XML-editor (Tekst).

Plak in het Application element, onder het VisualElements element, het volgende Extensions element in het manifestbestand van het pakket.

      <Extensions>
        <Extension Category="windows.autoPlayDevice">
          <AutoPlayDevice>
            <LaunchAction
                Verb="showDevice1"
                ActionDisplayName="Launch App for Device 1"
                DeviceEvent="ExperienceID:{00000000-ABCD-EF00-0000-000000000000}"/>
          </AutoPlayDevice>
        </Extension>
      </Extensions>

Vervang de autoplay-waarden uit dit voorbeeld door de werkelijke waarden voor uw app:
- Verb: De id voor de activering van Automatisch afspelen. Uw app gebruikt deze om te bepalen of de activering afkomstig is van uw apparaat. Als uw app is opgegeven als de standaardhandler voor Automatisch Afspelen voor uw apparaat, moet deze waarde overeenkomen met het werkwoord dat u hebt opgegeven in de metagegevens van het apparaat. Als uw app niet is opgegeven als de standaardhandler voor Automatisch afspelen voor uw apparaat, kunt u elke waarde voor de instelling Werkwoord gebruiken, met uitzondering van openen, die is gereserveerd.
- ActionDisplayName: AutoPlay geeft de tekenreeks weer voor uw app.
- Experience ID: de ervarings-ID GUID die uw app associeert met uw apparaat. Deze GUID is de waarde die u in de vorige procedure hebt opgeschreven.

De activatie van Automatisch afspelen beheren

Wanneer uw apparaat een AutoPlay-activering uitvoert, is het activeringstype Windows.ApplicationModel.Activation.ActivationKind.device. Als u wilt controleren hoe uw app is geactiveerd, gebruikt u het eventObj object dat is doorgegeven OnActivated. Als het van AutoPlay kwam, kunt u eventObj gebruiken om te bepalen welke apparaat-id en AutoPlay-handeling de activering in gang zette.

In dit voorbeeld bevat de parameter voor de activerings gebeurtenis (eventObj) de id van het apparaat en de werkwoord voor activering.

<!DOCTYPE html>
<html>
<head>
  <script type="text/javascript">
    function OnActivated(eventObj) {
        if (eventObj.kind == Windows.ApplicationModel.Activation.ActivationKind.launch) {
            // Activated by the user.
        }
        else if (eventObj.kind == Windows.ApplicationModel.Activation.ActivationKind.device) {
            // Activated by a device, for AutoPlay.
            // Device path = eventObj.deviceInformationId;
            // verb ("showDevice1") = eventObj.verb;
        }
    }

    Windows.UI.WebUI.WebUIApplication.addEventListener("activated", OnActivated, false);
  </script>
</head>

<body>
...
...
...
</body>
</html>

Delen via