Vue d’ensemble des métadonnées de service

Avertissement de dépréciation MBAE

Important

À compter de Windows 10, version 1803, l’expérience d’application MBAE est remplacée par une application UWP MO. Pour plus d’informations sur les applications UWP MO, consultez Applications haut débit mobiles UWP.

Vous pouvez créer et envoyer un package de métadonnées de service pour créer une expérience profondément intégrée à Windows. Lorsque Windows détecte du matériel haut débit mobile qui correspond au package de métadonnées de service de l’opérateur, il télécharge automatiquement les métadonnées de service et l’application haut débit mobile spécifiée.

Les métadonnées de service contiennent les informations qui décrivent un service, notamment les éléments suivants :

• Nom du fournisseur de services

• Une ou plusieurs catégories de services

• Informations spécifiques au haut débit mobile

• Application haut débit mobile

• Profils haut débit mobiles

• Certificats approuvés pour l’approvisionnement xml

• Élément DeviceNotificationHandler

• Élément PrivilegedApplications

Les informations contenues dans les métadonnées sont utilisées pour personnaliser certains aspects de l’expérience utilisateur Windows 8, Windows 8.1 et Windows 10 et fournir une intégration à une application haut débit mobile, anciennement appelée application d’opérateur mobile.

Un package de métadonnées de service se compose de plusieurs documents XML stockés dans un fichier .devicemetadata-ms. Chaque document spécifie différents composants des attributs du service. Ces documents XML fournissent aux Gestionnaire des connexions Windows des personnalisations qui apparaissent à l’utilisateur, ainsi que des informations de configuration réseau.

Pour obtenir des informations de référence sur les documents XML d’un package de métadonnées de service, consultez Informations de référence sur le schéma du package de métadonnées de service.

Contenu des métadonnées de service

Le résumé suivant décrit certains des champs les plus intéressants contenus et définis à l’intérieur d’un package de métadonnées de service :

• ID matériels
  Pour un réseau GSM, vous pouvez envoyer un package de métadonnées qui décrit les plages IMSI ou ICCID auxquelles vous souhaitez que votre package de métadonnées de service corresponde. Si vous êtes un MVNO, vous pouvez spécifier une ou plusieurs plages d’ID ICC SIM ou IMS que vous avez louées à partir d’un MNO. Pour un réseau CDMA, vous pouvez envoyer un package à l’aide de l’ID de fournisseur (SID/NID) ou du nom du fournisseur. Les ID matériels correspondent à l’élément HardwareID dans le schéma du package de métadonnées de service. Pour plus d’informations sur la planification de vos plages d’identification matérielle (HWID) pour les scénarios MNO et MVNO, consultez Livraison d’expériences pour les MVNO

• Numéro de service
  ID unique du fournisseur de services haut débit mobile. Ce GUID est également utilisé pour identifier l’opérateur lors de l’utilisation des métadonnées d’approvisionnement de compte. Si vous mettez à jour le package de métadonnées d’appareil, ce GUID doit rester le même. Le numéro de service correspond à l’élément ServiceNumber dans le schéma du package de métadonnées de service.

• Logo de l’opérateur Un logo personnalisé qui apparaît dans Windows Gestionnaire des connexions en regard de votre entrée réseau. (Le logo est masqué lorsque l’utilisateur se trouve sur un réseau itinérant.) Le logo de l’opérateur correspond à l’élément ServiceIconFile dans le schéma du package de métadonnées de service. Pour plus d’informations sur la configuration requise du logo, consultez Configuration requise pour les icônes de service.

  Important

  Dans Windows 10, version 1709 et ultérieures, ce champ a été remplacé par la personnalisation via COSA. Les champs dans COSA pour la personnalisation sont décrits dans Planification de la soumission de votre base de données COSA/APN de bureau. Si vous ciblez des versions de Windows avant Windows 10, version 1709, vous allez toujours créer un package de métadonnées comme décrit dans cette section. Pour plus d’informations sur COSA, consultez Vue d’ensemble de COSA.

• Application haut débit mobile
  Application d’appareil UWP qui est automatiquement téléchargée et appliquée à l’ordinateur. Cette application peut fournir des expériences clés telles que l’achat de plan, l’utilisation des données, l’aide et le support, et peut mettre en évidence les services à valeur ajoutée.

• Profil d’achat mo
  Profil d’achat utilisé pour établir une connectivité limitée pour l’achat d’un abonnement.

  Si vous êtes un opérateur GSM qui n’a qu’un seul APN d’achat pour tous les abonnés, vous pouvez utiliser les métadonnées du service pour le provisionner sur l’ordinateur. Si vous avez plusieurs APN d’achat, vous devez utiliser les métadonnées d’approvisionnement de compte pour définir l’APN d’achat approprié. Ou vous ne pouvez rien faire et utiliser les entrées stockées dans la base de données APN pour fournir des informations de connectivité APN.

