DeviceCapability (schéma des extensions pour Windows 8.1)

Article
07/20/2023

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

Hiérarchie d’éléments

<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

Cet élément (document) le plus à l’extérieur ne peut pas être contenu dans d’autres éléments.

Notes

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

Par défaut, les applications sont autorisées à accéder à certains appareils. Pour les applications UWP, cela comprend l’accès aux appareils imprimés et scanneurs. 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
location	Permet d’accéder à l’emplacement actuel de l’utilisateur.
cravate	Permet d’accéder au flux audio du microphone.
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.
Webcam	Permet d’accéder au flux vidéo de l’appareil photo.
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.
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).
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.
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.
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œud Capabilities . 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`

Partager via