サービス メタデータの概要

MBAE 非推奨に関する警告

サービス メタデータ パッケージを作成して送信して、Windows と深く統合されたエクスペリエンスを作成できます。 Windows は、オペレーターのサービス メタデータ パッケージに一致するモバイル ブロードバンド ハードウェアを検出すると、サービス メタデータと指定されたモバイル ブロードバンド アプリを自動的にダウンロードします。

サービス メタデータには、次のようなサービスを説明する情報が含まれています。

• サービス プロバイダーの名前

• 1 つ以上のサービス カテゴリ

• モバイル ブロードバンド固有の情報

• モバイル ブロードバンド アプリ

• MobileBroadbandProfiles

• XML をプロビジョニングするための信頼された証明書

• DeviceNotificationHandler 要素

• PrivilegedApplications 要素

メタデータの情報は、Windows 8、Windows 8.1、および Windows 10 のユーザー エクスペリエンスの側面をカスタマイズし、モバイル ブロードバンド アプリ (以前はモバイル オペレーター アプリと呼ばれる) との統合を提供するために使用されます。

サービス メタデータ パッケージは、.devicemetadata-ms ファイル内に格納された複数の XML ドキュメントで構成されます。 各ドキュメントは、サービスの属性のさまざまなコンポーネントを指定します。 これらの XML ドキュメントは、Windows 接続マネージャーに、ユーザーに表示されるカスタマイズとネットワーク構成情報を提供します。

サービス メタデータ パッケージ内の XML ドキュメントのリファレンス情報については、「サービス メタデータ パッケージスキーマリファレンス」を参照してください。

サービス メタデータの内容

次の概要では、サービス メタデータ パッケージ内に格納および定義されている最も興味深いフィールドの一部について説明します。

• ハードウェア ID
  GSM ネットワークの場合は、サービス メタデータ パッケージが一致する IMSI または ICCID 範囲を記述するメタデータ パッケージを送信できます。 MVNO の場合は、MNO からリースした IMSI または SIM ICC ID の 1 つ以上の範囲を指定できます。 CDMA ネットワークの場合は、プロバイダー ID (SID/NID) またはプロバイダー名を使用してパッケージを送信できます。 ハードウェア ID は、サービス メタデータ パッケージ スキーマの HardwareID 要素に対応します。 MNO および MVNO シナリオのハードウェア識別 (HWID) 範囲を計画する方法の詳細については、「MVNO のエクスペリエンスの提供」を参照してください 。

• ServiceNumber
  モバイル ブロードバンド サービス プロバイダーの一意の ID。 この GUID は、アカウント プロビジョニング メタデータを使用するときにオペレーターを識別するためにも使用されます。 デバイス メタデータ パッケージを更新する場合、この GUID は不変である必要があります。 サービス番号は、サービス メタデータ パッケージ スキーマの ServiceNumber 要素に対応します。

• オペレーターのロゴ ネットワーク エントリの横にある Windows 接続マネージャーに表示されるカスタム ロゴ。 (ユーザーがローミング ネットワーク上にある場合、ロゴは非表示になります)。演算子のロゴは、 サービス メタデータ パッケージ スキーマの ServiceIconFile 要素に対応します。 ロゴの要件の詳細については、「サービス アイコンの要件」を参照してください。

  重要

  Windows 10 バージョン 1709 以降では、このフィールドは COSA によるブランド化に置き換えられました。 ブランド化のための COSA のフィールドについては、 デスクトップ COSA/APN データベース送信の計画に関するページを参照してください。 Windows 10 バージョン 1709 より前のバージョンの Windows を対象としている場合でも、このセクションで説明するようにメタデータ パッケージを作成します。 COSA の詳細については、「COSA の概要」を参照してください。

• モバイル ブロードバンド アプリ
  自動的にダウンロードされ、コンピューターに適用される UWP デバイス アプリ。 このアプリは、プランの購入、データの使用状況、ヘルプとサポートなどの主要なエクスペリエンスを提供し、付加価値サービスを強調することができます。

• MB購入プロファイル
  サブスクリプションを購入するための制限付き接続を確立するために使用される購入プロファイル。

  すべてのサブスクライバーに対して 1 つの購入 APN しか持っていない GSM オペレーターの場合は、サービス メタデータを使用してコンピューターにプロビジョニングできます。 複数の購入 APN がある場合は、アカウント プロビジョニング メタデータを使用して、適切な購入 APN を設定する必要があります。 または、何も実行せず、APN データベースに格納されているエントリを使用して APN 接続情報を提供することもできます。

