Matter クラウドからクラウド Local Home SDK デバイス SDK
Google Home Extension for Visual Studio Code は Google Home Platform のデベロッパー向けに設計、作成されています。この拡張機能により、Google Assistant Simulator、Google Cloud Logging、ホームグラフ ビューアなどのツールにアクセスして、Matter やスマートホームの開発プロセスを簡素化できます。

Google Home 拡張機能の機能
Google アシスタント シミュレータ
スマートホーム デバイスが Google Home エコシステムで正しく動作するかどうかをテストするには、VS Code を離れることなく、いつでも Assistant Simulator を操作できます。
Actions Console に用意されている既存のシミュレータと同様に、Assistant Simulator を使用すると、「ライトをつけて」などのクエリを入力することでデバイスを簡単に制御できます。VS Code 内で、Assistant Simulator はコマンドに基づくテキスト メッセージ(たとえば「わかりました、ライトをつけて」など)で応答します。詳しくは、Google アシスタント シミュレータを使用するをご覧ください。
バッチ発話
Google Home との統合をオートマトンのようにテストするには、発話スクリプトを実行してバッチ発話を Google アシスタント シミュレータに送信できます。詳細については、バッチ音声の実行をご覧ください。
Matter のロギングツール
Matter Logging ツールは、Google Home app (GHA) ログや Google Play 開発者サービス(GMS Core)ログなど、Matter デバッグに関連するすべてのログを収集できます。ログは、VS Code でフィルタ検索とキーワード検索を使用して表示できます。ログは、Android やアプリのバージョンなど、追加のデバッグ情報とともにダウンロードでき、問題を報告するために Google に送信できます。

Cloud Logging
Cloud Logging は、アクションの使用状況に関する分析情報を提供するデバッグ情報と主要指標を提供します。開発を簡素化するため、Google Home Extension では、トラブルシューティング時にコードの横にリアルタイムの Google Cloud Logging メッセージが表示されます。詳細については、Cloud Logging の表示をご覧ください。
ホームグラフ ビューア
ホームグラフ ビューアが Google Home Extension で直接使用できるようになり、VS Code 内のホームグラフでデバイスの状態を確認できるようになりました。詳しくは、ホームグラフを表示してテストを実行するをご覧ください。
VS Code 用 Google Home 拡張機能をインストールする
Google Home Extension をインストールするには、VS Code 内で次の操作を行います。
- アクティビティ バーの拡張機能アイコンをクリックします。
google home
を検索し、[インストール] をクリックします。
Google Home Extension を VS Code Marketplace から直接ダウンロードすることもできます。
Google Home Extension をダウンロードする
VS Code 用 Google Home 拡張機能をセットアップする
Google Home Extension をインストールして VS Code を再読み込みしたら、Assistant Simulator を使用して Cloud Logging を表示する前に、ログインしてプロジェクトを選択する必要があります。
Google でログインしてクラウド プロジェクトを選択します
Google Home Extension からデベロッパー アカウントにログインすると、ユーザーに代わって VS Code が Google サービスと通信できるようになります。
アクティビティ バーの Google Home アイコンをクリックして Google Home Extension を開きます。
[Google でログイン] をクリックして、ブラウザでログインビューを開きます。
スマートホーム デバイスにリンクされているアカウントを選択します。
[Sign in with Google] の認証ページで、[Allow](許可)をクリックします。
ブラウザタブが開き、[Open Visual Studio Code] ダイアログ ボックスが表示されます。[Open Visual Studio Code] をクリックして続行します。
VS Code にリダイレクトされます。そこで、Google Home 拡張機能が URI を開くことを許可する権限が必要です。[開く] をクリックして、ログイン プロセスを終了します。
ログインすると、Google Home Extension によってプロジェクトが読み込まれます。完了したら、[プロジェクトを選択] をクリックします。
表示された [プロジェクトを検索して選択] プルダウン ウィンドウで、スマートホーム プロジェクトを選択します。
Android Debug Bridge(ADB)ツールをインストールする
Android スマートフォンで Matter ログを表示するには、ADB をインストールする必要があります。
- コンピュータに ADB をインストールします。
- Android スマートフォンで [開発者向けオプション] と [USB デバッグ] をオンにします。
Matter デバイスの SoC ツールをインストールする
Matter デバイスのデバッグログを表示するには:
- ほとんどのデバイスの SoC はシリアルポートをエクスポートします(Linux の場合は
/dev/ttyUSBx
、MacOS の場合は/dev/tty.SLAB_USBtoUART
、/dev/tty.usbserial
など)。LogViewer は、デバイスからログを直接読み取ることができます。 - NXP や Silicon Labs などの一部の SoC タイプでは、外部ツール(JLink など)のインストールが必要になる場合があります。詳しくは、 サポートされているデバイスをご覧ください。
VS Code 用 Google Home 拡張機能を使用する
デベロッパー リソースを表示する
[ヘルプとフィードバック] で [スタートガイドとリソース] をクリックして [リソース] ページを開きます。このページでは、Google Home エコシステムでの開発に役立つ情報をご確認いただけます。

