VS Code 用 Google Home 拡張機能

Matter    クラウドからクラウド    Local Home SDK    デバイス SDK

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

VS Code 用 Google Home 拡張機能

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 に送信できます。

Google Home 拡張機能の Matter Logging

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. アクティビティ バーの拡張機能のアイコンをクリックします。

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

    Google Home Extension 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] をクリックして、ブラウザでログインビューを開きます。

    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 デバイス 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 を表示する

[クイック アクセス] で [Cloud ログ] をクリックして [Cloud ログ] ページを開くと、選択したプロジェクトに属するログを確認できます。

Cloud Logging を使用する

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

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

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

その他のログを表示

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

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

ホームグラフ ビューア

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

Google Home テストスイート

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

テスト結果

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

Android のロギング

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

Android のロギング

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

Android のロギングが除外されました

Matter デバイス ロギング

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

Matter デバイスのロギング

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

Matter のデバイス ロギングの選択

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

Matter 対応デバイスのロギング

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

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

Matter のログをダウンロード

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

案件のログの保存

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

案件のログの宛先フォルダ

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

Matter ログ ZIP ファイル

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

案件のログのデバッグ

フィードバックの送信

Google Home Extension の開発エクスペリエンスについてご意見やフィードバックをお送りいただく場合は、次のいずれかのオプションを選択してください。

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