このガイドでは、アプリのオンボーディング エクスペリエンスで Google Home APIs のデバイス権限と共有をシームレスに設計するための UX ガイダンスを提供します。
ここで説明する主なトピックは次のとおりです。
Google Home とデバイスを共有するメリット
Home API が提供する機能を利用するには、デバイスを Google Home と共有する必要があります。その理由は次のとおりです。
- これは、Google が自動化でこれらのデバイスを使用する際の技術的な要件です。
- これにより、一貫性があり柔軟な Google Home エクスペリエンスを維持できます。
- ユーザーが基本的なタスクを実行するためにアプリを切り替える必要がある、断片的で混乱するユーザー エクスペリエンスを回避するには、Home API 対応アプリ全体でデバイスが一貫して表示されるようにすることが重要です。
共有フローの主なコンポーネント
コンポーネント | プログラム | 説明 |
---|---|---|
Android の Permissions API | Android の権限に関する Home API | アプリに権限を付与するようユーザーに求めるプロンプト。Home API を使用する前に、ユーザーの家にあるデバイス(API ではストラクチャと呼ばれます)にアクセスする権限をアプリに付与する必要があります。ただし、この手順の順序はデベロッパーのシナリオによって異なり、技術的な実装に記載されています。 |
クラウド間リンク | アカウントのリンクにクラウド間転送を使用する | アプリ内からアカウントのリンクプロセスを開始し、クラウド接続デバイスを Google Home と共有できます。ユーザーの負担を軽減するため、ディープリンク機能(Android と iOS の両方で利用可能)を使用することをおすすめします。これにより、ユーザーは GHA の特定のアカウント リンクページに直接移動できます。 |
Android の Commissioning API | Matter のセットアップ | 一般的には、新しい Matter デバイスを構成するための API と考えられていますが、この API を使用して、すでに別のファブリックに構成されている Matter デバイスに Google ファブリックを追加することもできます。そのため、オンボーディング プロセスに便利なツールです。 |
技術的な実装
共有フローの構築方法は、Google と共有するデバイスによって異なります。
次のシナリオでは、手順を順番に行うことをおすすめします。これにより、ユーザーの全体的なエクスペリエンスが向上します。
Matter デバイスのみを製造している
Google Home にコマンド アシスタントとして委任する Matter 対応デバイスを製造している。
Android の Permissions API を呼び出します。
以前に別のファブリックにコミッショニングされた各 Matter デバイスで Android の Commissioning API を呼び出します。
- Matter の共有はデバイスごとに個別に行う必要があり、ユーザー入力が必要な画面が多数あるため、次の手順でユーザーをガイドすることをおすすめします。
- Google と共有されていない Matter デバイスのリストをユーザーに提供する。
- ユーザーがそのリスト内のデバイスをクリックして、デバイス共有プロセスを開始できるようにします(Commissioning API を使用)。
- Matter デバイスのリストに戻り、タスクの進行状況と共有ステータスをユーザーに表示します。
- Matter の共有はデバイスごとに個別に行う必要があり、ユーザー入力が必要な画面が多数あるため、次の手順でユーザーをガイドすることをおすすめします。
Cloud-to-Cloud API を使用して Google と共有するデバイスのみを製造する
Cloud-to-cloud ディープリンクを実行します。これにより、デバイスが Google Home グラフに追加されます。
- Cloud-to-cloud のリンクを先に行うことをおすすめします。そうすることで、Google と共有されているデバイスと Google と共有されていないデバイスが含まれるリストがユーザーに表示されるなどの混乱を避けることができます。
Android の Permissions API を呼び出します。
Cloud-to-Cloud デバイスと Matter デバイスの両方を製造している
Cloud-to-cloud ディープリンクを実行します。
- Cloud-to-cloud のリンクを先に行うことをおすすめします。そうすることで、Google と共有されているデバイスと Google と共有されていないデバイスが含まれるリストがユーザーに表示されるなどの混乱を避けることができます。
Android の Permissions API を呼び出します。
以前に別のファブリックにコミッショニングされた各 Matter デバイスで Android 用 Commissioning API を呼び出します。
- Matter の共有はデバイスごとに個別に行う必要があり、ユーザー入力が必要な画面が多数あるため、次の手順でユーザーをガイドすることをおすすめします。
- Google と共有されていない Matter デバイスのリストをユーザーに提供する。
- ユーザーがそのリスト内のデバイスをクリックして、デバイス共有プロセスを開始できるようにします(Commissioning API を使用)。
- Matter デバイスのリストに戻り、タスクの進行状況と共有ステータスをユーザーに表示します。
- Matter の共有はデバイスごとに個別に行う必要があり、ユーザー入力が必要な画面が多数あるため、次の手順でユーザーをガイドすることをおすすめします。
Google と共有するデバイスがない
Permissions API を呼び出します。
UX のベスト プラクティス
このセクションでは、Home API を活用するアプリを開発する際に考慮すべき重要なユーザー ジャーニーについて説明します。
アプリでデバイスの共有を導入する場所
このリストはすべてを網羅したものではありません。Google Home の適切な提案や共有をユーザーに提供できる機会は他にもあります。
これらは相互に排他的ではなく、複数のエントリ ポイントがあります。
設定メニューから

