Déclarations des fonctionnalités d’application (applications Windows Runtime)

Applies to Windows and Windows Phone

Les applications qui ont besoin d’un accès par programme à des ressources utilisateur telles que des images ou à des périphériques tels qu’une caméra doivent déclarer la fonctionnalité appropriée. Une application demande un accès en déclarant les fonctionnalités dans son manifeste de package. Vous pouvez déclarer la plupart des fonctionnalités à l’aide du concepteur de manifeste dans Microsoft Visual Studio ou vous pouvez les ajouter manuellement au manifeste de package comme cela est décrit dans Comment spécifier des fonctionnalités dans un manifeste de package.

Lorsque vous soumettez votre application au Windows Store, elle fait l’objet d’un contrôle pour s’assurer que les fonctionnalités déclarées correspondent à la description de l’application. La déclaration d’un grand nombre de fonctionnalités ou de certaines fonctionnalités auxquelles les utilisateurs peuvent être sensibles peut accroître le niveau d’inspection pratiqué sur votre application lorsque vous la soumettez au Windows Store. Lorsque des clients acquièrent votre application dans le Windows Store, toutes les fonctionnalités déclarées par l’application leur sont notifiées.

Il existe deux types de compte Windows Store : les comptes d’entreprises et les comptes de particuliers. Les applications qui appliquent les fonctionnalités d’utilisation spécifiques décrites ci-dessous requièrent un compte d’entreprise pour pouvoir être envoyées au Windows Store. Pour plus d’informations sur les comptes d’entreprise, voir Types de comptes, emplacements et frais.

Nous examinons ici des ressources protégées et les fonctionnalités nécessaires pour y accéder.

Fonctionnalités à usage général

Les fonctionnalités à usage général s’appliquent aux scénarios d’application les plus courants.

Musique

La fonctionnalité musicLibrary fournit un accès par programme à la musique de l’utilisateur, permettant à l’application d’énumérer tous les fichiers dans la bibliothèque et d’y accéder sans interaction de l’utilisateur. Cette fonctionnalité est généralement utilisée dans les applications de jukebox qui ont besoin d’accéder à la médiathèque entière.

Le file picker fournit un mécanisme d’interface utilisateur robuste qui permet aux utilisateurs d’ouvrir les fichiers à utiliser avec une application. Déclarez la fonctionnalité musicLibrary seulement quand les scénarios pour votre application nécessitent un accès par programme et que vous ne pouvez pas les réaliser à l’aide du file picker. Pour obtenir un exemple de la manière d’accéder aux fichiers dans une bibliothèque, voir Démarrage rapide : accès aux fichiers par programmation.

Images

La fonctionnalité picturesLibrary fournit un accès par programme aux images de l’utilisateur, permettant à l’application d’énumérer tous les fichiers dans la bibliothèque et d’y accéder sans interaction de l’utilisateur. Cette fonctionnalité est généralement utilisée dans les applications de lecture de photos qui ont besoin d’accéder à la bibliothèque d’images entière.

Le file picker fournit un mécanisme d’interface utilisateur robuste qui permet aux utilisateurs d’ouvrir les fichiers à utiliser avec une application. Déclarez la fonctionnalité picturesLibrary seulement quand les scénarios pour votre application nécessitent un accès par programme et que vous ne pouvez pas les réaliser à l’aide du file picker. Pour obtenir un exemple de la manière d’accéder aux fichiers dans une bibliothèque, voir Démarrage rapide : accès aux fichiers par programmation.

Vidéos

La fonctionnalité videosLibrary fournit un accès par programme aux vidéos de l’utilisateur, permettant à l’application d’énumérer tous les fichiers dans la bibliothèque et d’y accéder sans interaction de l’utilisateur. Cette fonctionnalité est généralement utilisée dans les applications de lecture vidéo qui ont besoin d’accéder à la vidéothèque entière.

