共用方式為


服務元數據概觀

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 檔的參考資訊,請參閱 服務元數據套件架構參考

服務元數據內容

下列摘要描述服務元資料套件內包含和定義的一些最有趣的欄位:

  • 硬體標識碼
    針對 GSM 網路,您可以提交元數據套件,以描述您想要讓服務元數據套件相符的 IMSI 或 ICCID 範圍。 如果您是MVNO,您可以指定您從 MNO 租用的一或多個 IMSIs 或 SIMIC 識別符範圍。 針對 CDMA 網路,您可以使用提供者識別碼 (SID/NID) 或提供者名稱來提交套件。 硬體標識碼會對應至服務元數據套件架構中的 HardwareID 元素。 如需如何針對 MNO 和 MVNO 案例規劃硬體識別 (HWID) 範圍的詳細資訊,請參閱 為 MVNO 提供體驗

  • 服務號碼
    行動寬頻服務提供者的唯一標識符。 使用帳戶布建元數據時,也會使用此 GUID 來識別操作員。 如果您更新裝置元數據套件,此 GUID 必須維持不變。 服務編號會對應至服務元數據套件架構中的 ServiceNumber 元素。

  • 操作員標誌出現在您網路專案旁的 Windows 連線管理員 自定義標誌。 (當用戶位於漫遊網路時隱藏標誌。) 操作員標誌會對應至服務元數據套件架構中的 ServiceIconFile 元素。 如需標誌需求的詳細資訊,請參閱 服務圖示需求

    重要

    在 Windows 10 1709 版和更新版本中,此字段已由透過 COSA 的商標取代。 COSA 中用於商標的欄位會在 規劃桌面 COSA/APN 資料庫提交中說明。 如果您在 Windows 10 版本 1709 之前以 Windows 版本為目標,您仍會建立元數據套件,如本節所述。 如需 COSA 的詳細資訊,請參閱 COSA 概觀

  • 行動寬頻應用程式
    自動下載並套用至電腦的 UWP 裝置應用程式。 此應用程式可以提供重要體驗,例如方案購買、數據使用量和支援,並可醒目提示增值服務。

  • MB 購買配置檔
    購買配置檔,用於建立購買訂用帳戶的有限連線能力。

    如果您是只有一個購買 APN 給所有訂閱者的 GSM 操作員,您可以使用服務元數據將它佈建到計算機。 如果您有多個購買 APN,您應該使用帳戶布建元數據來設定適當的購買 APN。 或者,您可以執行任何動作,並使用儲存在 APN 資料庫中的專案來提供 APN 連線資訊。

  • MB 因特網配置檔
    每個行動寬頻訂用帳戶都可以有一個預設配置檔,用來連線到家庭網路操作員。 Windows 連線管理員 使用此設定檔自動連線到網路。

    如果您是只有一個因特網 APN 供所有訂閱者使用的 GSM 操作員,您可以使用服務元數據來布建計算機。 如果您有多個因特網 APN,您應該使用帳戶布建元數據來設定適當的因特網 APN。 或者,您可以執行任何動作,並使用儲存在 APN 資料庫中的專案來提供 APN 連線資訊。

  • 憑證資料
    用於布建的憑證資訊。 這包括憑證簽發者名稱和主體名稱。 這項資訊是用來確保網站起始的帳戶布建作業是由受信任的操作員發出。

  • 自定義運算子名稱
    行動寬頻裝置通常會提供操作員名稱,Windows 會在 Windows 連線管理員 中顯示。 您可以在元資料中指定自定義名稱,以覆寫此名稱。 只有當用戶位於家庭網路上且不在漫遊網路上時,才會顯示此名稱。 顯示的漫遊網路名稱是以從裝置接收的資訊為基礎。 這會對應至服務套件元數據架構中的 ServiceProvider 元素。

    重要

    在 Windows 10 版本 1709 和更新版本中,此字段已由透過 COSA 的商標取代。 COSA 中用於商標的欄位會在 規劃桌面 COSA/APN 資料庫提交中說明。 如果您在 Windows 10 版本 1709 之前以 Windows 版本為目標,您仍會建立元數據套件,如本節所述。 如需 COSA 的詳細資訊,請參閱 COSA 概觀

  • 裝置通知處理程式
    一般而言,應用程式至少必須由使用者執行一次,才能向系統事件代理程序註冊工作專案。 不過,行動寬頻應用程式可能需要接收重要事件,使用者才能執行應用程式。 您可以在服務元數據中指定 DeviceNotificationHandler 元素,Windows 將用來註冊一些重大事件。 如需 SMS 通知的詳細資訊,請參閱 傳遞 MVO 體驗

  • 具有行動寬頻限制介面存取權的特殊許可權應用程式清單
    行動寬頻 API 和介面 (包括帳戶布建和 SMS) ,僅限行動寬頻應用程式使用。 您可以在 PrivilegedApplications 元素的服務元資料套件中指定可存取這些特殊許可權 API 的特殊許可權應用程式清單。 特殊許可權應用程式可以是偵錯或測試應用程式;它們不需要透過 Microsoft Store 散發。