• Profil Internet Mb
  Chaque abonnement haut débit mobile peut avoir un profil par défaut utilisé pour se connecter à l’opérateur réseau domestique. Le Gestionnaire des connexions Windows utilise ce profil pour la connexion automatique au réseau.

  Si vous êtes un opérateur GSM qui n’a qu’un seul APN Internet pour tous les abonnés, vous pouvez utiliser les métadonnées du service pour approvisionner l’ordinateur. Si vous avez plusieurs APN Internet, vous devez utiliser les métadonnées d’approvisionnement de compte pour définir l’APN Internet approprié. Ou vous ne pouvez rien faire et utiliser les entrées stockées dans la base de données APN pour fournir des informations de connectivité APN.

• Certificate data
  Informations de certificat utilisées pour l’approvisionnement. Cela inclut le nom de l’émetteur de certificat et le nom de l’objet. Ces informations sont utilisées pour garantir que les opérations d’approvisionnement de compte lancées par un site web sont émises par un opérateur approuvé.

• Nom de l’opérateur personnalisé
  L’appareil haut débit mobile fournit généralement le nom de l’opérateur, que Windows affiche dans Windows Gestionnaire des connexions. Vous pouvez remplacer ce nom en spécifiant un nom personnalisé dans les métadonnées. Ce nom s’affiche uniquement si l’utilisateur se trouve sur un réseau domestique et n’est pas sur un réseau itinérant. Un nom de réseau itinérant affiché est basé sur les informations reçues de l’appareil. Cela correspond à l’élément ServiceProvider dans le schéma de métadonnées du package de service.

  Important

  Dans Windows 10, version 1709 et ultérieures, ce champ a été remplacé par la personnalisation via COSA. Les champs dans COSA pour la personnalisation sont décrits dans Planification de la soumission de votre base de données COSA/APN de bureau. Si vous ciblez des versions de Windows avant Windows 10, version 1709, vous allez toujours créer un package de métadonnées comme décrit dans cette section. Pour plus d’informations sur COSA, consultez Vue d’ensemble de COSA.

• Gestionnaire de notification d’appareil
  En général, une application doit être exécutée par l’utilisateur au moins une fois avant de pouvoir inscrire des éléments de travail auprès du répartiteur d’événements système. Toutefois, les applications haut débit mobiles peuvent avoir besoin de recevoir des événements importants avant que l’utilisateur puisse exécuter l’application. Vous pouvez spécifier l’élément DeviceNotificationHandler dans les métadonnées de service, que Windows utilisera pour inscrire certains événements critiques. Pour plus d’informations sur les notifications SMS, consultez Remise d’expériences pour les MVNO.

• Liste des applications privilégiées ayant accès à des interfaces mobiles à large bande restreinte
  Les API et interfaces haut débit mobile (y compris l’approvisionnement de compte et SMS) sont limitées et disponibles uniquement pour les applications haut débit mobiles. Une liste d’applications privilégiées qui ont accès à ces API privilégiées peut être spécifiée dans le package de métadonnées de service de l’élément PrivilegedApplications . Les applications privilégiées peuvent être des applications de débogage ou de test ; ils ne sont pas obligatoirement distribués via le Microsoft Store.

Structure du package de métadonnées de service

Les composants d’un package de métadonnées de service sont stockés dans un fichier d’armoire compressé et doivent avoir une extension de fichier .devicemetadata-ms. Les packages de métadonnées de service utilisent cette extension de fichier, car ils utilisent la même plateforme sous-jacente que les packages de métadonnées d’appareil. Avant de créer le fichier .devicemetadata-ms , vous devez d’abord créer un identificateur global unique (GUID) pour le package de métadonnées. Ensuite, vous devez utiliser la convention d’affectation de noms suivante lorsque vous créez le fichier .devicemetadata-ms : <GUID.devicemetadata-ms>.

Note Bien que l’extension de fichier habituelle d’un fichier d’armoire soit .cab, l’extension de fichier d’un fichier de package de métadonnées de service doit être .devicemetadata-ms. Ceci est destiné à souligner le fait que les utilisateurs finaux ne doivent pas décompresser ou modifier ces packages.

Il existe deux types de packages de métadonnées de service : un package de métadonnées de service de paramètres régionaux unique et un package de métadonnées de service de plusieurs paramètres régionaux.

Package de métadonnées de service de paramètres régionaux uniques

Les ressources localisables dans le package de métadonnées de service sont le nom de l’opérateur qui apparaît dans Windows Gestionnaire des connexions et l’icône de service qui apparaît en regard de celui-ci. Si vous n’avez pas besoin de localiser votre nom ou de modifier votre icône en fonction des informations de paramètres régionaux du PC, créez un package de métadonnées de service de paramètres régionaux unique. Quels que soient les paramètres régionaux que l’utilisateur utilise sur son PC, il obtient le nom de l’opérateur et l’icône de service définis dans le package de métadonnées du service de paramètres régionaux uniques.

Un package de métadonnées de service de paramètres régionaux doit avoir la structure de fichier suivante :

Voici quelques considérations relatives à un package de métadonnées de paramètres régionaux unique :

• Le fichier d’icône peut avoir n’importe quel nom de fichier. Toutefois, les documents XML individuels doivent être nommés PackageInfo.xml, ServiceInfo.xml, WindowsInfo.xmlet SoftwareInfo.xml.

