VS Code 用 Google Home 拡張機能

Google Home Extension for Visual Studio Code は Google Home Platform デベロッパー向けに設計、作成されています。この拡張機能を使用すると、Google Assistant Simulator, Google Cloud Logging、ホームグラフ ビューアなどのツールにアクセスし、 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 ロギングツールは、Matter のデバッグに関連するすべてのログを収集できます。これには、 Google Home app (GHA) のログや Google Play 開発者サービス(GMS Core)のログが含まれます。ログは VS Code で表示でき、フィルタやキーワード検索も可能です。ログは、Android やアプリのバージョンなどのデバッグ情報とともにダウンロードして、Google に送信して問題を報告できます。Android

Google Home 拡張機能の Matter ロギング

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」を検索して [Install](インストール)をクリックします。

    Google Home 拡張機能 Marketplace

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 サービスと通信できるようにします。

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

    Google Home 拡張機能のアイコン
  2. [Sign in with Google](Google でログイン)をクリックすると、ブラウザでログイン画面が開きます。

    VS Code の [Sign in with Google]
  3. スマートホーム デバイスにリンクされているアカウントを選択します。

  4. [Google でログイン] の認証ページで、[Allow](許可)をクリックします。

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

    [VS Code を開く] ダイアログ ボックス
  6. VS Code にリダイレクトされます。Google Home 拡張機能が URI を開くことを許可する必要があります。[Open](開く)をクリックしてログイン プロセスを完了します。

    Google Home 拡張機能が URI を開くことを許可する
  7. ログインすると、Google Home Extension がプロジェクトを読み込みます。完了したら、[Select a project](プロジェクトを選択)をクリックします。

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

Android Debug Bridge(ADB)ツールをインストールする

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

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

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

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

  1. ほとんどのデバイス SoC は、Linux では /dev/ttyUSBx 、MacOS では /dev/tty.SLAB_USBtoUART/dev/tty.usbserial などのシリアルポートをエクスポートします。LogViewer は、デバイスからログを直接読み取ることができます。
  2. NXP詳しくは、 サポートされているデバイスをご覧ください。

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

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

[HELP AND FEEDBACK] で [Get Started & Resources](スタートガイドとリソース)をクリックして [Resources](リソース)ページを開きます。このページには、Google Home エコシステムでの 開発に役立つ情報がまとめられています。

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

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

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

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

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

バッチ発話を実行する

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

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

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

    バッチ発話メニュー アイコン

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

  • をクリックして、プルダウン ウィンドウから発話スクリプトを選択します。
  • *.utterance ファイルを直接開いて をクリックします。

    Batch Utterances Run Icon(バッチ発話実行アイコン)

Cloud Logging を表示する

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

Cloud Logging を使用する

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

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

デフォルトでは、ログは 50 行に制限されています。さらにログを表示するには、下部にスクロールして [More](もっと見る)をクリックします。

その他のログを表示する

ホームグラフを表示してテストを実行する

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

ホームグラフ ビューア

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

Google Home テストスイート

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

テスト結果

Google Home 拡張機能を使用して Matter をデバッグする

Android のロギング

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

Android のロギング

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

Android Logging Filtered

Matter デバイスのロギング

[MATTER LOGGING TOOLS] で [Device Logs](デバイスログ)をクリックして [Resources](リソース)ページを開き、 最初に [SoC Type](SoC タイプ)を選択します。

Matter デバイスのロギング

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

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

デバイスからすべてのデバイスログを取得し、[Severity](重大度)や [Search](検索)などのフィルタを使用して、必要な情報を検索できます。

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

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

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

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

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

Matter Log Save

ログは転送先フォルダに保存されます。

Matter ログの宛先フォルダ

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

Matter ログの zip ファイル

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

Matter Log Debug

フィードバックを送信

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

  • [HELP AND FEEDBACK] パネルで [Give Feedback](フィードバックを送信)をクリックして、ご提案をお送りください。
  • [HELP AND FEEDBACK] パネルで [Report Issue](問題を報告)をクリックして、 発見した問題を報告してください。Google Home Extension
フィードバックを送信アイコン
  • [Resources](リソース)ページにもフィードバック アイコンが配置されています。