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