Introducción a los metadatos del servicio

Advertencia de desuso de MBAE

Importante

A partir de Windows 10, versión 1803, la experiencia de la aplicación MBAE se reemplaza por una aplicación para UWP mo. Para obtener más información sobre las aplicaciones para UWP mo, consulta Aplicaciones de banda ancha móvil para UWP.

Puede crear y enviar un paquete de metadatos de servicio para crear una experiencia profundamente integrada con Windows. Cuando Windows detecta hardware de banda ancha móvil que coincide con el paquete de metadatos de servicio del operador, descarga automáticamente los metadatos del servicio y la aplicación de banda ancha móvil especificada.

Los metadatos del servicio contienen la información que describe un servicio, incluidos los siguientes:

• Nombre del proveedor de servicios

• Una o varias categorías de servicio

• Información específica de banda ancha móvil

• Aplicación de banda ancha móvil

• Perfiles de banda ancha móvil

• Certificados de confianza para el aprovisionamiento XML

• Elemento DeviceNotificationHandler

• Elemento PrivilegedApplications

La información de los metadatos se usa para personalizar aspectos del Windows 8, Windows 8.1 y Windows 10 experiencia del usuario y proporcionar integración con una aplicación de banda ancha móvil, conocida anteriormente como aplicación de operador móvil.

Un paquete de metadatos de servicio consta de varios documentos XML almacenados en un archivo .devicemetadata-ms. Cada documento especifica varios componentes de los atributos del servicio. Estos documentos XML proporcionan a Windows Administrador de conexiones con personalizaciones que aparecen al usuario, así como información de configuración de red.

Para obtener información de referencia sobre los documentos XML en un paquete de metadatos de servicio, consulte Referencia del esquema del paquete de metadatos de servicio.

Contenido de metadatos del servicio

En el resumen siguiente se describen algunos de los campos más interesantes que se incluyen y definen dentro de un paquete de metadatos de servicio:

• Identificadores de hardware
  Para una red GSM, puede enviar un paquete de metadatos que describa los intervalos IMSI o ICCID con los que desea que coincida el paquete de metadatos del servicio. Si es un MVNO, puede especificar uno o varios intervalos de IMSIs o identificadores DE ICC de SIM que haya concedido desde un MNO. Para una red XAML, puede enviar un paquete mediante el identificador de proveedor (SID/NID) o el nombre del proveedor. Los identificadores de hardware corresponden al elemento HardwareID del esquema del paquete de metadatos de servicio. Para obtener más información sobre cómo planear los intervalos de identificación de hardware (HWID) para escenarios de MNO y MVNO, consulte Entrega de experiencias para MVNOs.

• Número de servicio
  Identificador único del proveedor de servicios de banda ancha móvil. Este GUID también se usa para identificar al operador al usar metadatos de aprovisionamiento de cuentas. Si actualiza el paquete de metadatos del dispositivo, este GUID debe permanecer igual. El número de servicio corresponde al elemento ServiceNumber en el esquema del paquete de metadatos de servicio.

• Logotipo del operador Logotipo personalizado que aparece en Windows Administrador de conexiones junto a la entrada de red. (El logotipo está oculto cuando el usuario está en una red móvil). El logotipo del operador corresponde al elemento ServiceIconFile en el esquema del paquete de metadatos de servicio. Para obtener más información sobre los requisitos de logotipo, consulte Requisitos de icono de servicio.

  Importante

  En Windows 10, versión 1709 y posteriores, este campo se ha reemplazado por personalización de marca a través de COSA. Los campos de COSA para la personalización de marca se describen en Planning your desktop COSA/APN database submission (Planear el envío de base de datos COSA/APN de escritorio). Si tiene como destino versiones de Windows antes de Windows 10, versión 1709, todavía creará un paquete de metadatos como se describe en esta sección. Para obtener más información sobre COSA, vea INFORMACIÓN general sobre COSA.

• Aplicación de banda ancha móvil
  Una aplicación de dispositivo para UWP que se descarga y se aplica automáticamente al equipo. Esta aplicación puede proporcionar experiencias clave, como la compra de planes, el uso de datos y la ayuda y el soporte técnico, y pueden resaltar los servicios de valor añadido.

• Perfil de compra de MB
  Perfil de compra que se usa para establecer conectividad limitada para comprar una suscripción.

  Si es un operador GSM que solo tiene un APN de compra para todos los suscriptores, puede usar los metadatos del servicio para aprovisionarlo en el equipo. Si tiene varias APN de compra, debe usar los metadatos de aprovisionamiento de cuentas para establecer el APN de compra adecuado. O bien, no puede hacer nada y usar las entradas almacenadas en la base de datos de APN para proporcionar información de conectividad de APN.

• Perfil de Internet de MB
  Cada suscripción de banda ancha móvil puede tener un perfil predeterminado que se usa para conectarse al operador de red doméstica. El Administrador de conexiones de Windows usa este perfil para conectarse automáticamente a la red.

  Si es un operador GSM que solo tiene un APN de Internet para todos los suscriptores, puede usar los metadatos del servicio para aprovisionar el equipo. Si tiene varias APN de Internet, debe usar metadatos de aprovisionamiento de cuentas para establecer el APN de Internet adecuado. O bien, no puede hacer nada y usar las entradas almacenadas en la base de datos de APN para proporcionar información de conectividad de APN.

• Datos del certificado
  Información de certificado usada para el aprovisionamiento. Esto incluye el nombre del emisor de certificados y el nombre del firmante. Esta información se usa para asegurarse de que un operador de confianza emite las operaciones de aprovisionamiento de cuentas iniciadas por un sitio web.

• Nombre del operador personalizado
  El dispositivo de banda ancha móvil suele proporcionar el nombre del operador, que Windows muestra en Windows Administrador de conexiones. Puede invalidar este nombre especificando un nombre personalizado en los metadatos. Este nombre solo muestra si el usuario está en una red doméstica y no está en una red móvil. Un nombre de red móvil mostrado se basa en la información que se recibe del dispositivo. Esto corresponde al elemento ServiceProvider del esquema de metadatos del paquete de servicio.

  Importante

  En Windows 10, versión 1709 y posteriores, este campo se ha reemplazado por personalización de marca a través de COSA. Los campos de COSA para la personalización de marca se describen en Planning your desktop COSA/APN database submission (Planear el envío de base de datos COSA/APN de escritorio). Si tiene como destino versiones de Windows antes de Windows 10, versión 1709, todavía creará un paquete de metadatos como se describe en esta sección. Para obtener más información sobre COSA, vea INFORMACIÓN general sobre COSA.

• Controlador de notificaciones de dispositivo
  En general, el usuario debe ejecutar una aplicación al menos una vez para poder registrar elementos de trabajo con el agente de eventos del sistema. Sin embargo, es posible que las aplicaciones de banda ancha móvil necesiten recibir eventos importantes antes de que el usuario pueda ejecutar la aplicación. Puede especificar el elemento DeviceNotificationHandler en los metadatos del servicio, que Windows usará para registrar algunos eventos críticos. Para obtener más información sobre las notificaciones por SMS, consulte Entrega de experiencias para MVNOs.

• Lista de aplicaciones con privilegios con acceso a interfaces restringidas de banda ancha móvil
  Las INTERFACES y las API de banda ancha móvil (incluido el aprovisionamiento de cuentas y SMS) están restringidas y están disponibles solo para aplicaciones de banda ancha móvil. Se puede especificar una lista de aplicaciones con privilegios que tienen acceso a estas API con privilegios en el paquete de metadatos del servicio en el elemento PrivilegedApplications . Las aplicaciones con privilegios pueden ser depurar o probar aplicaciones; no son necesarios para distribuirse a través de Microsoft Store.

Estructura del paquete de metadatos de servicio

Los componentes de un paquete de metadatos de servicio se almacenan en un archivo de gabinete comprimido y deben tener una extensión de archivo .devicemetadata-ms. Los paquetes de metadatos de servicio usan esta extensión de archivo porque usan la misma plataforma subyacente que los paquetes de metadatos del dispositivo. Antes de crear el archivo .devicemetadata-ms , primero debe crear un identificador único global (GUID) para el paquete de metadatos. A continuación, debe usar la siguiente convención de nomenclatura al crear el archivo .devicemetadata-ms: <GUID.devicemetadata-ms>.

Nota Aunque la extensión de archivo habitual de un archivo archivador es .cab, la extensión de archivo para un archivo de paquete de metadatos de servicio debe ser .devicemetadata-ms. Esto está pensado para resaltar el hecho de que los usuarios finales no deben descomprimir ni modificar estos paquetes.

Hay dos tipos de paquetes de metadatos de servicio: un único paquete de metadatos de servicio de configuración regional y un paquete de metadatos de servicio de configuración regional múltiple.

Paquete de metadatos de servicio de configuración regional única

Los recursos localizables del paquete de metadatos del servicio son el nombre del operador que aparece en Windows Administrador de conexiones y el icono de servicio que aparece junto a él. Si no necesita localizar el nombre o cambiar el icono en función de la información de configuración regional del equipo, cree un único paquete de metadatos de servicio de configuración regional. Independientemente de la configuración regional que use el usuario en su EQUIPO, obtendrá el nombre del operador y el icono de servicio definidos en el paquete de metadatos de servicio de configuración regional única.

Un único paquete de metadatos del servicio de configuración regional debe tener la siguiente estructura de archivos:

Algunas consideraciones para un único paquete de metadatos de configuración regional:

