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

Sample App for Matter Codelab に移動する

前提条件

コミッションにハブ（Google Nest Hub (2nd gen) など）は必要ありません Sample App for Matter でデバイスを操作できるようになりました。

インストール

  1. [リリース] に移動します。 Sample App for Matter GitHub できます。最新リリースは [アセット] セクションにあります この APK ファイルの名前が GHSAFM-version-default-debug.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 ファブリックは、デバイス間で共有される信頼ドメインです 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 つの方法でデバイスを共有できます。

  1. セットアップ コードを使用して手動で、ターゲット コミッショナー アプリと共有
  2. ID として登録されているローカル Android アプリの場合、 Matter 人の理事

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

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

設定

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

設定

ハーフシートの通知

[設定] 画面で、プロアクティブなコミッション取引を無効にすることができます。 Matter 台のデバイスの検出通知。

アプリが独自の Matter ディスカバリを提供するか、 通知を受け取らずに済み、特定の状況で利用できる できます。コミッション対象の検出を抑制する 通知 をご覧ください。

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

[設定] 画面から [デベロッパー ユーティリティ] にアクセスすることもできます。

Device and User Preferences DataStore リポジトリのコンテンツを確認する Logcat で、次の手順を完了します。

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

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

フィードバックやご質問

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

フィードバックの送信

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

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

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

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