Commissioning API を使用するアプリのコミッショニング フローは、アプリ内で直接開始する方法と、Fast Pair プロセスのアプリ選択ツールから開始する方法の 2 つがあります。このセクションでは、それぞれのユーザー エクスペリエンス（UX）について説明します。
アプリによって開始された場合
このシナリオでは、ユーザーは通常「デバイスを追加」の行動を促すフレーズ（CTA）からアプリでコミッショニングを開始します。次のように「デバイスを追加」ボタンを目立たせることをおすすめします。
- [コントロール] ページなど、ユーザーがすべてのデバイスを確認できる場所
- ユーザーが家を管理できる場所（[設定] ページなど）
- アプリの [ホーム] ページ
コミッショニングが完了したら、アプリのホームページ、または設定したデバイス コントローラを表示するアプリ内の場所、または設定したデバイスを含むすべてのデバイスの完全なリストを表示するアプリ内の場所にユーザーを誘導することをおすすめします。
図 2 に UX を示します。
アプリのユーザーが [デバイスを追加] をクリックします。
お客様が QR コードをスキャンするか、ペア設定コードを入力します。
デバイスを Google ファブリックに追加することに同意し（図 1 の「同意 + メタデータ」に相当）、使用する Google アカウントを選択するようユーザーに求めるプロンプトが表示されます。
ユーザーが複数のホームを持っている場合は、ホームを選択するよう求められます。ホームが設定されていない場合は、「ホーム」という名前のホームが自動的に作成されます。
Commissioning API がデバイスに接続します。
デバイスが設置されている部屋を選択するよう求めるメッセージが表示されます。
デバイスの名前を変更するよう求めるメッセージが表示されます。
Commissioning API は Matter 認証情報を生成し、ネットワーク接続を確認してから、コミッショニング プロセスを実行して、デバイスを選択したファブリックに接続します。
ユーザーのストラクチャとデバイスへの権限がすでに付与されている場合、デバイスは、その家の他のデバイスとともに [ホーム] に表示され、アプリを使用して制御できます。
ユーザーの家とデバイスへの権限がまだ付与されていない場合、アプリでデバイスを表示したり操作したりすることはできません。アプリでデバイスにアクセスして操作するには、 権限が必要です。
ファスト ペアリングによって開始された
コミッショニングは、Android のファスト ペアリングを使用して開始することもできます。デバイスの Matter QR コードをスキャンすると、コミッショニング プロセスを続行するためのアプリを選択するよう求めるメッセージが表示されます。アプリを選択すると、図 3 に示すように、アプリの Commissioning API が使用されます。
ユーザーのモバイル デバイスにアプリがインストールされていない場合は、続行する前にインストールするよう求められます。同意画面以降の UX は図 2 と同じです。
QR コードをスキャンするよう求めるメッセージが表示されます。
お客様がデバイスの Matter QR コードをスキャンします。
コミッショニング プロセスを続行するために、アプリを選択するよう求められます。
アプリがまだインストールされていない場合は、インストールするよう求めるメッセージが表示されます。
アプリが Google Play ストアからダウンロードされます。
アプリがインストールされています。
アプリが正常にインストールされると、ユーザーに続行を求めるメッセージが表示されます。
デバイスを Google ファブリックに追加することに同意し（図 1 の「同意 + メタデータ」に相当）、使用する Google アカウントを選択するようユーザーに求めるプロンプトが表示されます。
ユーザーが複数のホームを持っている場合は、ホームを選択するよう求められます。ホームが設定されていない場合は、「ホーム」という名前のホームが自動的に作成されます。
Commissioning API がデバイスに接続します。
デバイスが設置されている部屋を選択するよう求めるメッセージが表示されます。
デバイスの名前を変更するよう求めるメッセージが表示されます。
Commissioning API は Matter 認証情報を生成し、ネットワーク接続を確認してから、コミッショニング プロセスを実行して、デバイスを選択したファブリックに接続します。
ユーザーのストラクチャとデバイスへの権限がすでに付与されている場合、デバイスは Google Home の他のデバイスとともに表示され、アプリを使用して操作できます。
ユーザーの家とデバイスへの権限がまだ付与されていない場合、アプリでデバイスを表示したり操作したりすることはできません。アプリでデバイスにアクセスして操作するには、 権限が必要です。
アプリ選択ツール
コミッショニング プロセス中にアプリ選択ツールにアプリが表示される方法は 2 つあります。
- [アプリを選択] 画面。
- ユーザーが [別のアプリを選択] を選択すると、[インストール済みの他のアプリ] 画面に表示されます。
候補アプリ
アプリ選択ツールに 2 つのおすすめアプリが表示されています。
- 最初の列は常に Google Home app (GHA) です。
- 2 つ目は、デバイスの VID または PID に関連付けられた Google Home Developer Console プロジェクトで定義されている場合、デバイス メーカーの優先アプリ用です（このオプションは、Matter デバイスをビルドしないアプリ デベロッパーには適用されません）。
アプリが [アプリを選択] 画面に表示されるシナリオは 2 つあります。
- インストール済み - Google Play services アプリが
ACTION_COMMISSION_DEVICEインテント フィルタをサポートしていることを確認します。インテント フィルタがない場合、ユーザーは Play ストアにリダイレクトされ、アプリを更新します。 - インストールされていない - 続行する前に、アプリをインストールするために Google Play ストアにリダイレクトされます。