Visão geral dos metadados de serviço

Aviso de substituição do MBAE

Importante

A partir de Windows 10, versão 1803, a experiência do aplicativo MBAE é substituída por um aplicativo UWP mo. Para obter mais informações sobre aplicativos UWP mo, consulte Aplicativos de banda larga móvel UWP.

Você pode criar e enviar um pacote de metadados de serviço para criar uma experiência profundamente integrada ao Windows. Quando o Windows detecta hardware de banda larga móvel que corresponde ao pacote de metadados de serviço da operadora, ele baixa automaticamente os metadados de serviço e o aplicativo de banda larga móvel especificado.

Os metadados de serviço contêm as informações que descrevem um serviço, incluindo o seguinte:

• O nome do provedor de serviços

• Uma ou mais categorias de serviço

• Informações específicas da banda larga móvel

• Aplicativo de banda larga móvel

• Perfis de banda larga móvel

• Certificados confiáveis para provisionamento de XML

• Elemento DeviceNotificationHandler

• Elemento PrivilegedApplications

As informações nos metadados são usadas para personalizar aspectos do Windows 8, Windows 8.1 e Windows 10 experiência do usuário e fornecer integração com um aplicativo de banda larga móvel, anteriormente conhecido como um aplicativo de operadora móvel.

Um pacote de metadados de serviço consiste em vários documentos XML armazenados em um arquivo .devicemetadata-ms. Cada documento especifica vários componentes dos atributos do serviço. Esses documentos XML fornecem ao Windows Gerenciador de Conexões personalizações que aparecem para o usuário, bem como informações de configuração de rede.

Para obter informações de referência sobre os documentos XML em um pacote de metadados de serviço, consulte Referência de esquema de pacote de metadados de serviço.

Conteúdo de metadados de serviço

O resumo a seguir descreve alguns dos campos mais interessantes contidos e definidos dentro de um pacote de metadados de serviço:

• Hardware IDs
  Para uma rede GSM, você pode enviar um pacote de metadados que descreve os intervalos IMSI ou ICCID nos quais você deseja que o pacote de metadados de serviço corresponda. Se você for um MVNO, poderá especificar um ou mais intervalos de IMSIs ou IDs DE ICC do SIM que você alugou de um MNO. Para uma rede CDMA, você pode enviar um pacote usando a ID do Provedor (SID/NID) ou o Nome do Provedor. As IDs de hardware correspondem ao elemento HardwareID no esquema do pacote de metadados de serviço. Para obter mais informações sobre como planejar seus intervalos de HWID (Identificação de Hardware) para cenários MNO e MVNO, consulte Entregando experiências para MVNOs

• Número do serviço
  A ID exclusiva para o provedor de serviços de banda larga móvel. Esse GUID também é usado para identificar o operador ao usar metadados de provisionamento de conta. Se você atualizar o pacote de metadados do dispositivo, esse GUID deverá permanecer o mesmo. O número do serviço corresponde ao elemento ServiceNumber no esquema do pacote de metadados de serviço.

• Logotipo do operador Um logotipo personalizado que aparece no Windows Gerenciador de Conexões ao lado de sua entrada de rede. (O logotipo fica oculto quando o usuário está em uma rede móvel.) O logotipo do operador corresponde ao elemento ServiceIconFile no esquema do pacote de metadados de serviço. Para obter mais informações sobre os requisitos do logotipo, consulte Requisitos do ícone de serviço.

  Importante

  Em Windows 10, versão 1709 e posterior, esse campo foi substituído por identidade visual por meio de COSA. Os campos no COSA para identidade visual são descritos em Planejamento do envio de banco de dados COSA/APN da área de trabalho. Se você estiver direcionando versões do Windows antes do Windows 10, versão 1709, ainda criará um pacote de metadados, conforme descrito nesta seção. Para obter mais informações sobre COSA, consulte Visão geral da COSA.

• Aplicativo de banda larga móvel
  Um aplicativo de dispositivo UWP que é baixado e aplicado automaticamente ao computador. Esse aplicativo pode fornecer experiências importantes, como compra de planos, uso de dados e ajuda e suporte, e pode destacar serviços de valor agregado.

• Perfil de Compra do MB
  Perfil de compra usado para estabelecer conectividade limitada para comprar uma assinatura.

  Se você for um operador GSM que tenha apenas um APN de compra para todos os assinantes, poderá usar os metadados de serviço para provisioná-lo no computador. Se você tiver várias APNs de Compra, deverá usar metadados de provisionamento de conta para definir o APN de compra apropriado. Ou você não pode fazer nada e usar as entradas armazenadas no banco de dados APN para fornecer informações de conectividade apn.