Google アシスタント シミュレータを使用する
VS Code で Assistant Simulator を開くには、サイドバーの [GOOGLE アシスタント シミュレータ] をクリックします。[メッセージ] ボックスにクエリを入力して、Enter
キーを押します。
Assistant Simulator レスポンスが表示されたら、クエリの後でボタンをクリックして、[再送信] をクリックします。

バッチ音声の実行
[Google アシスタント シミュレータ] メニューバーにカーソルを合わせ、次のいずれかのオプションを選択してスクリプトを設定します。
をクリックして、既存の発話スクリプトを開きます。
をクリックして、履歴を*.utterance
スクリプトに保存します。
一括発話の送信を開始するには、次のいずれかのオプションを選択します。
- をクリックして、プルダウン ウィンドウから発話スクリプトを選択します。
*.utterance
ファイルを直接開き、 をクリックします。
Cloud Logging を表示する
[クイック アクセス] で [Cloud ログ] をクリックして [Cloud ログ] ページを開きます。このページでは、選択したプロジェクトに属するログを確認できます。

ユーザーは、重大度と期間に基づいてログをフィルタできます。

デフォルトでは、ログは最大 50 行に制限されています。さらにログを表示する場合は、一番下までスクロールし、[その他] をクリックしてその他のログを表示します。

ホームグラフを表示してテストを実行する
[クイック アクセス] で [Home Graph Viewer] をクリックして [Home Graph Viewer] パネルを開きます。ここで、選択したプロジェクトに属するデバイスを確認できます。[Run Test] をクリックして、デバイスのテストを実行することもできます。

これにより、デバイスが選択されてテストできる状態で、ブラウザでテストスイートが起動し、[Start] をクリックしてテスト結果を待ちます。
すべてのテストが完了すると、テストの詳細を確認し、ログを表示できます。

Google Home 拡張機能を使用して Matter をデバッグする
Android のロギング
[Matter Logging ToolS] で、[Android Logs] をクリックして [Android Logs] ページを開き、接続する Android スマートフォンを選択して、ログの表示を開始します。

Android スマートフォンを接続すると、ログを 1 行ずつ表示できます。ログはフィルタされます。つまり、GHA と Google Play services Matter モジュールに関連するログのみが表示されます。[重大度] を設定してログをフィルタしたり、ログ内のキーワードを検索することもできます。

Matter デバイスのロギング
[MATTER LOGGING TOOLS] で [Device Logs] をクリックして [Resources] ページを開き、まず [SoC Type] を選択します。

次に、Matter 対応デバイスを選択します。

その後、デバイスからすべてのデバイスログを取得し、[重大度] や [検索] などのフィルタを使用して目的の情報を見つけることができます。

すべての Matter のログをダウンロード
[クイック アクセス] で、[ログをダウンロード] をクリックして [ログのダウンロード] ダイアログを開き、ダウンロードするログを選択して [OK] をクリックします。

ログをダウンロードするフォルダを選択し、[保存] をクリックします。

その後、ログは宛先フォルダに保存されます。

保存した zip ファイルを展開すると、デバイス情報とログファイルが表示されます。

デバイス情報ファイルには、問題のデバッグに必要なすべてのバージョン情報が含まれます。

フィードバックを送信
Google Home Extension での開発エクスペリエンスの改善について、ご意見やフィードバックがございましたら、次の中からお選びください。
- [ヘルプとフィードバック] パネルで [フィードバックを送信] をクリックして、ご意見をお寄せください。
- [ヘルプとフィードバック] パネルで [問題を報告] をクリックして、Google Home Extension で発生した問題を報告します。

- また、[Resources](リソース)ページにもフィードバック アイコンが配置されています。