Le file picker fournit un mécanisme d’interface utilisateur robuste qui permet aux utilisateurs d’ouvrir les fichiers à utiliser avec une application. Déclarez la fonctionnalité videosLibrary seulement quand les scénarios pour votre application nécessitent un accès par programme et que vous ne pouvez pas les réaliser à l’aide du file picker. Pour obtenir un exemple de la manière d’accéder aux fichiers dans une bibliothèque, voir Démarrage rapide : accès aux fichiers par programmation.

Stockage amovible

La fonctionnalité removableStorage offre un accès par programme aux fichiers d’un dispositif de stockage amovible, tel qu’une clé USB ou un disque dur externe, filtrés selon les associations de types de fichiers déclarées dans le manifeste du package. Par exemple, si une application de type lecteur DOC a déclaré une association de type de fichier .doc, elle peut ouvrir les fichiers .doc sur le dispositif de stockage amovible, mais pas d’autres types de fichiers. Prenez des précautions au moment de déclarer cette fonctionnalité, car les utilisateurs peuvent inclure diverses informations sur leurs périphériques de stockage amovibles et s’attendront à ce que l’application fournisse une raison valable pour l’accès par programme au stockage amovible pour le type de fichier complet.

Les utilisateurs s’attendront à ce que votre application traite toutes les associations de fichiers que vous déclarez. Par conséquent, ne déclarez pas des associations de fichiers que votre application ne peut pas gérer de manière responsable. Le file picker fournit un mécanisme d’interface utilisateur robuste qui permet aux utilisateurs d’ouvrir les fichiers à utiliser avec une application.

Déclarez la fonctionnalité removableStorage seulement quand les scénarios pour votre application nécessitent un accès par programme et que vous ne pouvez pas les réaliser à l’aide du file picker.

Internet et réseaux publics

Il existe deux fonctionnalités qui fournissent différents niveaux d’accès à l’Internet et aux réseaux publics. L’accès accordé par ces fonctionnalités varie selon que l’application s’exécute sur Windows ou Windows Phone.

FonctionnalitéComportement dans WindowsComportement dans Windows Phone
internetClientPeut recevoir des données entrantes à partir d’Internet. Ne peut pas agir en tant que serveur. Pas d’accès au réseau local. Dispose d’un accès complet au réseau local et à Internet, et peut agir en tant que serveur. L’accès entrant aux ports critiques est toujours bloqué.
internetClientClientServerPeut recevoir des données entrantes à partir d’Internet. Peut agir en tant que serveur. Pas d’accès au réseau local. Dispose d’un accès complet au réseau local et à Internet, et peut agir en tant que serveur. L’accès entrant aux ports critiques est toujours bloqué.

 

Sur Windows, la plupart des applications qui ont un composant des services Web utilisent internetClient. Les applications qui autorisent les scénarios pair à pair (P2P) dans lesquels l’application doit écouter les connexions réseau entrantes doivent utiliser internetClientServer. La fonctionnalité internetClientServer inclut l’accès fourni par la fonctionnalité internetClient, de sorte que vous n’avez pas besoin de spécifier internetClient lorsque vous spécifiez internetClientServer.

Il est très important pour satisfaire aux critères de la certification d’inclure un lien vers votre politique de confidentialité dans le volet des paramètres si vous déclarez ces capacités. L’oubli de ce lien est actuellement la cause la plus courante de blocage des certifications !

  • Applies to Windows Phone

Les applications Windows Phone Store proposent une fonctionnalité réseau unique qui autorise tout l’accès réseau pour l’application. La fonctionnalité Internet (client et serveur) autorise l’accès complet au réseau pour les opérations clientes (accès sortant) et les opérations serveur (accès entrant). Toutefois, si l’une des fonctionnalités réseau (internetClient, internetClientServer ou privateNetworkClientServer) est définie dans le fichier Package.appxmanifest, cela permet à une application Windows Phone Store d’avoir un accès complet au réseau pour les opérations clientes et serveur au moment de l’exécution.