• Perfil da Internet mb
  Cada assinatura de banda larga móvel pode ter um perfil padrão usado para se conectar ao operador de rede inicial. O Windows Gerenciador de Conexões usa esse perfil para se conectar automaticamente à rede.

  Se você for um operador GSM que tenha apenas um APN de Internet para todos os assinantes, poderá usar os metadados de serviço para provisionar o computador. Se você tiver várias APNs da Internet, deverá usar metadados de provisionamento de conta para definir o APN de Internet apropriado. Ou você não pode fazer nada e usar as entradas armazenadas no banco de dados APN para fornecer informações de conectividade apn.

• Dados do certificado
  Informações de certificado usadas para provisionamento. Isso inclui o Nome do Emissor do Certificado e o Nome da Entidade. Essas informações são usadas para garantir que as operações de provisionamento de conta iniciadas por um site sejam emitidas por um operador confiável.

• Nome do operador personalizado
  O dispositivo de banda larga móvel normalmente fornece o nome do operador, que o Windows mostra no Windows Gerenciador de Conexões. Você pode substituir esse nome especificando um nome personalizado em metadados. Esse nome será exibido somente se o usuário estiver em uma rede inicial e não estiver em uma rede móvel. Um nome de rede móvel exibido baseia-se nas informações recebidas do dispositivo. Isso corresponde ao elemento ServiceProvider no esquema de metadados do pacote de serviço.

  Importante

  Em Windows 10, versão 1709 e posterior, esse campo foi substituído por identidade visual por meio de COSA. Os campos no COSA para identidade visual são descritos em Planejamento do envio de banco de dados COSA/APN da área de trabalho. Se você estiver direcionando versões do Windows antes do Windows 10, versão 1709, ainda criará um pacote de metadados, conforme descrito nesta seção. Para obter mais informações sobre COSA, consulte Visão geral da COSA.

• Manipulador de notificação de dispositivo
  Em geral, um aplicativo deve ser executado pelo usuário pelo menos uma vez antes de poder registrar itens de trabalho com o agente de Eventos do Sistema. No entanto, os aplicativos de banda larga móvel podem precisar receber eventos importantes antes que o usuário possa executar o aplicativo. Você pode especificar o elemento DeviceNotificationHandler nos metadados de serviço, que o Windows usará para registrar alguns eventos críticos. Para obter mais informações sobre notificações por SMS, consulte Entregando experiências para MVNOs.

• Lista de aplicativos privilegiados com acesso a interfaces restritas de banda larga móvel
  As APIs e interfaces de banda larga móvel (incluindo Provisionamento de Conta e SMS) são restritas e disponíveis apenas para aplicativos de banda larga móvel. Uma lista de aplicativos privilegiados que têm acesso a essas APIs privilegiadas pode ser especificada no pacote de metadados de serviço no elemento PrivilegedApplications . Aplicativos privilegiados podem ser aplicativos de depuração ou teste; eles não precisam ser distribuídos por meio da Microsoft Store.

Estrutura do Pacote de Metadados de Serviço

Os componentes de um pacote de metadados de serviço são armazenados em um arquivo de gabinete compactado e devem ter uma extensão de arquivo . devicemetadata-ms. Os pacotes de metadados de serviço usam essa extensão de arquivo porque usam a mesma plataforma subjacente que os pacotes de metadados do dispositivo. Antes de criar o arquivo .devicemetadata-ms , primeiro você deve criar um GUID (identificador global exclusivo) para o pacote de metadados. Em seguida, você deve usar a seguinte convenção de nomenclatura ao criar o arquivo .devicemetadata-ms: <GUID.devicemetadata-ms>.

Nota Embora a extensão de arquivo usual de um arquivo de gabinete seja .cab, a extensão de arquivo para um arquivo de pacote de metadados de serviço deve ser .devicemetadata-ms. Isso se destina a sublinhar o fato de que os usuários finais não devem descompactar ou modificar esses pacotes.

Há dois tipos de pacotes de metadados de serviço: um único pacote de metadados de serviço de localidade e um pacote de metadados de serviço de várias localidades.

Pacote de metadados de serviço de localidade única

Os recursos localizáveis no pacote de metadados de serviço são o nome do operador que aparece no Windows Gerenciador de Conexões e o ícone de serviço que aparece ao lado dele. Se você não precisar localizar seu nome ou alterar o ícone com base nas informações de localidade do computador, crie um único pacote de metadados de serviço de localidade. Independentemente da localidade que o usuário está usando no computador, ele obterá o nome do operador e o ícone de serviço definidos no pacote de metadados de serviço de localidade única.

Um único pacote de metadados de serviço de localidade deve ter a seguinte estrutura de arquivos:

Algumas considerações para um único pacote de metadados de localidade:

