Partager via

Comment spécifier des fonctionnalités de périphérique dans un manifeste de package

  • Article

Notes

pour Windows 10, consultez la rubrique relative aux différences de Windows 10.

 

pour déclarer chaque fonctionnalité de périphérique requise par votre application Windows Runtime, ajoutez un élément DeviceCapability et les éléments enfants applicables au manifeste du package.

Important

Certaines fonctionnalités de l’appareil doivent être spécifiées manuellement. par exemple, vous devez utiliser l' éditeur XML (texte) pour spécifier les fonctionnalités de l’appareil pour les api USB, HID (Human Interface device), Point of Service (POS), Bluetooth GATT et Bluetooth RFCOMM.

 

Étape 1 :

Ouvrez le fichier Package.appxmanifest. dans Microsoft Visual Studio, ouvrez le fichier avec l' éditeur XML (texte). pour ce faire, dans Explorateur de solutions, cliquez avec le bouton droit sur le fichier, puis cliquez sur ouvrir avec. Sélectionnez ensuite éditeur XML (texte) , puis cliquez sur OK.

Étape 2 :

Ajoutez un élément DeviceCapability par capacité de l’appareil. Vous pouvez avoir plusieurs éléments DeviceCapability et Capability dans l’élément Capabilities , mais tous les éléments DeviceCapability doivent être placés après les éléments de fonctionnalité . Notez que certaines fonctionnalités de l’appareil requièrent plusieurs éléments enfants. Pour plus d’informations, consultez DeviceCapability.

Notes

toutes les api ne sont pas disponibles pour les applications UWP et Windows 8. x Téléphone. Pour plus d’informations sur les appareils pris en charge par chaque API, consultez la documentation de référence sur les API.

 

Exemple d’image webcam

Voici un exemple de la fonctionnalité de l’appareil webcam . Cette fonctionnalité de périphérique ne requiert pas d’éléments enfants. Pour obtenir un exemple d’utilisation d’une webcam, consultez Comment enregistrer un fichier audio ou vidéo.

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

Exemple USB

La fonctionnalité de périphérique USB permet d’accéder aux api du Windows. Espace de noms Devices. USB . Pour plus d’informations, consultez mise à jour du package du manifeste d’application pour un périphérique USB.

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

Exemple de périphérique d’interface utilisateur (HID)

La fonctionnalité de l’appareil humaninterfacedevice permet d’accéder aux api du Windows. Espace de noms Devices. HumanInterfaceDevice . Dans cet exemple, la fonctionnalité permet d’accéder à n’importe quel appareil d’une fonction spécifique. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour un périphérique d’interface utilisateur (HID).

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

Exemple de point de service (POS)

La fonctionnalité d’appareil pointOfService permet d’accéder aux API de l’espace de noms Windows.Devices.PointOfService. Cette fonctionnalité de périphérique ne requiert pas d’éléments enfants.

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

Bluetooth exemple GATT

La fonctionnalité de l’appareil Bluetooth. genericAttributeProfile permet d’accéder aux api du Windows. Appareil. Bluetooth. Espace de noms GenericAttributeProfile. Dans cet exemple, la fonctionnalité permet d’accéder à n’importe quel appareil d’une fonction spécifique. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.

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

exemple de RFCOMM Bluetooth

La fonctionnalité de l’appareil Bluetooth. RFCOMM permet d’accéder aux api du Windows. Appareil. Bluetooth. Espace de noms RFCOMM. Dans cet exemple, la fonctionnalité permet d’accéder à n’importe quel appareil d’une fonction spécifique. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour 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>

Appareils, capteurs et alimentation

Référence des éléments DeviceCapability

Déclarations des fonctionnalités d’application