Déclarations des fonctionnalités d’application

Déclarations des fonctionnalités d’application

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Si votre application a besoin d’un accès par programme à des ressources utilisateur telles que des images ou à des périphériques tels qu’une caméra, vous devez déclarer la fonctionnalité appropriée. Vous pouvez demander l’accès en déclarant les fonctionnalités dans le manifeste de package de votre application. Vous pouvez déclarer les fonctionnalités générales à l’aide du concepteur de manifeste dans Microsoft Visual Studio ou vous pouvez les ajouter manuellement—voir Comment spécifier des fonctionnalités dans un manifeste de package. Il est important de savoir que 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. Par conséquent, n’utilisez pas de fonctionnalités dont votre application n’a pas besoin.

Dans cet article, les fonctionnalités sont réparties selon quatre catégories décrites ci-dessous.

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

  • Les fonctionnalités de périphérique qui permettent à votre application d’accéder à des périphériques et à des dispositifs internes.

  • Les fonctionnalités à usage spécial qui nécessitent un compte d’entreprise spécial pour les soumettre au Windows Store et les utiliser. Pour plus d’informations sur les comptes d’entreprise, voir Types de comptes, emplacements et frais.

Remarque  Cette rubrique ne s’applique pas à Windows Phone. Pour plus d’informations sur les fonctionnalités de Windows Phone, voir Fonctionnalités d’application et configuration matérielle requise pour Windows Phone 8
 

Fonctionnalités à usage général

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

Scénario de fonctionnalitéUtilisation de la fonctionnalité
Music

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 utilisent 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 illustrant comment accéder aux fichiers dans une bibliothèque, voir Démarrage rapide : accès aux fichiers par programmation.

Pictures

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 photos qui utilisent 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 illustrant comment accéder aux fichiers dans une bibliothèque, voir Démarrage rapide : accès aux fichiers par programmation.

Videos

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 utilisent 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 illustrant comment accéder aux fichiers dans une bibliothèque, voir Démarrage rapide : accès aux fichiers par programmation.

Removable Storage

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 de documents 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 votre application fournisse une raison valable pour l’accès par programme au stockage amovible pour tous les fichiers du type déclaré.

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 and public networks

Il existe deux fonctionnalités qui fournissent différents niveaux d’accès à 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.

Sur Windows, la fonctionnalité internetClient indique que les applications peuvent recevoir des données entrantes en provenance d’Internet. Ne peut pas agir en tant que serveur. Pas d’accès au réseau local.

Sur Windows, la fonctionnalité internetClientServer indique que les applications peuvent recevoir des données entrantes en provenance d’Internet. Peut agir en tant que serveur. Pas d’accès au réseau local.

Sur Windows Phone, la fonctionnalité internetClient indique que les applications disposent d’un accès complet au réseau local et à Internet, et peuvent agir en tant que serveur. L’accès entrant aux ports critiques est toujours bloqué.

Sur Windows Phone, la fonctionnalité internetClientServer indique que les applications disposent d’un accès complet au réseau local et à Internet, et peuvent 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 de service 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.

Remarque  

Les applications Windows Phone Store proposent une fonctionnalité réseau unique qui autorise tout l’accès réseau pour l’application. La fonctionnalité internetClientServer 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. Si votre application nécessite une connectivité réseau, veillez à sélectionner la fonctionnalité Internet (client et serveur) sur la page Capacités du concepteur de manifeste.

Home and work networks

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 internetClientServer.

Appointments

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 y inscrire des rendez-vous.

Contacts

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.

Code generation

La fonctionnalité codeGeneration permet aux applications de générer du code dynamiquement.

AllJoyn

La fonctionnalité allJoyn permet aux applications et périphériques compatibles AllJoyn d’un réseau de se détecter mutuellement et d’interagir.

Toutes les applications qui accèdent aux API de l’espace de noms Windows.Devices.AllJoyn doivent utiliser cette fonctionnalité.

Phone calls

