Google Home のサンプルアプリ

Matter 用 Google Home サンプルアプリ

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

  • 物理デバイスと仮想 Matter デバイスをローカル Android ファブリックにコミッショニングする
  • 物理デバイスと仮想デバイスを開発ファブリックにコミッショニングする
  • 開発ファブリックのデバイスを操作する（ライトのオン / オフなど）
  • マルチ管理者機能を使用すると、開発ファブリック上のデバイスを他のアプリと共有でき、逆に、他のアプリから共有される開発ファブリック デバイスに含めることができます。
  • デベロッパー ユーティリティ

このガイドでは、Sample App for Matter APK をインストールし、Matter デバイスの設定、制御、共有に使用する方法について説明します。

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

Sample App for Matter Codelab に移動

前提条件

  • テストに使用できる Android O（8.1、API レベル 27）以降のデバイス。デバイスで最新の Matter がサポートされていることを確認するには、Matter モジュールとサービスの確認ガイドをご覧ください。
  • オン/オフ機能を備えた Matter デバイスを作成します。このサンプルアプリは、仮想デバイスと ESP32 で動作します。

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）をインストールします。

    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 ファブリックは、ホーム ネットワーク内のデバイス間で共有される信頼ドメインであり、デバイス同士の通信を可能にします。

デバイスには、相互に作用するプラットフォーム、アプリ、デバイスのグループに対応する 1 つ以上のファブリックが存在する場合があります。ファブリックには一意の ID があり、デバイスは同じ認証情報と認証局（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 リポジトリのリリース セクションに移動します。最新のリリースの場合は、[アセット] セクションで GHSAFM-version-targetcommissioner-debug.apk という名前の APK を見つけます。default は選択しないでください。

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

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

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

    デバイスの共有

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

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

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

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

次に、外部アプリ（ターゲット コミッショナー）が独自のファブリックへのデバイスのコミッショニングを完了します。

設定

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

設定

ハーフシート通知

[設定] 画面で、Matter デバイスに対してコミッションの対象となる発見の事前通知を無効にすることができます。

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

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

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

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

  1. [リポジトリのコンテンツを記録] をクリックします。

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

フィードバックやご質問

Sample App for Matter の開発エクスペリエンスについてご意見やご提案がございましたら、フィードバック フォームにご記入ください。

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

Sample App for Matter で問題が発生している場合は、次の手順に沿って環境を確認してください。

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

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

コミュニティから技術サポートを受けるには、Stack Overflow で google-smart-home タグを使用します。