• El archivo de icono puede tener cualquier nombre de archivo. Sin embargo, los documentos XML individuales deben denominarse PackageInfo.xml, ServiceInfo.xml, WindowsInfo.xmly SoftwareInfo.xml.

• El nombre del archivo MobileBroadbandInfo.xml se define en el ServiceInfo.xml. Debe usar los nombres enumerados en este documento para ese archivo.

• El archivo .devicemetadata-ms no puede incluir "{" o "}" en el nombre. El GUID de cada nombre de archivo de paquete de metadatos debe ser único. Al crear un paquete de metadatos de servicio nuevo o revisado, debe crear un nuevo GUID, incluso si los cambios son menores.

• Windows reconoce los paquetes de metadatos de servicio con una extensión de archivo .devicemetadata-ms.

Estructura de varios paquetes de metadatos del servicio de configuración regional

Un paquete de metadatos de servicio admite varios archivos de configuración regional en un paquete. Si admite más de una configuración regional para el servicio, puede colocar varios archivos de configuración regional en un paquete de metadatos de servicio.

Puedes usar un paquete de metadatos de servicio local múltiple si quieres mostrar un nombre localizado para el servicio en Windows Administrador de conexiones lista de red o mostrar otro logotipo en Windows Administrador de conexiones para la red. Windows mostrará el nombre de red localizado y el logotipo en función del idioma preferido del sistema, que normalmente se configura durante la instalación de Windows. Incluso si el idioma del usuario actual es diferente del idioma preferido del sistema, el icono y el nombre de red siempre se mostrarán en el idioma preferido del sistema. Si el paquete de metadatos del servicio no incluye una configuración regional, se muestra la descripción neutral del idioma de la raíz del paquete de metadatos del servicio. Para la mayoría de los usuarios, su idioma coincidirá con el idioma preferido del sistema.

Un paquete de metadatos de servicio de configuración regional múltiple debe tener la siguiente estructura de archivos:

Algunas consideraciones para un paquete de metadatos de configuración regional múltiple:

• Cree una carpeta de nombre de configuración regional en cada carpeta y coloque el archivo XML o el archivo pertinente en la carpeta de nombres de configuración regional.

• Todavía debe tener el archivo XML de nivel superior y los archivos pertinentes, como el archivo de icono, en el nivel superior de cada carpeta. Esto proporciona un mecanismo de reserva cuando la configuración regional no se incluye en el paquete de metadatos del servicio.

• Asegúrese de que todos los archivos necesarios y los campos de esos archivos se rellenen completamente dentro de cada carpeta específica de la configuración regional que cree. Esto se suma al contenido del nivel superior de cada carpeta. Por ejemplo, el elemento ServiceNumber de ServiceInfo.xml debe rellenarse y duplicarse en la carpeta de nivel superior y en cada carpeta específica de la configuración regional que cree. Si no lo hace, se producirán errores.

• El documento XML SoftwareInformation no admite varias configuraciones regionales porque no se pueden especificar archivos SoftwareInfo.xml diferentes por configuración regional.

Envío y mantenimiento de metadatos de servicio

Para obtener más información sobre cómo enviar paquetes de metadatos de servicio al panel del Centro de desarrollo de Windows: hardware, consulta Guía para desarrolladores para crear metadatos de servicio.

Es importante mantener actualizados los paquetes de metadatos en términos de cómo se describen y cuáles son los valores imSI y ICCID o nombre de proveedor de XAML que coinciden. Esto puede requerir un MNO o MVNO para implementar un nuevo flujo de trabajo que forme parte de sim o adquisición de dispositivos para realizar un seguimiento de nuevos pedidos de SIM y el MNO o MVNO al que se proporcionan esos ICCID o IMSIs.

Se recomienda evitar realizar cambios frecuentes en los metadatos del servicio reservando los intervalos ICCID o IMSI (o el nombre de sim/proveedor XAML) para el MNO y el MVNO de antemano, de modo que cuando se adquieran nuevos SIM (o dispositivos STORAGE), ya se tienen en cuenta en el paquete de metadatos del servicio.

Si necesita actualizar los identificadores de servicio registrados en el panel de hardware del Centro de desarrollo de Windows, consulte Actualizaciones de propiedad del identificador de servicio.

Las actualizaciones de metadatos se aplican de forma silenciosa en función de la lógica interna de Windows (normalmente cada ocho días) cuando Windows consulta WMIS si tiene actualizaciones de metadatos actualizadas.

La aplicación debe diseñarse para tratar con una versión anterior de los metadatos a los que hace referencia, hasta que se apliquen los metadatos más recientes al sistema.

El diseño de la experiencia del usuario de una aplicación de banda ancha móvil proporciona instrucciones sobre cómo diseñar la experiencia del usuario para solucionar casos de error comunes, como cuando falta el dispositivo o no se reconoce.