このガイドでは、アプリケーションのオンボーディング エクスペリエンスで、シームレスな Google Home API のデバイス権限と共有を設計するための UX ガイダンスを提供します。
ここで説明する主なトピックは次のとおりです。
Google Home とデバイスを共有する理由
Home API の機能を利用するには、ユーザーはデバイスを Google Home と共有する必要があります。
- これは、Google がこれらのデバイスを自動化で使用するための技術的な要件です。
- これにより、一貫性のある柔軟な Google Home エクスペリエンスを維持できます。
- Home API 対応アプリ全体でデバイスが一貫して表示されるようにすることは、ユーザーが基本的なタスクを完了するためにアプリ間を移動しなければならない、断片的で混乱を招くユーザー エクスペリエンスを回避するために重要です。
共有フローの主なコンポーネント
| コンポーネント | プログラム | 説明 |
|---|---|---|
| Android の Permissions API | Android での権限に関する Home API | アプリに権限を付与するようユーザーに求める。Home API を使用する前に、アプリはユーザーの家のデバイス（API ではストラクチャと呼ばれます）にアクセスする権限を持っている必要があります。ただし、このステップを実行する順序はデベロッパーのシナリオによって異なり、技術的な実装に含まれます。 |
| クラウド間のリンク | アカウントのリンク用のクラウド間 | アプリ内から Google Home とクラウド接続デバイスを共有するためのアカウント リンク プロセスを開始できます。ユーザーの負担を軽減するため、GHA の特定のアカウント リンク ページにユーザーを直接誘導するディープリンク機能（Android と iOS の両方で利用可能）を使用することをおすすめします。 |
| 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 Graph に追加されます。
- Google と共有されているデバイスと Google と共有されていないデバイスを含むリストがユーザーに表示されるなど、混乱を招く可能性がある状況を回避するため、最初に Cloud-to-cloud のリンクを行うことをおすすめします。
Android の Permissions API を呼び出します。
Cloud-to-cloud デバイスと Matter デバイスの両方を製造している
Cloud-to-cloud ディープリンクを実行します。
- Google と共有されているデバイスと Google と共有されていないデバイスを含むリストがユーザーに表示されるなど、混乱を招く可能性がある状況を回避するため、最初に Cloud-to-cloud のリンクを行うことをおすすめします。
Android の Permissions API を呼び出します。
以前に別のファブリックにコミッショニングされた各 Matter デバイスで Commissioning API for Android を呼び出します。
- Matter の共有はデバイスごとに個別に行う必要があり、ユーザー入力が必要な画面が多数あるため、次の方法でユーザーをこのプロセスに誘導することをおすすめします。
- Google と共有されていない Matter デバイスのリストをユーザーに提供する。
- ユーザーがそのリスト内のデバイスをクリックして、デバイス共有プロセスを開始できるようにする（Commissioning API を使用）。
- Matter デバイスのリストに戻り、タスクの進行状況と共有ステータスをユーザーに表示します。
- Matter の共有はデバイスごとに個別に行う必要があり、ユーザー入力が必要な画面が多数あるため、次の方法でユーザーをこのプロセスに誘導することをおすすめします。
Google と共有するデバイスがありません
Permissions API を呼び出します。
UX のベスト プラクティス
このセクションでは、Home API を活用したアプリを開発する際に考慮すべきクリティカル ユーザー ジャーニーについて説明します。
アプリでデバイス共有を導入する場所
これはすべてを網羅したリストではありません。ユーザーにタイムリーな Google Home の提案と共有エクスペリエンスを提供する機会は他にもあります。
これらは相互に排他的ではなく、複数のエントリ ポイントがあります。
設定メニューから
ユーザーは、設定メニューを使用して Google Home エコシステムとの接続を設定することに慣れている可能性があるため、この方法を使用すると、このパラダイムを継続できます。
デバイスの共有（Cloud-to-cloud のリンクと Matter Commissioning API）を、アプリの権限付与（Permissions API）から分離することをおすすめします。これにより、ユーザーは完了するステップを制御できるようになり、接続ステータスをユーザーに表示できるようになります。
Google が実行する自動化でデバイスを使用する場合
[自動化] タブで、ユーザーは共有フローのエントリ ポイントをタップし、先に進むメリットを明確に説明する価値提案画面を読んでから、権限フローをすばやく進めることができます。
コミッショニングのみ
このシナリオは主に、Matter デバイスのみを製造し（Cloud-to-cloud デバイスは製造しない）、独自の Matter ファブリックを持たないパートナーを対象としています。ユーザーのエントリ ポイントは、初期設定タイプの画面の直後に配置できます。この画面では、Matter デバイスの共有（Commissioning API 経由）とアプリの権限付与（Permissions API 経由）が同じユーザー エクスペリエンス フローの一部として行われます。
共有ロジック
ユーザー プロンプトに関する推奨事項は次のとおりです。
一般的には、プラットフォームのオンボーディングに必要な、完了していないステップのみを完了するようユーザーに促す必要があります。たとえば、長年利用しているお客様は、すでに OEM のデバイスを Google と共有している可能性があります。その場合、アプリに Google Home へのアクセスを許可するには、Home APIs の権限付与プロセスのみを行う必要があります。
複数の Google Home 管理者が Google Home の家のストラクチャを共有している場合、Google とデバイスを共有するために 1 つのアカウントのみが使用されることがあります。そのため、Cloud-to-cloud のリンクを完了することは、Home API の権限をリクエストするための前提条件ではありません。
ビジュアル デザインの提案
Google Home にオンボーディングする明確なメリット（例: 「Google Home を活用した高度な自動化を作成する」、「お好みのアプリを使用してデバイスを操作する」）。
行動を促すフレーズ（「開始」など）と、ユーザーが続行を希望しない場合にキャンセルする方法。
スペースに余裕がある場合は、ユーザーが画面を進めるにつれて何が起こるかの説明。
特に Matter の場合、ユーザーが以前に Home API を介して家にアクセスする権限を付与している場合は、新しいデバイスをコミッショニングするときに、家にあるデバイスを Google Home と共有できるようにすることができます。たとえば、Matter デバイスをファブリックに追加してから、このデバイスを Google ファブリックに追加するようユーザーに求めることができます。
コンテンツの候補
ユーザーは、理解しやすく、価値を付加するものを信頼しやすくなります。トレードオフなど、十分な情報に基づいて意思決定を行うための情報を提供することで、ユーザーを支援します。
重要な提案
デバイスを共有する価値提案が強力でない場合、ユーザーはデバイスの共有を続行しません。
- 提案方法に特に注意を払います。
- 魅力的な内容にする。ただし、過剰な約束はしない。
- 提案で言及しているデバイスがユーザーに必要な場合は、予期しない障害が発生しないように、そのことを明確に記載してください。
- これらのユーザーを獲得する機会は 1 回しかない可能性があるため、この機会を最大限に活用してください。
ベスト プラクティス
- ユーザーの視点から始めます。つまり、「自分にとってどのようなメリットがあるか」というアプローチです。
- セクション ブロックに 4 行を超えるコンテンツを記述しないでください。これより長いと、ユーザーの注意を引くことができない可能性があります。ただし、わかりやすさと理解しやすさは、簡潔であることよりも重要です。
- 自動化は楽しいものです。スペースに余裕がある場合は、興味深く、かつ役立つ例を選択します。
- 全体的な戦略に沿っている場合は、遊び心のあるボイスとトーンを試してみましょう。
- 「使ってみる」など、行動を促すフレーズを使用します。