Angeben von Gerätefunktionen in einem PaketmanifestHow to specify device capabilities in a package manifest

Hinweis

Informationen zu Windows 10 finden Sie unter Unterschiede in Windows 10.For Windows 10, see What's different in Windows 10.

Um jede für Ihre Windows-Runtime-App erforderliche Geräte Funktion zu deklarieren, fügen Sie dem Paket Manifest ein devicecapability -Element und entsprechende untergeordnete Elemente hinzu.To declare each device capability required by your Windows Runtime app, add a DeviceCapability element and applicable child elements to the package manifest.

Wichtig

Einige Gerätefunktionen müssen manuell angegeben werden.Some device capabilities must be specified manually. Beispielsweise müssen Sie den XML- Editor (Text) verwenden, um Gerätefunktionen für die APIs USB, Eingabegeräte (HID), Point of Service (POS), Bluetooth GATT und Bluetooth RFCOMM anzugeben.For example, you must use the XML (Text) Editor to specify device capabilities for the USB, Human Interface Device (HID), Point of Service (POS), Bluetooth GATT, and Bluetooth RFCOMM APIs.

Schritt 1:Step 1:

Öffnen Sie die Datei Package.appxmanifest.Open the Package.appxmanifest file. Öffnen Sie in Microsoft Visual Studio die Datei mit dem XML-Editor (Text).In Microsoft Visual Studio, open the file with the XML (Text) Editor. Klicken Sie hierzu in Projektmappen-Explorer mit der rechten Maustaste auf die Datei, und klicken Sie dann auf Öffnen mit.To do that, in Solution Explorer , right-click the file and click Open with. Wählen Sie dann XML (Text) Editor aus, und klicken Sie auf OK.Then select XML (Text) Editor and click OK.

Schritt 2:Step 2:

Fügen Sie ein devicecapability -Element pro Geräte Funktion hinzu.Add one DeviceCapability element per device capability. Sie können über mehrere devicecapability -und Capability-Elemente im Capability -Element verfügen , aber alle devicecapability -Elemente müssen nach den Funktions Elementen stehen.You can have multiple DeviceCapability and Capability elements in the Capabilities element, but all DeviceCapability elements must come after the Capability elements. Beachten Sie, dass einige Gerätefunktionen mehrere untergeordnete Elemente erfordern.Note that some device capabilities require multiple child elements. Weitere Informationen finden Sie unter devicecapability.For more info, see DeviceCapability.

Hinweis

Nicht alle APIs sind sowohl für UWP-Apps als auch für Windows 8. x Phone-apps verfügbar.Not all APIs are available for both UWP apps and Windows 8.x Phone apps. Weitere Informationen zu den Geräten, die von jeder API unterstützt werden, finden Sie in der API-Referenz Dokumentation.See the API reference documentation for more details about which devices are supported by each API.

Beispiel für WebcamWebcam example

Im folgenden finden Sie ein Beispiel für die Funktion der Webcam -Geräte.Here's an example of the webcam device capability. Diese Geräte Funktion erfordert keine untergeordneten Elemente.This device capability does not require child elements. Ein Beispiel für die Verwendung einer Webcam finden Sie unter Aufzeichnen von Audiodaten oder Videos.For an example of how to use a webcam, see How to record audio or video.

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

USB-BeispielUSB example

Die USB- Geräte Funktion ermöglicht den Zugriff auf APIs im Windows. Devices. USB- Namespace.The usb device capability enables access to APIs in the Windows.Devices.Usb namespace. Weitere Informationen finden Sie unter Aktualisieren des App-Manifest-Pakets für ein USB-Gerät.For more info, see Updating the app manifest package for a USB device.

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

Eingabegeräte (HID)-BeispielHuman Interface Device (HID) example

Die Geräte Funktion humaninterfacedevice ermöglicht den Zugriff auf APIs im Windows. Devices. humaninterfacedevice -Namespace.The humaninterfacedevice device capability enables access to APIs in the Windows.Devices.HumanInterfaceDevice namespace. In diesem Beispiel ermöglicht die Funktion den Zugriff auf beliebige Geräte einer bestimmten Funktion.In this example, the capability enables access to any device of a specific function. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für HID.For more info, see How to specify device capabilities for HID.

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

Beispiel für Point of Service (POS)Point of Service (POS) example

Die pointOfService -Gerätefunktion ermöglicht den Zugriff auf APIs im Windows.Devices.PointOfService-Namespace.The pointOfService device capability enables access to APIs in the Windows.Devices.PointOfService namespace. Diese Geräte Funktion erfordert keine untergeordneten Elemente.This device capability does not require child elements.

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

Beispiel für Bluetooth GATTBluetooth GATT example

Die Bluetooth. generiertributeprofile -Geräte Funktion ermöglicht den Zugriff auf APIs im Windows. Devices. Bluetooth. generiertributeprofile -Namespace.The bluetooth.genericAttributeProfile device capability enables access to APIs in the Windows.Devices.Bluetooth.GenericAttributeProfile namespace. In diesem Beispiel ermöglicht die Funktion den Zugriff auf beliebige Geräte einer bestimmten Funktion.In this example, the capability enables access to any device of a specific function. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.For more info, see How to specify device capabilities for Bluetooth.

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

Beispiel für Bluetooth RFCOMMBluetooth RFCOMM example

Die Bluetooth. RFCOMM -Geräte Funktion ermöglicht den Zugriff auf APIs im Windows. Devices. Bluetooth. RFCOMM -Namespace.The bluetooth.rfcomm device capability enables access to APIs in the Windows.Devices.Bluetooth.Rfcomm namespace. In diesem Beispiel ermöglicht die Funktion den Zugriff auf beliebige Geräte einer bestimmten Funktion.In this example, the capability enables access to any device of a specific function. Weitere Informationen finden Sie unter So wird's gemacht: Angeben von Gerätefunktionen für Bluetooth.For more info, see How to specify device capabilities for 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 LeistungDevices, sensors, and power

Element Verweis für das Element "Debug"DeviceCapability element reference

Deklarationen von App-FunktionenApp capability declarations