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