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