Pendant que vous développez et testez votre application Windows Phone Store dans Visual Studio, vous obtenez la capacité de mise en réseau (Internet (client et serveur)) quand vous exécutez l’application, même si vous n’avez pas indiqué cette capacité dans le fichier manifeste de l’application. Toutefois, quand vous publiez votre application, celle-ci n’obtient pas automatiquement la capacité de mise en réseau. Veillez à sélectionner la fonctionnalité Internet (client et serveur) dans la page Capacités du Concepteur de manifeste si votre application nécessite une connectivité réseau.

Réseaux domestiques et professionnels

La fonctionnalité privateNetworkClientServer offre un accès entrant et sortant vers les réseaux domestiques et professionnels via le pare-feu. Cette fonctionnalité est généralement utilisée pour des jeux qui communiquent sur un réseau local (LAN) et pour des applications qui partagent des données sur divers périphériques locaux. Si votre application spécifie musicLibrary, picturesLibrary ou videosLibrary, vous n’avez pas besoin d’utiliser cette fonctionnalité pour accéder à la bibliothèque correspondante dans un groupe résidentiel. Sur Windows, cette fonctionnalité ne permet pas d’accéder à Internet. Sur Windows Phone, cette fonctionnalité offre un accès identique à internetClient ou internetClientClientServer.

Rendez-vous

Remarque  Prise en charge à compter du manifeste du package d’application pour les applications du Windows Store Windows 8.1. Cette fonctionnalité est également prise en charge pour Windows Phone.

La fonctionnalité appointments permet d’accéder au magasin de rendez-vous de l’utilisateur. Cette fonctionnalité permet d’accéder en lecture aux rendez-vous obtenus à partir des comptes réseau synchronisés et à d’autres applications qui écrivent dans le magasin de rendez-vous. Grâce à cette fonctionnalité, votre application peut créer des calendriers et écrire des rendez-vous dans ceux-ci.

Contacts

Remarque  Prise en charge à compter du manifeste du package d’application pour les applications du Windows Store Windows 8.1. Cette fonctionnalité est également prise en charge pour Windows Phone.

La fonctionnalité contacts permet d’accéder à la vue de synthèse des contacts à partir de différents magasins de contacts. Cette fonctionnalité donne à l’application un accès limité (selon les règles d’autorisation du réseau) aux contacts qui ont été synchronisés à partir de divers réseaux et au magasin de contacts local.

Fonctionnalités de périphérique

Les fonctionnalités de périphérique permettent à votre application d’accéder à des périphériques et à des dispositifs internes. Les fonctionnalités de périphérique sont spécifiées avec l’élément DeviceCapability dans le manifeste de votre package d’application. Cet élément peut exiger des éléments enfants supplémentaires et certaines fonctionnalités de périphérique 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 et Schema reference for Windows 8 Windows Store apps ou Schema reference for Windows 8.1 and Windows Phone 8.1.

Géolocalisation

La fonctionnalité location fournit l’accès aux fonctionnalités de géolocalisation, qui sont obtenues à partir d’un matériel dédié, tel qu’un capteur GPS dans l’ordinateur, ou dérivées des informations réseau disponibles. Les applications doivent gérer le cas où l’utilisateur a désactivé les services de localisation à partir de l’icône Paramètres. Pour obtenir un exemple illustrant comment détecter l’emplacement de l’utilisateur, voir Détection de la géolocalisation.

Microphone

La fonctionnalité microphone fournit l’accès au flux audio du microphone, ce qui permet à l’application d’effectuer un enregistrement audio à partir de microphones connectés. Les applications doivent gérer le cas où l’utilisateur a désactivé le microphone à partir de l’icône Paramètres. Pour obtenir un exemple illustrant comment effectuer un enregistrement audio, voir Comment enregistrer un contenu audio ou vidéo.

Proximité

La fonctionnalité proximity permet à plusieurs périphériques très proches les uns des autres de communiquer entre eux. Cette fonctionnalité est généralement utilisée dans des jeux multijoueurs simples et dans des applications qui échangent des informations. Les périphériques tentent d’utiliser la technologie de communication qui offre la meilleure connexion possible, notamment Bluetooth, le WiFi et Internet. Cette fonctionnalité est utilisée uniquement pour initier la communication entre les périphériques. Pour obtenir un exemple illustrant comment utiliser la proximité pour connecter des applications, voir Démarrage rapide : connexion d’applications à l’aide d’un geste tactile ou de la navigation.

