DeviceCapability (schéma de package pour Windows 8)

Article
07/20/2023

Déclare une fonctionnalité de périphérique requise par un package.

Hiérarchie d’éléments

<Fonctionnalités>: <DeviceCapability>

Syntaxe

<DeviceCapability Name = A string between 1 and 50 characters in length or a GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. />

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
Nom	Nom de la fonctionnalité de l’appareil, spécifié sous la forme d’un nom convivial ou d’un GUID de classe d’interface d’appareil.	Chaîne d’une longueur de 1 à 50 caractères ou d’un GUID au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Oui

Éléments enfants

Aucun.

Éléments parents

Élément parent	Description
Capabilities	Déclare l’accès aux ressources utilisateur protégées requises par le package.

Notes

Si l’attribut Name est spécifié en tant que GUID, il est validé en tant que GUID.

Par défaut, les applications UWP ont accès aux périphériques d’impression, de scanneur et de capteur. Pour accéder à d’autres types d’appareils, vous devez les spécifier à l’aide d’un élément DeviceCapability . Certaines fonctionnalités de l’appareil doivent être ajoutées manuellement au manifeste du package. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique dans un manifeste de package.

Pour plus d’informations sur les déclarations de fonctionnalité, consultez déclarations de fonctionnalités d’application.

Certaines fonctionnalités de l’appareil requièrent des éléments enfants. Ce tableau répertorie les fonctionnalités de l’appareil par nom ou GUID et spécifie si des éléments enfants sont requis.

Fonctionnalité d’appareil	Description
Bluetooth. genericAttributeProfile	Fournit l’accès aux API dans le Windows. Appareil. Bluetooth. Espace de noms GenericAttributeProfile. Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.
Bluetooth. RFCOMM	Fournit l’accès aux API dans le Windows. Appareil. Bluetooth. Espace de noms RFCOMM. Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.
humaninterfacedevice	Fournit l’accès aux API dans le Windows. Espace de noms Devices. HumanInterfaceDevice . Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour un périphérique d’interface utilisateur (HID).
location	Permet d’accéder à l’emplacement actuel de l’utilisateur.
cravate	Permet d’accéder au flux audio du microphone.
pointOfService	Fournit l’accès aux scanneurs de codes-barres du point de service (POS) et aux lecteurs de bandes magnétiques, via le Windows. Espace de noms Devices. PointOfService . Ces API ne sont pas prises en charge sur les Windows Phone.
proximity	Indispensable à la communication en champ proche entre des appareils situés à proximité. La proximité du champ proche peut être utilisée pour envoyer des fichiers ou se connecter à une application sur un appareil proche.
serialcommunication	Fournit l’accès aux API dans le Windows. Espace de noms Devices. SerialCommunication . Pour plus d’informations sur la définition de cette fonctionnalité dans le manifeste, consultez la Windows. Page d’espace de noms Devices. SerialCommunication .
ports	Fournit l’accès aux API dans le Windows. Espace de noms Devices. USB . Cette fonctionnalité nécessite des éléments enfants. Pour plus d’informations, consultez mise à jour du package du manifeste d’application pour un périphérique USB.
Webcam	Permet d’accéder au flux vidéo de l’appareil photo.
Autres périphériques (représentés par des GUID)	Inclut les périphériques spécialisés et les appareils mobiles Windows.

Exemples

Voici un exemple de nœudCapabilities . Pour obtenir plus d’exemples, consultez comment spécifier des fonctionnalités d’appareil dans un manifeste de package.

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

Voir aussi

Déclarations des fonctionnalités d’application

Spécifier des fonctionnalités d'appareil dans le manifeste d'un package

Spécifications

	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/2010/manifest`