通过

服务元数据概述

  • 项目

MBAE 弃用警告

重要

从 Windows 10 版本 1803 开始，MBAE 应用体验将替换为 MO UWP 应用。 有关 MO UWP 应用的详细信息，请参阅 UWP 移动宽带应用。

可以创建并提交服务元数据包，以创建与 Windows 深度集成的体验。 当 Windows 检测到与运营商的服务元数据包匹配的移动宽带硬件时，它会自动下载服务元数据和指定的移动宽带应用。

服务元数据包含描述服务的信息，包括以下内容：

元数据中的信息用于自定义Windows 8、Windows 8.1和Windows 10用户体验的各个方面，并提供与移动宽带应用（以前称为移动运营商应用）的集成。

服务元数据包包含存储在 .devicemetadata-ms 文件中的多个 XML 文档。 每个文档指定服务属性的各种组件。 这些 XML 文档为 Windows 连接管理器提供向用户显示的自定义项以及网络配置信息。

有关服务元数据包中 XML 文档的参考信息，请参阅 服务元数据包架构参考。

服务元数据内容

以下摘要介绍了服务元数据包中包含和定义的一些最有趣的字段：

  • 硬件 ID
    对于 GSM 网络，可以提交一个元数据包，用于描述你希望服务元数据包匹配的 IMSI 或 ICCID 范围。 如果你是 MVNO，则可以指定从 MNO 租用的一个或多个 IMSI 或 SIM ICC ID 范围。 对于 CDMA 网络，可以使用提供程序 ID (SID/NID) 或提供程序名称提交包。 硬件 ID 对应于服务元数据包架构中的 HardwareID 元素。 有关如何为 MNO 和 MVNO 方案规划硬件标识 (HWID) 范围的详细信息，请参阅 为 MVNO 提供体验

  • 服务编号
    移动宽带服务提供商的唯一 ID。 使用帐户预配元数据时，此 GUID 还用于标识操作员。 如果更新设备元数据包，此 GUID 必须保持不变。 服务编号对应于服务元数据包架构中的 ServiceNumber 元素。

  • 运算符徽标显示在 Windows 连接管理器网络条目旁边的自定义徽标。 (当用户处于漫游网络时，徽标处于隐藏状态。) 操作员徽标对应于服务元数据包架构中的 ServiceIconFile 元素。 有关徽标要求的详细信息，请参阅 服务图标要求。

    重要

    在 Windows 10 版本 1709 及更高版本中，此字段已替换为通过 COSA 进行品牌打造。 规划桌面 COSA /APN 数据库提交中介绍了 COSA 中用于品牌打造的字段。 如果面向Windows 10版本 1709 之前的 Windows 版本，仍会创建元数据包，如本部分所述。 有关 COSA 的详细信息，请参阅 COSA 概述。

  • 移动宽带应用
    自动下载并应用到计算机的 UWP 设备应用。 此应用可以提供计划购买、数据使用、帮助和支持等关键体验，并可以突出显示增值服务。

  • MB 购买配置文件
    用于建立有限连接以购买订阅的购买配置文件。

    如果你是所有订阅者只有一个“购买接入点”的 GSM 运营商，则可以使用服务元数据将它预配到计算机。 如果有多个购买 APN，则应使用帐户预配元数据来设置相应的购买接入点。 或者，你无需执行任何操作，并使用存储在 APN 数据库中的条目来提供 APN 连接信息。

  • MB Internet 配置文件
    每个移动宽带订阅都可以有一个用于连接到家庭网络运营商的默认配置文件。 Windows 连接管理器使用此配置文件自动连接到网络。

    如果你是所有订阅者只有一个 Internet 接入点的 GSM 运营商，则可以使用服务元数据来预配计算机。 如果有多个 Internet APN，则应使用帐户预配元数据来设置相应的 Internet 接入点。 或者，你无需执行任何操作，并使用存储在 APN 数据库中的条目来提供 APN 连接信息。

  • 证书数据
    用于预配的证书信息。 这包括证书颁发者名称和使用者名称。 此信息用于确保由受信任的操作员发出网站启动的帐户预配操作。

  • 自定义运算符名称
    移动宽带设备通常提供运营商名称，Windows 连接管理器中显示该名称。 可以通过在元数据中指定自定义名称来替代此名称。 仅当用户位于家庭网络上且不在漫游网络上时，才会显示此名称。 显示的漫游网络名称基于从设备接收的信息。 这对应于服务包元数据架构中的 ServiceProvider 元素。

    重要

    在 Windows 10 版本 1709 及更高版本中，此字段已替换为通过 COSA 进行品牌打造。 规划桌面 COSA /APN 数据库提交中介绍了 COSA 中用于品牌打造的字段。 如果面向Windows 10版本 1709 之前的 Windows 版本，仍会创建元数据包，如本部分所述。 有关 COSA 的详细信息，请参阅 COSA 概述。

  • 设备通知处理程序
    通常，应用必须至少由用户运行一次，然后才能向系统事件代理注册工作项。 但是，移动宽带应用可能需要先接收重要事件，然后用户才能运行该应用。 可以在服务元数据中指定 DeviceNotificationHandler 元素，Windows 将使用该元素来注册某些关键事件。 有关短信通知的详细信息，请参阅 为 MVNO 提供体验。

  • 有权访问移动宽带受限接口的特权应用列表
    移动宽带 API 和接口 (（包括帐户预配和短信) ）受到限制，仅适用于移动宽带应用。 可以在 PrivilegedApplications 元素的服务元数据包中指定有权访问这些特权 API 的特权应用列表。 特权应用可以调试或测试应用;不需要通过 Microsoft Store 分发它们。