• Le nom du fichier MobileBroadbandInfo.xml est défini dans le ServiceInfo.xml. Vous devez utiliser les noms répertoriés dans ce document pour ce fichier.

• Le fichier .devicemetadata-ms ne peut pas inclure « { » ou « } » dans le nom. Le GUID de chaque nom de fichier de package de métadonnées doit être unique. Lorsque vous créez un package de métadonnées de service nouveau ou révisé, vous devez créer un GUID, même si les modifications sont mineures.

• Windows reconnaît les packages de métadonnées de service avec une extension de fichier .devicemetadata-ms.

Structure du package de métadonnées de service de paramètres régionaux multiples

Un package de métadonnées de service prend en charge plusieurs fichiers de paramètres régionaux dans un même package. Si vous prenez en charge plusieurs paramètres régionaux pour votre service, vous pouvez placer plusieurs fichiers de paramètres régionaux dans un seul package de métadonnées de service.

Vous pouvez utiliser un package de métadonnées de service local multiple si vous souhaitez afficher un nom localisé pour votre service dans la liste réseau Windows Gestionnaire des connexions ou pour afficher un autre logo dans Windows Gestionnaire des connexions pour votre réseau. Windows affiche le nom et le logo réseau localisés en fonction de la langue par défaut du système, qui est généralement configurée pendant l’installation de Windows. Même si la langue de l’utilisateur actuel est différente de la langue préférée du système, l’icône et le nom du réseau s’affichent toujours dans la langue préférée du système. Si le package de métadonnées de service n’inclut pas de paramètres régionaux, la description linguistique indépendante de la racine du package de métadonnées de service s’affiche. Pour la plupart des utilisateurs, leur langue correspond à la langue préférée du système.

Un package de métadonnées de service de paramètres régionaux multiples doit avoir la structure de fichiers suivante :

Quelques considérations relatives à un package de métadonnées de plusieurs paramètres régionaux :

• Créez un dossier de noms de paramètres régionaux dans chaque dossier et placez le fichier XML ou le fichier approprié dans le dossier de nom des paramètres régionaux.

• Vous devez toujours disposer du fichier XML de niveau supérieur et des fichiers pertinents, tels que le fichier d’icône, au niveau supérieur de chaque dossier. Cela fournit un mécanisme de secours lorsque les paramètres régionaux ne sont pas inclus dans votre package de métadonnées de service.

• Assurez-vous que tous les fichiers requis et les champs de ces fichiers sont entièrement renseignés dans chaque dossier spécifique aux paramètres régionaux que vous créez. Cela s’ajoute au contenu du niveau supérieur de chaque dossier. Par exemple, l’élément ServiceNumber dans ServiceInfo.xml doit être rempli et dupliqué dans le dossier de niveau supérieur et dans chaque dossier spécifique aux paramètres régionaux que vous créez. Si vous ne le faites pas, vous obtiendrez des erreurs.

• Le document XML SoftwareInformation ne prend pas en charge plusieurs paramètres régionaux, car vous ne pouvez pas spécifier différents fichiers SoftwareInfo.xml par paramètres régionaux.

Soumission et maintenance des métadonnées de service

Pour plus d’informations sur la façon d’envoyer des packages de métadonnées de service au Tableau de bord du Centre de développement Windows – Matériel, consultez le Guide du développeur pour la création de métadonnées de service.

Il est important de maintenir les packages de métadonnées à jour en termes de description et de valeurs IMSI et ICCID ou CDMA Provider Name ou SID qu’ils correspondent. Cela peut nécessiter qu’un MNO ou un MVNO implémente un nouveau flux de travail qui fait partie de l’acquisition d’une carte SIM ou d’un appareil pour suivre les nouvelles commandes de cartes SIM et les MNO ou MVNO auxquels ces ICCID ou IMSI sont fournis.

Il est recommandé d’éviter d’apporter des modifications fréquentes aux métadonnées de votre service en réservant à l’avance des plages ICCID ou IMSI (ou le nom de fournisseur/SIM CDMA) pour le MNO et le MVNO, de sorte que lorsque de nouvelles cartes SIM (ou appareils CDMA) sont achetées, elles sont déjà prises en compte dans votre package de métadonnées de service.

Si vous devez mettre à jour vos identificateurs de service inscrits dans le tableau de bord matériel du Centre de développement Windows, consultez Mises à jour de la propriété de l’identificateur de service.

Les mises à jour de métadonnées sont appliquées en mode silencieux en fonction de la logique Windows interne (généralement tous les huit jours) lorsque Windows interroge WMIS pour savoir s’il dispose d’une mise à jour des métadonnées mises à jour.

L’application doit être conçue pour traiter une version précédente des métadonnées auxquelles elle fait référence, jusqu’à ce que les dernières métadonnées soient appliquées au système.

La conception de l’expérience utilisateur d’une application haut débit mobile fournit des instructions sur la façon de concevoir l’expérience utilisateur pour résoudre les cas d’erreur courants, par exemple lorsque l’appareil est manquant ou non reconnu.