Angeben von Gerätefunktionen in einem Paketmanifest

  • Artikel

Hinweis

Informationen zu Windows 10 finden Sie unter Unterschiede in Windows 10.

 

Um jede Gerätefunktion zu deklarieren, die für Ihre Windows-Runtime-App erforderlich ist, fügen Sie dem Paketmanifest ein DeviceCapability-Element und entsprechende untergeordnete Elemente hinzu.

Wichtig

Einige Gerätefunktionen müssen manuell angegeben werden. Beispielsweise müssen Sie den XML-Editor (Text) verwenden, um Gerätefunktionen für die USB-, Eingabegeräte-, Pos-, Bluetooth- und Bluetooth RFCOMM-APIs anzugeben.

 

Schritt 1:

Öffnen Sie die Datei Package.appxmanifest. Öffnen Sie in Microsoft Visual Studio die Datei mit dem XML-Editor (Text). Klicken Sie hierzu in Projektmappen-Explorer mit der rechten Maustaste auf die Datei, und klicken Sie auf Öffnen mit. Wählen Sie dann XML-Editor (Text) aus , und klicken Sie auf OK.

Schritt 2:

Fügen Sie ein DeviceCapability-Element pro Gerätefunktion hinzu. Sie können über mehrere DeviceCapability - und Capability-Elemente im Capabilities-Element verfügen, aber alle DeviceCapability-Elemente müssen hinter den Capability-Elementen stehen. Beachten Sie, dass einige Gerätefunktionen mehrere untergeordnete Elemente erfordern. Weitere Informationen finden Sie unter DeviceCapability.

Hinweis

Nicht alle APIs sind sowohl für UWP-Apps als auch für Windows 8.x-Telefon-Apps verfügbar. Weitere Informationen dazu, welche Geräte von den einzelnen APIs unterstützt werden, finden Sie in der API-Referenzdokumentation.

 

Webcam-Beispiel

Hier ist ein Beispiel für die Funktion des Webcamgeräts . Für diese Gerätefunktion sind keine untergeordneten Elemente erforderlich. Ein Beispiel für die Verwendung einer Webcam finden Sie unter Aufzeichnen von Audio oder Video.

<Capabilities>
  <Capability Name="internetClient"/>
  <Capability Name="musicLibrary"/>
  <Capability Name="videosLibrary"/>
  <DeviceCapability Name="microphone"/>
  <DeviceCapability Name="webcam"/>
</Capabilities>

USB-Beispiel

Die USB-Gerätefunktion ermöglicht den Zugriff auf APIs im Windows. Devices.Usb-Namespace. Weitere Informationen finden Sie unter Aktualisieren des App-Manifestpakets für ein USB-Gerät.

<DeviceCapability Name="usb">
    <Device Id="vidpid:xxxx xxxx">
      <Function Type="classId:xx xx xx"/>
      <Function Type="name:xxxxx"/>
      <Function Type="winUsbId:xxxxx"/>
    </Device>
</DeviceCapability>

Beispiel für Eingabegeräte (HID)

Die Gerätefunktion humaninterfacedevice ermöglicht den Zugriff auf APIs im Windows. Devices.HumanInterfaceDevice-Namespace. In diesem Beispiel ermöglicht die Funktion den Zugriff auf jedes Gerät einer bestimmten Funktion. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für HID.

<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:xxxx xxxx"/>
    </Device>
</DeviceCapability>

Point of Service-Beispiel (POS)

Die pointOfService-Gerätefunktion ermöglicht den Zugriff auf APIs im Windows.Devices.PointOfService-Namespace. Für diese Gerätefunktion sind keine untergeordneten Elemente erforderlich.

<Capabilities>
  <DeviceCapability Name="pointOfService"/>
</Capabilities>

Bluetooth GATT-Beispiel

Die Gerätefunktion bluetooth.genericAttributeProfile ermöglicht den Zugriff auf APIs im Windows. Geräte. Bluetooth. GenericAttributeProfile-Namespace. In diesem Beispiel ermöglicht die Funktion den Zugriff auf jedes Gerät einer bestimmten Funktion. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.

  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.genericAttributeProfile">
      <m2:Device Id="any">
        <m2:Function Type="name:xxxxxx"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>

Bluetooth RFCOMM-Beispiel

Die Bluetooth.rfcomm-Gerätefunktion ermöglicht den Zugriff auf APIs im Windows. Geräte. Bluetooth. Rfcomm-Namespace. In diesem Beispiel ermöglicht die Funktion den Zugriff auf jedes Gerät einer bestimmten Funktion. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.

  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.rfcomm">
      <m2:Device Id="any">
        <m2:Function Type="serviceId:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>

Geräte, Sensoren und Leistung

DeviceCapability-Elementreferenz

Deklarationen von App-Funktionen