Android の Commissioning API は、Matter のマルチアドミン （複数管理者）をサポートしています。つまり、 Commissioning API はプライマリまたは セカンダリの Matter コミッショナーとして機能し、独自の コミッショナーを追加できます。Matter
プライマリの Matter コミッショナーとして:
- このモードでは、Google UX を使用して Google ファブリックが最初に追加されます。
- カスタム コミッショナーを追加できます。
- Google ファブリックがデバイスに追加された後、コミッショナーが呼び出され、Matter コミッショニング ウィンドウが再度開きます。
- Google が何らかの理由で最初に独自のファブリックへのコミッショニングを完了できない場合、カスタム コミッショニング サービスは実行されません。
セカンダリの Matter コミッショナーとして:
- このモードでは、独自のコミッショニング UX を実装して、独自のファブリック（または他のファブリック）にオンボーディングできます。
- Google Commissioning API は、コミッショニング ウィンドウが開いているときに後で呼び出して、Google ファブリックを追加できます。このモードでは、エンドユーザーが Home API の使用権限を付与している場合、コミッショニング フローが完了した後、アプリで Google のファブリックを追加するよう（Commissioning API を使用して）ユーザーに積極的に促すことを強くおすすめします。
Commissioning API をプライマリの Matter コミッショナーとして使用する方法
次の手順は、Google が推奨する Matter フル機能のコミッショニング フローを示しています。
ユーザーがアプリでコミッショニング フローを開始します。たとえば、[デバイスを追加] というラベルのボタンをタップします。
Google UX が制御を引き継ぎ、 [Matter QR コード] 画面が表示されます。 ユーザーは QR コードをスキャンして設定プロセスを開始できます。
[このデバイスを Google アカウントに接続] 画面で、ユーザーが [同意する] をタップして、デバイスを Google エコシステムに追加します。この画面でユーザーが [キャンセル] をタップすると、デバイスのコミッショニングはすべて直ちに終了します。
[家を選択] 画面で、ユーザーはデバイスを制御できる家を選択します。家がない場合は、新しい家が作成されます。 家の中に適切なハブが見つからない場合や、ユーザーに権限がない場合は、コミッショニング プロセスが終了します。
次に [デバイスが接続されました] 画面が表示され、 Matter セットアップ プロセスが開始されます。ユーザーはこの画面で部屋とデバイス名を選択できます。
デバイスが Matter ファブリックにオンボーディングされると、[**デバイスを準備中**] 画面が表示されます。
アプリが制御を再開し、カスタム コミッショナーが登録されている場合は、ここで実行されます。
Commissioning API をセカンダリの Matter コミッショナーとして使用する方法
次の手順は、Matter コミッショニング プロセスが Google のコミッショニング プロセスよりも前に実行される Matter のコミッショニング フローを示しています。
ユーザーがアプリでコミッショニング フローを開始します。たとえば、[デバイスを追加] をタップします。
コミッショニング UX プロセスが実行され、デバイスがファブリックに追加されます。
完了したら、ユーザーに関する知識に基づいて、後続の動作を指定できます。たとえば、ユーザーが Google Home API をオプトインしている場合、Google へのコミッショニングを希望している可能性が高いため、コミッショニング プロセスをトリガーできます。
プロセスで Commissioning API を呼び出し、パスコード、識別子、その他の利用可能な情報を含むペイロードを指定します。
Google のコミッショニング プロセスにより、デバイスが Google ファブリックに追加されます。