ユーザーは設定メニューを使用して Google Home エコシステムとの接続をセットアップすることに慣れているため、この方法では、このパラダイムを継続できます。
デバイスの共有(Cloud-to-cloud リンクと Matter 委任 API)とアプリの権限設定(Permissions API)を分離することをおすすめします。これにより、ユーザーは完了する手順を制御でき、接続ステータスをユーザーに表示できます。
Google が実行する自動化でデバイスを使用する場合
[自動化] タブで、共有フローのエントリ ポイントをタップし、先に進むメリットを明確に説明する価値提案画面を読み、権限フローをすばやく進めることができます。

試運転からのみ
このシナリオは、Matter デバイスのみを製造し(Cloud-to-cloud デバイスなし)、独自の Matter ファブリックを持たないパートナーを対象としています。ユーザーのエントリ ポイントは、Matter デバイスの共有(Commissioning API 経由)とアプリの権限設定(Permissions API 経由)が同じユーザー エクスペリエンス フローの一部である、箱から出した直後の画面のすぐ後に配置できます。

共有ロジック
ユーザー プロンプトに関する推奨事項は次のとおりです。
通常、プラットフォームのオンボーディングに必要な手順のうち、まだ完了していない手順のみを完了するようユーザーにプロンプトを表示する必要があります。たとえば、長年 Google をご利用のお客様は、すでに OEM のデバイスを Google と共有している場合があります。その場合は、Home APIs の権限付与プロセスに沿って、アプリに Google Home へのアクセス権を付与するだけです。
複数の Google Home 管理者が Google Home の構造を共有している場合や、Google とデバイスを共有するために 1 つのアカウントのみが使用されている場合もあります。そのため、Cloud-to-cloud のリンクを完了することが、Home API の権限をリクエストする前提条件になってはいけません。
ビジュアル デザインに関する提案

Google Home へのオンボーディングの明確なメリット(「Google Home を活用した高度な自動化を作成」や「お好みのアプリを使用してデバイスを操作」など)。
行動を促すフレーズ(「使ってみる」など)と、ユーザーが続行しない場合にキャンセルする方法。
スペースに余裕がある場合は、ユーザーが画面を進めていくとどうなるかを説明します。
特に Matter の場合、ユーザーが以前に Home API を介して家へのアクセス権を付与している場合は、新しいデバイスをセットアップするときに、家のデバイスを Google Home と共有できるようにできます。たとえば、Matter デバイスをファブリックに追加し、このデバイスを Google ファブリックに追加するようユーザーにプロンプトを表示できます。
コンテンツの候補
ユーザーは、理解しやすく価値のあるものを信頼しやすくなります。トレードオフなど、十分な情報に基づいて意思決定を行えるように、ユーザーに情報を提供します。
重要な提案
デバイスを共有する明確な価値提案がなければ、ユーザーはデバイスの共有を続行しません。
- 商品の位置づけには特に注意してください。
- 魅力的なものにするが、過度な約束はしない。
- ピッチで説明したデバイスがユーザーに必要である場合は、ユーザーが予期しない障害に直面しないように、そのことを明確に伝えます。
- このようなユーザーを獲得する機会は 1 回しかない可能性があるため、その機会を最大限に活用しましょう。
ベスト プラクティス
- ユーザーの視点から始めます。つまり、「ユーザーにとってのメリット」を重視します。
- セクション ブロックに 4 行を超えるコンテンツを記述しないでください。長すぎると、ユーザーの注意を失う可能性があります。ただし、簡潔であることよりも、わかりやすく、理解しやすいことが重要になる場合があります。
- 自動化は楽しいものです。スペースに余裕がある場合は、魅力的で有益な例を選択します。
- 全体的な戦略に沿っている場合は、遊び心のある声やトーンを試してみてください。
- 「使ってみる」など、アクションを促すフレーズを使用します。