Google Home のサンプルアプリ

Matter 用 Google Home サンプルアプリ

Google Home Sample App for Matter は、 Google Home Mobile SDK 次のような Android アプリを作成します。 Google Home app (GHA)。 このサンプルアプリは、次の機能を提供します。

  • Matter の物理デバイスと仮想デバイスをコミッショニング ローカル Android ファブリック
  • 物理デバイスと仮想デバイスを開発ファブリックに委託する
  • 開発ファブリックでデバイスを制御する（例: 弱
  • マルチ管理者機能により、開発ファブリックでデバイスを共有可能 他のアプリとの併用が可能で、逆に開発プロセスや 他のアプリから共有されるファブリック デバイス
  • 開発者ユーティリティ

このガイドでは、Sample App for Matter APK のインストール方法と使用方法について説明します Matter 台のデバイスのコミッショニング、操作、共有を行えます。

ソースコードをダウンロードし、Mobile SDK を統合して Android Studio で画面をカスタマイズする方法については、Sample App for Matter Codelab をご覧ください。

<ph type="x-smartling-placeholder"></ph> Sample App for Matter Codelab に移動する

前提条件

Sample App for Matter でデバイスを構成して制御するために、Google Nest Hub (2nd gen) などのハブは必要ありません。

インストール

  1. [リリース] に移動します。 Sample App for Matter GitHub できます。最新のリリースの場合は、[アセット] セクションで GHSAFM-version-default-debug.apk という名前の APK を見つけます。targetcommissioner は選択しないでください。

  2. Android Debug Bridge（adb）をインストールします。

    <ph type="x-smartling-placeholder"></ph> adb をインストールする

  3. Android デバイスを USB で接続し、[ファイル転送] を有効にして、APK をインストールします。

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

コミッションのデバイス

サンプルアプリを初めて起動すると、次のダイアログが表示されます。 Sample App for Matter Codelab へのリンク [今後このメッセージを表示しない] を選択すると、ダイアログを元に戻すことができます。 いつでも管理できます。

次の手順で、Matter デバイスを ローカルの Android ファブリックと、サンプルにローカルな開発ファブリック 。

Matter ファブリックとは

Matter 用の Google Home サンプルアプリ

Matter ファブリックは、デバイス間で共有される信頼ドメインです 2 台のルーターが相互に通信できる ホームネットワークに配置されます

デバイスには、プラットフォーム、アプリ、またはイベントに対応する 1 つ以上のファブリックが 相互にやり取りする デバイスのグループです生地には、 デバイスは同じ認証情報セットと認証局を共有している （CA）。これらの認証情報は、Matter の構成時に割り当てられます。

Matter デバイスを構成する手順は次のとおりです。

  1. 追加アイコン をタップします コミッショニング プロセスを開始するデバイスボタン。

    デバイスを追加

  2. 次に、制御が Google Play services に転送され、これが起動されます。 Mobile SDK の呼び出しから取得できます。所有権の証明を行うには、[QR コードをスキャン] をタップするか、[ペア設定コードを使用する] をタップします。

    QR コードをスキャン

  3. 構成が完了したら、[デバイス名] を入力し、[完了] をタップします。

これで、デバイスがローカル Android ファブリックと開発ファブリックの両方に接続されました。

デバイスの構成時に、構成作業と関連する画面はすべて Play services によって処理されます。この 一貫したユーザー エクスペリエンスを提供でき、機密情報を扱う （Wi-Fi や Thread の認証情報など）にアクセスできます。

デバイスを操作する

開発ファブリックが認証情報を作成して、 サンプルアプリから Matter デバイスを直接確認できます。

ホーム画面で、デバイスの電源をオンまたはオフに切り替えることができます。デバイスをタップすると、デバイスの詳細にアクセスできます。

デバイスの追加

デバイス共有

デバイスの共有は、Matter 仕様ではマルチ管理フローと呼ばれます。デバイスをサンプルアプリに委任すると、他のエコシステムと簡単に共有できます。

Matter デバイスを他のエコシステムと共有するには: Android デバイスに別のプラットフォームをインストールする必要があります。この外部プラットフォームがターゲット コミッショナーになります。ターゲット コミッショナーとして使用できるサンプルアプリの別のインスタンスを作成しました。

  1. Sample App for Matter GitHub リポジトリの [リリース セクション] に移動します。最新リリースは [アセット] セクションにあります APK の名前が GHSAFM-version-targetcommissioner-debug.apk。default は選択しないでください。

  2. ターゲット コミッショナーをインストールします。

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. ホーム画面でデバイスをタップして、デバイス情報を表示します。[ 共有。

    デバイスの共有

サンプルアプリは Mobile SDK Share API を呼び出し、再度 Play services に制御が移行されます。

共有シートが表示され、デバイスをペア設定するアプリまたはプラットフォームを選択できます。この画面では 2 つの方法で device:

  1. 設定コードを手動で入力して、対象のコミッショナー アプリと共有する
  2. ID として登録されているローカル Android アプリの場合、 Matter 人の理事

ターゲット コミッショナー アプリには「GHSAFM-TC」というラベルが付いています。サンプルアプリのこのインスタンスをタップして、デバイスを共有します。

次に、外部アプリ（ターゲット コミッショナー）が 個別のファブリックに変換できます

設定

ホーム画面で [設定] をクリックします。 アイコンをクリックします。ここでは、ユーザー設定の更新、ヘルプの利用、アプリの詳細の確認を行うことができます。

設定

ハーフシートの通知

設定画面で、Matter デバイスのコミッション対象の検出の通知を事前に無効にできます。

アプリが独自の Matter 検出フローまたは構成フローを提供している場合は、中断を防ぐためにこれらの通知を抑制することをおすすめします。詳細については、コミッション対象の検出通知を抑制するをご覧ください。

デベロッパー ユーティリティ

設定画面から開発者向けユーティリティにもアクセスできます。

Logcat でデバイスとユーザーの設定の DataStore リポジトリの内容を確認する手順は次のとおりです。

  1. [Log repositories content] をクリックします。

  2. ダイアログで [OK] をクリックし、[Logcat] をオンにします。

フィードバックやご質問

開発の改善方法についてご意見やフィードバックを送信する フィードバック フォームにご記入ください。Sample App for Matter

フィードバックを送信する

Sample App for Matter で問題が発生している場合は、次の手順をお試しください。 環境を確認する手順は次のとおりです。

サンプルアプリの使用方法について不明な点がある場合や、コードのバグを見つけた場合は、 GitHub リポジトリの Issue Tracker に問題を送信できます。

技術的な質問について Google から公式ガイダンスを受けるには、スマートホームを使用してください デベロッパー フォーラム:

コミュニティからテクニカル サポートを受けるには、google-smart-home タグを使用してください Stack Overflow: