VS Code 用 Google Home 拡張機能

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

Google Home Extension for Visual Studio Code は Google Home Platform のデベロッパー向けに設計、作成されています。この拡張機能により、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 ロギング

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

    VS Code の [Sign in with Google]

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

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

  5. ブラウザタブが開き、[Open Visual Studio Code] ダイアログ ボックスが表示されます。[Open 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 アシスタント シミュレータ] をクリックします。[メッセージ] ボックスにクエリを入力して、Enter キーを押します。

Assistant Simulator レスポンスが表示されたら、クエリの後でボタンをクリックして、[再送信] をクリックします。

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

バッチ音声の実行

[Google アシスタント シミュレータ] メニューバーにカーソルを合わせ、次のいずれかのオプションを選択してスクリプトを設定します。

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

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

    一括読み上げメニュー アイコン

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

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

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

    バッチ音声実行アイコン

Cloud Logging を表示する

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

Cloud Logging を使用する

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

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

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

ログをさらに表示

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

[クイック アクセス] で [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 モジュールに関連するログのみが表示されます。[重大度] を設定してログをフィルタしたり、ログ内のキーワードを検索することもできます。

Android のロギングのフィルタ

Matter デバイスのロギング

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

Matter デバイスのロギング

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

Matter デバイスのロギング（選択したデバイス）

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

Matter デバイスのロギング

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

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

Matter のログをダウンロード

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

Matter のログ保存

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

Matter のログの宛先フォルダ

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

Matter ログの ZIP ファイル

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

Matter のログのデバッグ

フィードバックを送信

Google Home Extension での開発エクスペリエンスの改善について、ご意見やフィードバックがございましたら、次の中からお選びください。

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