Commissioning API を使用したアプリのコミッショニング フローは、アプリ内で直接開始する方法と、Fast Pair プロセスでアプリ選択ツールを使用して開始する方法の 2 つがあります。このセクションでは、それぞれのユーザー エクスペリエンス（UX）について説明します。
アプリから開始
このシナリオでは、ユーザーはアプリでコミッショニングを開始します。通常は、[デバイスを追加] の行動を促すフレーズ（CTA）から開始します。[デバイスを追加] ボタンは次のように表示することをおすすめします。
- [操作] ページなど、ユーザーがすべてのデバイスを確認できる場所
- [設定] ページなど、ユーザーが家を管理できる場所
- アプリの[ホーム] ページ
コミッショニングが完了したら、アプリの [ホームページ] にユーザーを誘導することをおすすめします。または、セットアップしたデバイス コントローラを表示するアプリ内の場所に誘導するか、セットアップしたデバイスを含むすべてのデバイスの完全なリストを表示する場所に誘導することをおすすめします。
UX を図 2 に示します。
アプリのユーザーが [デバイスを追加] をクリックします。
ユーザーが 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 認証情報を作成し、ネットワーク接続を確認してから、コミッショニング プロセスを実行して、デバイスを選択したファブリックに接続します。
ユーザーの構造とデバイスへの権限がすでに付与されている場合、デバイスはその家の他のデバイスとともに [ホーム] に表示され、アプリを使用して操作できます。
ユーザーの構造とデバイスへの権限がまだ付与されていない場合、デバイスはアプリに表示されず、操作もできません。 アプリでデバイスにアクセスして操作するには、権限が必要です。
アプリ選択ツール
コミッショニング プロセス中にアプリ選択ツールにアプリが表示される方法は 2 つあります。
- [アプリを選択] 画面に表示されます。
- ユーザーが [他のアプリを選択] を選択すると、[インストールされている他のアプリ] 画面に表示されます。
おすすめのアプリ
アプリ選択ツールには、おすすめのアプリが 2 つ表示されます。
- 1 つ目は常に Google Home app (GHA) です。
- 2 つ目は、デバイスの VID または PID に関連付けられた
Google Home Developer Consoleプロジェクトで定義されている場合、
デバイス メーカーが推奨するアプリです。（このオプションは、デバイスを構築しないアプリ デベロッパーには適用されません）。
Matter
アプリが [アプリを選択] 画面に表示されるシナリオは 2 つあります。
- インストール済み - Google Play services アプリケーションが
ACTION_COMMISSION_DEVICEインテント フィルタをサポートしていることを確認します。インテント フィルタがない場合、ユーザーは Play ストアにリダイレクトされ、アプリのアップデートを促されます。 - 未インストール - 続行する前に、ユーザーは Play ストアにリダイレクトされ、アプリをインストールするよう求められます。