VS Code 用 Google Home 拡張機能

Matter    クラウド間    ローカル Home SDK    デバイス SDK

Google Home Extension for Visual Studio Code は、Google Home プラットフォームのデベロッパー向けに設計および作成されています。この拡張機能を使用すると、Google Assistant Simulator、Google Cloud Logging、Home Graph Viewer などのツールにアクセスし、Matter とスマートホームの開発プロセスを簡素化できます。

VS Code 用 Google Home 拡張機能

Google Home 拡張機能

Google アシスタント シミュレータ

VS Code 内から Assistant Simulator を使用することで、スマートホーム デバイスが Google Home エコシステムで適切に機能するかどうかをいつでもテストできます。

Assistant Simulator では、クエリ（「照明をつけて」など）を入力することで簡単にデバイスを操作できます。入力したコマンドに対しては、VS Code 内で Assistant Simulator がテキスト メッセージ（たとえば「はい、照明をつけます」）で応答します。詳しくは、Google アシスタント シミュレータを使用するをご覧ください。

バッチ発話

Google Home の統合を自動化のようにテストするには、発話スクリプトを実行して、Google アシスタント シミュレータにバッチ発話を送信します。詳細については、バッチ音声コマンドを実行するをご覧ください。

Matter ロギング ツール

Matter Logging Tools は、Google Home app (GHA) ログや Google Play 開発者サービス（GMS Core）ログなど、Matter デバッグに関連するすべてのログを収集できます。ログは、フィルタとキーワード検索を使用して VS Code で表示できます。ログは、Android やアプリのバージョンなどの追加のデバッグ情報とともにダウンロードして、問題を報告するために Google に送信できます。

Google Home 拡張機能のケースのログ

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 内で次の手順を行います。

  1. アクティビティ バーの [Extensions]（拡張機能）アイコンをクリックします。

  2. google home を検索して、[インストール] をクリックします。

    Google Home 拡張機能 Marketplace

VS Code Marketplace から Google Home Extension を直接ダウンロードすることもできます。

Google Home Extension をダウンロードする

VS Code 用 Google Home 拡張機能を設定する

Google Home Extension をインストールして VS Code を再読み込みしたら、Assistant Simulator を使用して Cloud Logging を表示する前に、ログインしてプロジェクトを選択する必要があります。

Google でログインしてクラウド プロジェクトを選択する

Google Home Extension からデベロッパー アカウントにログインし、VS Code が Google サービスと通信することを承認できます。

  1. アクティビティバーの Google Home アイコンをクリックして Google Home Extension を開きます。

    Google Home 拡張機能のアイコン

  2. [Google でログイン] をクリックして、ブラウザでログイン画面を起動します。

    VS Code の [Sign in with Google]

  3. スマートホーム デバイスにリンクしているアカウントを選択します。

  4. [Sign in with Google] の認証ページで、[Allow]（許可）をクリックします。

  5. ブラウザタブが開き、[Visual Studio Code を開く] ダイアログ ボックスが表示されます。[Visual Studio Code を開く] をクリックして続行します。

    VS Code ダイアログ ボックスを開く

  6. VS Code にリダイレクトされます。ここで、Google Home 拡張機能が URI を開くための権限を付与する必要があります。[開く] をクリックしてログイン プロセスを完了します。

    Google Home 拡張機能による URI の開きを許可する

  7. ログインすると、Google Home Extension にプロジェクトが読み込まれます。完了したら、[プロジェクトを選択] をクリックします。

    プロジェクトを選択

  8. 表示された [プロジェクトを検索して選択] プルダウン ウィンドウで、スマートホーム プロジェクトを選択します。

Android Debug Bridge（ADB）ツールをインストールする

Android スマートフォンで Matter ログを表示するには、ADB をインストールする必要があります。

  1. パソコンに ADB をインストールします。
  2. Android スマートフォンで開発者向けオプションと USB デバッグを有効にします。

Matter Device SoC ツールをインストールする