• O arquivo de ícone pode ter qualquer nome de arquivo. No entanto, os documentos XML individuais devem ser nomeados PackageInfo.xml, ServiceInfo.xml, WindowsInfo.xmle SoftwareInfo.xml.

• O nome do arquivo MobileBroadbandInfo.xml é definido no ServiceInfo.xml. Você deve usar os nomes listados neste documento para esse arquivo.

• O arquivo .devicemetadata-ms não pode incluir "{" ou "}" no nome. O GUID para cada nome de arquivo do pacote de metadados deve ser exclusivo. Ao criar um pacote de metadados de serviço novo ou revisado, você deve criar um novo GUID, mesmo que as alterações sejam secundárias.

• O Windows reconhece pacotes de metadados de serviço com uma extensão de arquivo . devicemetadata-ms.

Estrutura de pacote de metadados de serviço de várias localidades

Um pacote de metadados de serviço dá suporte a vários arquivos de localidade em um pacote. Se você der suporte a mais de uma localidade para seu serviço, poderá colocar vários arquivos de localidade em um pacote de metadados de serviço.

Você pode usar um pacote de metadados de serviço local múltiplo se quiser mostrar um nome localizado para seu serviço na lista de rede do Windows Gerenciador de Conexões ou para mostrar um logotipo diferente no Windows Gerenciador de Conexões para sua rede. O Windows exibirá o nome e o logotipo da rede localizados com base no idioma preferencial do sistema, que geralmente é configurado durante a Instalação do Windows. Mesmo que o idioma do usuário atual seja diferente do idioma preferencial do sistema, o ícone e o nome da rede sempre aparecerão no idioma preferencial do sistema. Se o pacote de metadados de serviço não incluir uma localidade, a descrição neutra da linguagem da raiz do pacote de metadados de serviço será exibida. Para a maioria dos usuários, seu idioma corresponderá ao idioma preferencial do sistema.

Um pacote de metadados de serviço de localidade múltipla deve ter a seguinte estrutura de arquivos:

Algumas considerações para um pacote de metadados de várias localidades:

• Crie uma pasta de nome de localidade em cada pasta e coloque o arquivo XML ou o arquivo relevante na pasta nome da localidade.

• Você ainda deve ter o arquivo XML de nível superior e arquivos relevantes, como o arquivo de ícone, no nível superior de cada pasta. Isso fornece um mecanismo de fallback quando a localidade não está incluída no pacote de metadados do serviço.

• Verifique se todos os arquivos necessários e os campos dentro desses arquivos estão completamente preenchidos dentro de cada pasta específica da localidade que você criar. Isso é além do conteúdo no nível superior de cada pasta. Por exemplo, o elemento ServiceNumber no ServiceInfo.xml deve ser preenchido e duplicado na pasta de nível superior e em cada pasta específica de localidade que você criar. Não fazer isso causará erros.

• O documento XML SoftwareInformation não dá suporte a várias localidades porque você não pode especificar arquivos de SoftwareInfo.xml diferentes por localidade.

Envio e manutenção de metadados de serviço

Para obter mais informações sobre como enviar pacotes de metadados de serviço para o Painel do Centro de Desenvolvimento do Windows – Hardware, consulte Guia do desenvolvedor para criar metadados de serviço.

É importante manter os pacotes de metadados atualizados em termos de como eles são descritos e quais valores IMSI e ICCID ou nome do provedor CDMA ou SID eles correspondem. Isso pode exigir que um MNO ou MVNO implemente um novo fluxo de trabalho que faça parte do SIM ou da aquisição de dispositivos para acompanhar novos pedidos de SIMs e o MNO ou MVNO ao qual esses ICCIDs ou IMSIs estão sendo fornecidos.

É uma prática recomendada evitar fazer alterações frequentes nos metadados de serviço reservando intervalos ICCID ou IMSI (ou CDMA SIM/Nome do provedor) para o MNO e o MVNO com antecedência, para que, quando novos SIMs (ou dispositivos CDMA) forem adquiridos, eles já sejam contabilizados em seu pacote de metadados de serviço.

Se você precisar atualizar os identificadores de serviço registrados no dashboard de hardware do Centro de Desenvolvimento do Windows, confira Atualizações de propriedade do identificador de serviço.

As atualizações de metadados são aplicadas silenciosamente com base na lógica interna do Windows (normalmente a cada oito dias) quando o Windows consulta o WMIS se ele tem atualizações de metadados atualizadas.

O aplicativo deve ser projetado para lidar com uma versão anterior dos metadados aos quais ele se refere, até que os metadados mais recentes sejam aplicados ao sistema.

Projetar a experiência do usuário de um aplicativo de banda larga móvel fornece diretrizes sobre como projetar a experiência do usuário para resolver casos de erro comuns, como quando o dispositivo está ausente ou não é reconhecido.