La fonctionnalité phoneCall permet aux applications d’accéder à toutes les lignes téléphoniques sur le périphérique et d’exécuter les fonctions suivantes :

  • Effectuer un appel sur la ligne téléphonique et afficher le numéroteur système sans solliciter l’utilisateur.
  • Accéder aux métadonnées associées à la ligne.
  • Accéder aux déclencheurs associés à la ligne.
  • Autoriser l’application de filtre antispam sélectionnée par l’utilisateur à définir et à vérifier la liste rouge et les informations sur l’origine des appels.
Recorded Calls Folder

La fonctionnalité d’appareil mobile recordedCallsFolder permet aux applications d’accéder au dossier d’appels enregistrés.

User Account Information

La fonctionnalité userAccountInformation offre aux applications la possibilité d’accéder au nom et à l’image de l’utilisateur.

Cette fonctionnalité est nécessaire pour accéder à certaines API de l’espace de noms Windows.System.User.

VOIP calling

La fonctionnalité voipCall permet aux applications d’accéder aux API d’appel VoIP de l’espace de noms Windows.ApplicationModel.Calls.

3D Objects

La fonctionnalité objects3d dote les applications d’un accès par programme aux fichiers objet 3D. Cette fonctionnalité est généralement utilisée dans les applications et les jeux 3D qui ont besoin d’accéder à l’intégralité de la bibliothèque d’objets 3D.

Cette fonctionnalité est nécessaire pour accéder au dossier contenant les objets 3D à l’aide des API de l’espace de noms Windows.Storage.

Read Blocked Messages

La fonctionnalité blockedChatMessages permet aux applications de lire les messages SMS et MMS bloqués par l’application de filtre antispam.

Cette fonctionnalité est nécessaire pour accéder aux messages bloqués à l’aide des API de l’espace de noms Windows.ApplicationModel.Chat.

Chat Message Access

La fonctionnalité chat permet aux applications de lire et de supprimer des messages texte. Cette fonctionnalité permet également aux applications de stocker des messages de conversation dans le magasin de données système.

Cette fonctionnalité est nécessaire pour utiliser les API de l’espace de noms Windows.ApplicationModel.Chat.

 

Fonctionnalités d’appareil mobile

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.

Scénario de fonctionnalitéUtilisation de la fonctionnalité
Location

La fonctionnalité location donne accès aux fonctionnalités de géolocalisation 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 donne 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.

Proximity

La fonctionnalité proximity permet à plusieurs appareils 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 donne accès au flux vidéo d’une caméra intégrée ou d’une webcam externe, ce qui permet à l’application d’enregistrer 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 autoriser l’accès au flux audio, la fonctionnalité microphone doit être ajoutée.

USB

La fonctionnalité de périphérique usb permet d’accéder aux API de 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.
 
Human interface device (HID)

La fonctionnalité d’appareil mobile humaninterfacedevice permet d’accéder aux API de 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 d’appareil mobile pour un périphérique d’interface utilisateur (HID).

Bluetooth GATT

La fonctionnalité d’appareil mobile bluetooth.genericAttributeProfile permet d’accéder aux API de 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.

Bluetooth RFCOMM

La fonctionnalité de périphérique bluetooth.rfcomm permet d’accéder aux API de 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 of Sevice (POS)

La fonctionnalité d’appareil mobile pointOfService permet d’accéder aux API de 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.

Remarque  Les API « point de service » ne sont pas prises en charge sur Windows Phone.
 

 

Fonctionnalités spéciales

Les fonctionnalités spéciales 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, par exemple pour les 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 spéciales 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.

Scénario de fonctionnalitéUtilisation de la fonctionnalité
Enterprise authentication

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é spéciale 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 capacité pour une communication générique sur Internet.

La fonctionnalité spéciale 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é spéciale 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.

Shared user certificates

La fonctionnalité spéciale 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é spéciale 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é spéciale 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é spéciale documentsLibrary uniquement quand vous ne pouvez pas utiliser le sélecteur de fichiers.

Pour pouvoir utiliser la fonctionnalité spéciale 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é spéciale 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é spéciale 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é spéciale 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:
© 2017 Microsoft