• MB インターネット プロファイル
  すべてのモバイル ブロードバンド サブスクリプションは、ホーム ネットワーク オペレーターへの接続に使用される既定のプロファイルを 1 つ持つことができます。 Windows 接続マネージャーは、ネットワークへの自動接続にこのプロファイルを使用します。

  すべてのサブスクライバーに対して 1 つのインターネット APN しか持っていない GSM オペレーターの場合は、サービス メタデータを使用してコンピューターにプロビジョニングできます。 複数のインターネット APN がある場合は、アカウント プロビジョニング メタデータを使用して、適切なインターネット APN を設定する必要があります。 または、何も実行せず、APN データベースに格納されているエントリを使用して APN 接続情報を提供することもできます。

• 証明書データ
  プロビジョニングに使用される証明書情報。 これには、証明書発行者名とサブジェクト名が含まれます。 この情報は、Web サイトによって開始されたアカウント プロビジョニング操作が信頼できるオペレーターによって発行されるようにするために使用されます。

• カスタム演算子名
  モバイル ブロードバンド デバイスは、通常、Windows 接続マネージャーで Windows に表示されるオペレーター名を提供します。 メタデータでカスタム名を指定することで、この名前をオーバーライドできます。 この名前は、ユーザーがホーム ネットワーク上にあり、ローミング ネットワーク上にない場合にのみ表示されます。 表示されるローミング ネットワーク名は、デバイスから受信した情報に基づいています。 これは、サービス パッケージ メタデータ スキーマの ServiceProvider 要素に対応します。

  重要

  Windows 10、バージョン 1709 以降では、このフィールドは COSA によるブランド化に置き換えられました。 ブランド化のための COSA のフィールドについては、 デスクトップ COSA/APN データベース送信の計画に関するページを参照してください。 Windows 10、バージョン 1709 より前のバージョンの Windows を対象としている場合でも、このセクションで説明するようにメタデータ パッケージを作成します。 COSA の詳細については、「COSA の概要」を参照してください。

• DeviceNotificationHandler
  一般に、システム イベント ブローカーに作業項目を登録するには、少なくとも 1 回はアプリを実行する必要があります。 ただし、モバイル ブロードバンド アプリでは、ユーザーがアプリを実行する前に重要なイベントを受け取る必要がある場合があります。 サービス メタデータで DeviceNotificationHandler 要素を指定できます。この要素は、Windows が重要なイベントの登録に使用します。 SMS 通知の詳細については、「MVNO のエクスペリエンスを提供する」を参照してください。

• モバイル ブロードバンド制限付きインターフェイスにアクセスできる特権アプリの一覧
  モバイル ブロードバンド API とインターフェイス (アカウント プロビジョニングや SMS を含む) は制限されており、モバイル ブロードバンド アプリでのみ使用できます。 これらの特権 API にアクセスできる特権アプリの一覧は、 PrivilegedApplications 要素のサービス メタデータ パッケージで指定できます。 特権アプリは、アプリのデバッグやテストを行うことができます。Microsoft Store を通じて配布する必要はありません。

サービス メタデータ パッケージ構造体

サービス メタデータ パッケージのコンポーネントは圧縮キャビネット ファイルに格納され、ファイル拡張子 は .devicemetadata-ms である必要があります。 サービス メタデータ パッケージは、デバイス メタデータ パッケージと同じ基になるプラットフォームを使用するため、このファイル拡張子を使用します。 .devicemetadata-ms ファイルを作成する前に、まずメタデータ パッケージのグローバル一意識別子 (GUID) を作成する必要があります。 次に、.devicemetadata-ms ファイルを作成するときに、 <GUID>.devicemetadata-msという名前付け規則を使用する必要があります。

注 キャビネット ファイルの通常のファイル拡張子は .cabされていますが、サービス メタデータ パッケージ ファイルのファイル拡張子は .devicemetadata-msである必要があります。 これは、エンドユーザーがこれらのパッケージを展開または変更してはならないという事実を強調するためのものです。

サービス メタデータ パッケージには、1 つのロケール サービス メタデータ パッケージと複数のロケール サービス メタデータ パッケージの 2 種類があります。

単一ロケール サービス メタデータ パッケージ

サービス メタデータ パッケージ内のローカライズ可能なリソースは、Windows 接続マネージャーに表示されるオペレーター名と、その横に表示されるサービス アイコンです。 PC からのロケール情報に基づいて名前をローカライズしたりアイコンを変更したりする必要がない場合は、1 つのロケール サービス メタデータ パッケージを作成します。 ユーザーが PC で使用しているロケールに関係なく、1 つのロケール サービス メタデータ パッケージで定義されているオペレーター名とサービス アイコンが取得されます。

1 つのロケール サービス メタデータ パッケージには、次のファイル構造が必要です。

1 つのロケール メタデータ パッケージに関するいくつかの考慮事項:

