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