Webcam

La fonctionnalité webcam fournit un accès au flux vidéo d’une caméra intégrée ou d’une webcam externe, ce qui permet à l’application de capturer des photos et des vidéos. Sur Windows, les applications doivent gérer le cas où l’utilisateur a désactivé la caméra à partir de l’icône Paramètres. Pour obtenir un exemple illustrant comment effectuer un enregistrement vidéo, voir Comment enregistrer un contenu audio ou vidéo.

La fonctionnalité webcam ne donne accès qu’au flux vidéo. Pour accorder l’accès aux flux audio, la fonctionnalité microphone doit être ajoutée.

USB

La fonctionnalité de périphérique usb permet d’accéder aux API dans l’espace de noms Windows.Devices.Usb. À l’aide de l’espace de noms, vous pouvez écrire une application qui communique avec un périphérique USB personnalisé. Dans ce contexte, « personnalisé » qualifie un périphérique pour lequel Microsoft ne fournit pas de pilote de classe intégré. Cette fonctionnalité de périphérique nécessite des éléments enfants. Pour plus d’informations, voir Mise à jour du package du manifeste de l’application pour un périphérique USB.

Remarque  Les API USB ne sont pas prises en charge sur Windows Phone.

Périphérique d’interface utilisateur (HID)

La fonctionnalité de périphérique humaninterfacedevice permet d’accéder aux API dans l’espace de noms Windows.Devices.HumanInterfaceDevice. Cet espace de noms permet à votre application d’accéder aux périphériques qui prennent en charge le protocole HID. Cette fonctionnalité de périphérique nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour HID.

Profil Bluetooth GATT

La fonctionnalité de périphérique bluetooth.genericAttributeProfile permet d’accéder aux API dans l’espace de noms Windows.Devices.Bluetooth.GenericAttributeProfile. Cet espace de noms permet à votre application d’accéder aux périphériques Bluetooth LE par le biais d’une collection de services principaux, de services inclus, de caractéristiques et de descripteurs. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.

Service Bluetooth RFCOMM

La fonctionnalité de périphérique bluetooth.rfcomm permet d’accéder aux API dans l’espace de noms Windows.Devices.Bluetooth.Rfcomm. Cet espace de noms prend en charge le transport BR/EDR (Basic Rate/Extended Data Rate) et permet à votre application d’accéder à un périphérique qui implémente le profil SPP (Serial Port Profile). Cette fonctionnalité de périphérique nécessite des éléments enfants. Pour plus d’informations, voir Comment spécifier des fonctionnalités de périphérique pour Bluetooth.

Point de service

La fonctionnalité de périphérique pointOfService permet d’accéder aux API dans l’espace de noms Windows.Devices.PointOfService. Cet espace de noms permet à votre application du Windows Store d’accéder aux lecteurs de codes barre et aux lecteurs de bande magnétique « point de service ». L’espace de noms offre une interface indépendante du fournisseur qui permet d’accéder aux périphériques « point de service » de différents constructeurs depuis une application du Windows Store. Pour plus d’informations sur ces API, voir Windows 8.1 : nouvelles API et fonctionnalités.

Remarque  Les API Point de service ne sont pas prises en charge sur Windows Phone.

Fonctionnalités à usage spécial

Les fonctionnalités à usage spécial sont destinées à des scénarios très spécifiques. L’utilisation de ces fonctionnalités est extrêmement limitée et sujette à un examen et une stratégie d’accueil Windows Store supplémentaires. Dans certains cas, de telles fonctionnalités sont nécessaires et appropriées, telles que des applications bancaires avec une authentification à deux facteurs, dans lesquelles les utilisateurs fournissent une carte à puce dotée d’un certificat numérique qui confirme leur identité. D’autres applications peuvent être conçues principalement pour des clients professionnels et peuvent avoir besoin d’accéder à des ressources d’entreprise auxquelles il n’est pas possible d’accéder sans les informations d’identification de domaine de l’utilisateur.