服務元數據套件結構

服務元數據套件的元件會儲存在壓縮封包檔案中,且擴展名必須為 .devicemetadata-ms。 服務元數據套件會使用此擴展名,因為它們使用與裝置元數據套件相同的基礎平臺。 建立 .devicemetadata-ms 檔案之前,您必須先建立元數據套件的全域唯一標識符 (GUID) 。 然後,當您建立 .devicemetadata-ms 檔案時,您必須使用下列命名慣例:<GUID.devicemetadata-ms>

注意 雖然封包檔案的一般擴展名 是.cab,但服務元數據套件檔案的擴展名必須是 .devicemetadata-ms。 這是為了強調使用者不得解壓縮或修改這些套件的事實。

服務元數據套件有兩種類型:單一地區設定服務元數據套件和多個地區設定服務元數據套件。

單一地區設定服務元數據套件

服務元數據套件中的可當地語系化資源是出現在 Windows 連線管理員 中的操作員名稱,以及旁邊出現的服務圖示。 如果您不需要根據計算機的地區設定資訊來當地語系化名稱或變更圖示,請建立單一地區設定服務元數據套件。 無論使用者在其計算機上使用何種地區設定,他們都會取得單一地區設定服務元數據套件中定義的操作員名稱和服務圖示。

單一地區設定服務元數據套件必須具有下列檔案結構:

此圖顯示單一地區設定服務元數據套件的檔案結構。

單一地區設定元數據套件的一些考慮:

  • 圖示檔案可以有任何檔名。 不過,個別的 XML 檔案必須命名 為PackageInfo.xmlServiceInfo.xmlWindowsInfo.xmlSoftwareInfo.xml

  • ServiceInfo.xml中定義了 MobileBroadbandInfo.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 或裝置取得一部分的新工作流程,以追蹤所提供之 ICCID 或 IMSI 的新訂單和 MNO 或 MVNO。

最佳做法是保留 (或 CDMA SIM/提供者名稱 (或 CDMA SIM/提供者名稱) ,以避免經常變更您的服務元數據,以便在購買新的 SIM (或 CDMA 裝置) 時,它們已計入您的服務元數據套件中。

如果您需要更新 Windows 開發人員中心硬體儀錶板上註冊的服務標識碼,請參閱 服務標識碼擁有權更新

當 Windows 查詢 WMIS 是否有任何更新的元數據更新時,元數據更新通常會以無訊息方式根據內部 Windows 邏輯) (每隔 8 天套用一次。

應用程式應該設計成處理其所參考的舊版元數據,直到最新的元數據套用至系統為止。

設計行動寬頻應用程式的用戶體驗 ,提供如何設計用戶體驗以解決常見錯誤案例的指導方針,例如裝置遺失或無法辨識時。