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 に移動する

前提条件

コミッションにハブ（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）をインストールします。

    <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 ディスカバリを提供するか、 通知を受け取らずに済み、特定の状況で利用できる できます。コミッション対象の検出を抑制する 通知 をご覧ください。

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

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

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

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

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

フィードバックやご質問

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

<ph type="x-smartling-placeholder"></ph> フィードバックの送信

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

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

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

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