Les applications qui appliquent les fonctionnalités d’utilisation spécifiques requièrent un compte d’entreprise pour pouvoir être envoyées au Windows Store. Pour plus d’informations sur les comptes d’entreprise pour Windows, voir Types de comptes, emplacements et frais. Pour Windows Phone, voir Informations concernant l’inscription.

Authentification en entreprise

Les informations d’identification de domaine Windows permettent à un utilisateur de se connecter à des ressources distantes à l’aide de ses informations d’identification, comme si l’utilisateur avait fourni ses propres nom d’utilisateur et mot de passe. La fonctionnalité enterpriseAuthentication est généralement utilisée dans des applications métiers qui se connectent à des serveurs au sein d’une entreprise.

Vous n’avez pas besoin de cette fonctionnalité pour une communication générique sur Internet.

La fonctionnalité enterpriseAuthentication a été conçue pour prendre en charge des applications métiers courantes. Ne la déclarez pas dans des applications qui n’ont pas besoin d’accéder à des ressources d’entreprise. Le file picker fournit un mécanisme d’interface utilisateur robuste qui permet aux utilisateurs d’ouvrir les fichiers sur un partage réseau à utiliser avec une application. Déclarez la fonctionnalité enterpriseAuthentication seulement quand les scénarios pour votre application nécessitent un accès par programme et que vous ne pouvez pas les réaliser à l’aide du file picker.

Certificats utilisateur partagés

La fonctionnalité sharedUserCertificates permet à une application d’accéder à des certificats de logiciel et de matériel, tels que les certificats stockés sur une carte à puce. Cette fonctionnalité est généralement utilisée pour des applications financières ou d’entreprise qui ont besoin d’une carte à puce pour l’authentification.

Documents

La fonctionnalité documentsLibrary fournit un accès par programme aux documents de l’utilisateur, filtrés en fonction des associations de types de fichiers déclarées dans le manifeste du package, pour prendre en charge l’accès hors connexion à OneDrive. Par exemple, si une application de type lecteur DOC a déclaré une association de type de fichier .doc, elle peut ouvrir les fichiers .doc dans les documents, mais pas d’autres types de fichiers.

Les applications qui déclarent la fonctionnalité documentsLibrary ne peuvent pas accéder aux documents sur les ordinateurs d’un groupe résidentiel. Le sélecteur de fichiers fournit un mécanisme d’interface utilisateur robuste qui permet aux utilisateurs d’ouvrir les fichiers à utiliser avec une application. Déclarez la fonctionnalité documentsLibrary uniquement quand vous ne pouvez pas utiliser le sélecteur de fichiers.

Pour pouvoir utiliser la fonctionnalité documentsLibrary, une application doit :

  • faciliter l’accès hors connexion interplateforme à du contenu OneDrive spécifique à l’aide d’URL ou d’ID de ressource OneDrive valides ;
  • enregistrer automatiquement les fichiers ouverts sur le OneDrive de l’utilisateur en mode hors connexion.

Les applications qui utilisent la fonctionnalité documentsLibrary dans ces deux objectifs ont également la possibilité de l’utiliser pour ouvrir du contenu incorporé dans un autre document. Seules les utilisations ci-dessus de la fonctionnalité documentsLibrary sont acceptées.

Vous ne pouvez pas utiliser la bibliothèque Documents dans une application du Windows Phone Store.

  • Vous ne pouvez pas publier une application du Windows Phone Store qui spécifie la fonctionnalité documentsLibrary sur le Windows Phone Store. Le Store empêche la publication de l’application.

  • Votre application ne peut pas accéder à la bibliothèque Documents sur le support de stockage interne du téléphone. Toutefois, si une autre application crée un dossier Documents sur la carte SD optionnelle, votre application peut accéder à ce dossier.

Rubriques associées

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

 

 

Afficher:
© 2014 Microsoft