Matter デバイスのデバッグログを表示するには:

  1. ほとんどのデバイス SoC は、Linux では /dev/ttyUSBx、MacOS では /dev/tty.SLAB_USBtoUART や /dev/tty.usbserial などのシリアル ポートをエクスポートします。LogViewer は、デバイスからログを直接読み取ることができます。
  2. NXP や Silicon Labs などの一部の SoC タイプでは、外部ツール（JLink など）のインストールが必要になる場合があります。詳しくは、 サポートされているデバイスをご覧ください。

VS Code 用 Google Home 拡張機能を使用する

デベロッパー リソースを表示する

[ヘルプとフィードバック] で [スタートガイドとリソース] をクリックして [リソース] ページを開きます。このページには、Google Home エコシステムでの開発に役立つ情報がまとめられています。

Google Home エコシステムのリソース

Google アシスタント シミュレータを使用する

VS Code で Assistant Simulator を開くには、サイドバーの [GOOGLE ASSISTANT SIMULATOR] をクリックします。[メッセージ] ボックスにクエリを入力し、Enter キーを押します。

Assistant Simulator レスポンスが表示されます。クエリの後ろのボタンをクリックすると、クエリを再送信できます。

Google アシスタント シミュレータを使用する

バッチ音声コマンドを実行する

[GOOGLE ASSISTANT SIMULATOR] メニューバーにカーソルを合わせ、次のオプションから選択してスクリプトを設定します。

  • [] をクリックして、既存の発話スクリプトを開きます。

  • をクリックして、履歴を *.utterance スクリプトに保存します。

    バッチ音声のメニュー アイコン

バッチ音声を送信するには、次のいずれかのオプションを選択します。

  • [] をクリックして、プルダウン ウィンドウから音声スクリプトを選択します。

  • *.utterance ファイルを直接開き、 をクリックします。

    バッチ音声の実行アイコン

Cloud Logging を表示する

[QUICK ACCESS] で [Cloud Logging] をクリックして [Cloud Logging] ページを開きます。このページには、選択したプロジェクトに属するログが表示されます。

Cloud Logging を使用する

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

重大度と時間でログをフィルタする

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

その他のログを表示する

ホームグラフの表示とテストの実行

[QUICK ACCESS] で [Home Graph Viewer] をクリックして [Home Graph Viewer] パネルを開きます。このパネルでは、選択したプロジェクトに属するデバイスを確認できます。[テストを実行] をクリックして、デバイスのテストも実行できます。

ホームグラフ ビューア

これにより、ブラウザでテストスイートが起動し、デバイスが選択されてテストの準備が整います。[開始] をクリックし、テスト結果を待ちます。

Google Home テストスイート

すべてのテストが完了すると、テストの詳細を確認してログを表示できます。

テスト結果

Google Home 拡張機能を使用して Matter のデバッグを行う

Android のロギング

[MATTER ロギング ツール] で [Android ログ] をクリックして [Android ログ] ページを開き、接続する Android スマートフォンを選択してログの表示を開始します。

Android のロギング

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

Android のロギング（フィルタリング済み）

Matter デバイスのロギング

[MATTER LOGGING TOOLS] で [Device Logs] をクリックして [Resources] ページを開き、まず [SoC Type] を選択します。

Matter デバイスのロギング

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

Matter デバイスのロギングでデバイスを選択する

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

Matter デバイスのフィルタリングされたロギング

すべての案件ログをダウンロードする

[QUICK ACCESS] で [Download Logs] をクリックして [Download Logs] ダイアログを開き、ダウンロードするログを選択して [OK] を押します。

案件ログをダウンロードする

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

案件ログの保存

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

Matter ログの宛先フォルダ

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

Matter ログの ZIP ファイル

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

Matter ログのデバッグ

フィードバックを送信

Google Home Extension での開発の改善点など、ご意見やフィードバックがありましたらお送りください。

  • [ヘルプとフィードバック] パネルで [フィードバックを送信] をクリックして、Google に提案を送信します。
  • [ヘルプとフィードバック] パネルで [問題を報告] をクリックし、Google Home Extension で見つかった問題を報告します。
フィードバックを送信アイコン
  • また、[Resources]（リソース）ページにもフィードバック アイコンが配置されています。