服务元数据包结构

服务元数据包的组件存储在压缩的 cabinet 文件中，并且必须具有 .devicemetadata-ms 文件扩展名。 服务元数据包使用此文件扩展名，因为它们使用与设备元数据包相同的基础平台。 在创建 .devicemetadata-ms 文件之前，必须先创建元数据包的全局唯一标识符 (GUID) 。 然后，在创建 .devicemetadata-ms 文件时，必须使用以下命名约定：<GUID.devicemetadata-ms>。

注意 尽管 cabinet 文件的常用文件扩展名 .cab，但服务元数据包文件的文件扩展名必须为 .devicemetadata-ms。 这旨在强调最终用户不得解压缩或修改这些包这一事实。

有两种类型的服务元数据包：单区域设置服务元数据包和多区域设置服务元数据包。

单区域设置服务元数据包

服务元数据包中的可本地化资源是 Windows 连接管理器 中显示的运算符名称和旁边显示的服务图标。 如果不需要根据电脑中的区域设置信息本地化名称或更改图标，请创建单个区域设置服务元数据包。 无论用户在电脑上使用什么区域设置，他们都将获得在单个区域设置服务元数据包中定义的操作员名称和服务图标。

单个区域设置服务元数据包必须具有以下文件结构：

显示单个区域设置服务元数据包的文件结构的关系图。

单个区域设置元数据包的一些注意事项：

  • 图标文件可以具有任何文件名。 但是，各个 XML 文档必须 PackageInfo.xml、 ServiceInfo.xml、 WindowsInfo.xml和 SoftwareInfo.xml命名。

  • MobileBroadbandInfo.xml 文件的名称在 ServiceInfo.xml中定义。 你应对该文件使用本文档中列出的名称。

  • .devicemetadata-ms 文件的名称中不能包含“{”或“}”。 每个元数据包文件名的 GUID 必须是唯一的。 创建新的或修改的服务元数据包时，必须创建新的 GUID，即使更改很小。

  • Windows 识别文件扩展名为 .devicemetadata-ms 的服务元数据包。

多区域设置服务元数据包结构

服务元数据包支持一个包中的多个区域设置文件。 如果为服务支持多个区域设置，可以将多个区域设置文件放入一个服务元数据包中。

如果要在 Windows 连接管理器网络列表中显示服务的本地化名称，或者在 Windows 连接管理器中为网络显示不同的徽标，可以使用多个本地服务元数据包。 Windows 将基于系统首选语言（通常在 Windows 安装期间配置）显示本地化的网络名称和徽标。 即使当前用户的语言不同于系统首选语言，图标和网络名称也始终以系统首选语言显示。 如果服务元数据包不包含区域设置，则会显示服务元数据包根目录中的中性语言说明。 对于大多数用户，他们的语言将与系统首选语言匹配。

多区域设置服务元数据包必须具有以下文件结构：

说明多区域设置服务元数据包的文件结构的关系图。

有关多区域设置元数据包的一些注意事项：

  • 在每个文件夹中创建一个区域设置名称文件夹，并将 XML 文件或相关文件放在区域设置名称文件夹中。

  • 你仍然必须在每个文件夹的顶层有顶级 XML 文件和相关文件，如图标文件。 当服务元数据包中未包含区域设置时，这将提供回退机制。

  • 确保在创建的每个特定于区域设置的文件夹中填写所有必需的文件和这些文件中的字段。 这是每个文件夹顶级中的内容的补充。 例如，必须在顶级文件夹和创建的每个特定于区域设置的文件夹中填写和复制 ServiceInfo.xml 中的 ServiceNumber 元素。 否则将导致错误。

  • SoftwareInformation XML 文档不支持多个区域设置，因为不能为每个区域设置指定不同的 SoftwareInfo.xml 文件。

服务元数据提交和维护

有关如何将服务元数据包提交到 Windows 开发人员中心仪表板 - 硬件的详细信息，请参阅 创建服务元数据的开发人员指南。

在描述元数据包的方式以及它们匹配的 IMSI 和 ICCID 或 CDMA 提供程序名称或 SID 值方面保持最新非常重要。 这可能要求 MNO 或 MVNO 实现属于 SIM 或设备购置的一部分的新工作流，以跟踪 SIM 的新订单以及向其提供这些 ICCID 或 IMSI 的 MNO 或 MVNO。

最佳做法是避免对服务元数据进行频繁更改，方法是提前 (或 CDMA SIM/提供程序名称) 保留 MNO 和 MVNO 的 ICCID 或 IMSI 范围，以便在购买新的 SIM (或 CDMA 设备) 时，已在服务元数据包中考虑它们。

如果需要更新在 Windows 开发人员中心硬件仪表板上注册的服务标识符，请参阅服务标识符所有权更新。

元数据更新基于内部 Windows 逻辑 (通常每八天应用一次，) 当 Windows 查询 WMIS 是否有任何更新的元数据更新时。

应用应设计为处理它所引用的元数据的以前版本，直到将最新的元数据应用于系统。

设计移动宽带应用的用户体验 提供了有关如何设计用户体验以解决常见错误情况（例如设备丢失或无法识别）的指南。