• アイコン ファイルには任意のファイル名を指定できます。 ただし、個々の XML ドキュメントには、 PackageInfo.xml、 ServiceInfo.xml、 WindowsInfo.xml、および SoftwareInfo.xmlという名前を付ける必要があります。

• MobileBroadbandInfo.xml ファイルの名前は、 ServiceInfo.xmlで定義されます。 このドキュメントに記載されている名前は、そのファイルに使用する必要があります。

• .devicemetadata-ms ファイルの名前に "{" または "}" を含めることはできません。 各メタデータ パッケージ ファイル名の GUID は一意である必要があります。 新しいサービスまたは変更されたサービスを作成する場合は、些細な変更であっても、新しい GUID を作成する必要があります。

• Windows は、ファイル拡張子が .devicemetadata-msの サービス メタデータ パッケージを認識します。

複数ロケール サービス メタデータ パッケージの構造

サービス メタデータ パッケージは、1 つのパッケージ内の複数のロケール ファイルをサポートします。 サービスで複数のロケールをサポートしている場合は、複数のロケール ファイルを 1 つのサービス メタデータ パッケージに配置できます。

Windows 接続マネージャー ネットワーク リストにサービスのローカライズされた名前を表示する場合、またはネットワークの Windows 接続マネージャーに別のロゴを表示する場合は、複数のローカル サービス メタデータ パッケージを使用できます。 Windows では、通常は Windows セットアップ時に構成される、システム優先言語に基づいてローカライズされたネットワーク名とロゴが表示されます。 現在のユーザーの言語がシステム優先言語と異なる場合でも、アイコンとネットワーク名は常にシステム優先言語で表示されます。 サービス メタデータ パッケージにロケールが含まれていない場合は、サービス メタデータ パッケージのルートからの言語に依存しない説明が表示されます。 ほとんどのユーザーの言語は、システムの優先言語と一致します。

複数のロケール サービス メタデータ パッケージには、次のファイル構造が必要です。

複数ロケール メタデータ パッケージに関するいくつかの考慮事項:

• 各フォルダーにロケール名フォルダーを作成し、XML ファイルまたは関連ファイルをロケール名フォルダーに配置します。

• 各フォルダーの最上位レベルの XML ファイルと関連ファイル (アイコン ファイルなど) は引き続き必要です。 これにより、ロケールがサービス メタデータ パッケージに含まれていない場合のフォールバック メカニズムが提供されます。

• 必要なすべてのファイルとそれらのファイル内のフィールドが、作成するロケール固有の各フォルダー内に完全に入力されていることを確認します。 これは、各フォルダーの最上位レベルのコンテンツに加えて行われます。 たとえば、 ServiceInfo.xmlの ServiceNumber 要素は、最上位フォルダーと、作成するすべてのロケール固有のフォルダーに入力して複製する必要があります。 これをしないと、エラーが発生します。

• SoftwareInformation XML ドキュメントは、ロケールごとに異なるSoftwareInfo.xml ファイルを指定できないため、複数のロケールをサポートしていません。

サービス メタデータの送信とメンテナンス

Windows デベロッパー センター ダッシュボード – ハードウェアにサービス メタデータ パッケージを送信する方法の詳細については、 サービス メタデータを作成するための開発者ガイドを参照してください。

メタデータ パッケージの記述方法と、それらが一致する IMSI および ICCID または CDMA プロバイダー名または SID 値の観点から、メタデータ パッケージを最新の状態に保つことが重要です。 これには、SIM またはデバイスの取得の一部である新しいワークフローを実装するために MNO または MVNO が必要になる場合があります。このワークフローは、SIM またはデバイスの新しい注文を追跡し、それらの ICCID または IMSI が提供されている MNO または MVNO を追跡します。

MNO と MVNO の ICCID または IMSI 範囲 (または CDMA SIM/プロバイダー名) を事前に予約して、サービス メタデータを頻繁に変更しないようにすることをお勧めします。これにより、新しい SIM (または CDMA デバイス) が調達されると、サービス メタデータ パッケージに既にアカウントが割り当てられます。

Windows デベロッパー センター ハードウェア ダッシュボードに登録されているサービス識別子を更新する必要がある場合は、「サービス識別子の所有権の更新」を参照してください。

メタデータの更新は、内部の Windows ロジック (通常は 8 日ごと) に基づいて自動的に適用されます。これは、更新されたメタデータの更新があるかどうかに関して Windows が WMIS にクエリを実行する場合です。

アプリは、最新のメタデータがシステムに適用されるまで、参照先のメタデータの以前のバージョンを処理するように設計する必要があります。

モバイル ブロードバンド アプリのユーザー エクスペリエンスを設計する では、デバイスが見つからない場合や認識されない場合など、一般的なエラー事例に対処するためのユーザー エクスペリエンスを設計する方法に関するガイドラインを提供します。