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

バッチ発話

自動化などの Google Home インテグレーションをテストするには、発話スクリプトを実行して、バッチ発話を Google アシスタント シミュレータに送信します。詳細については、バッチ発話の実行をご覧ください。

Matter ロギングツール

Matter ロギングツールは、Matter のデバッグに関連するすべてのログ（Google Home app (GHA) ログや Google Play 開発者サービス（GMS Core）のログなど）を収集できます。ログは、フィルタ検索とキーワード検索を使用して 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. アクティビティ バーの [Extensions] アイコンをクリックします。

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

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

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

    Google Home 拡張機能による URI を開くことを許可する

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

    プロジェクトを選択

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

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

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

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

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

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

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

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

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

[Help and Feedback] で、[Get Started & Resources] をクリックして [Resources] ページを開きます。このページには、Google Home エコシステムでの開発に役立つ情報が表示されます。

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

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

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

Assistant Simulator レスポンスを表示し、クエリの後にあるボタンをクリックして、再送信してください。

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

バッチ発話を実行

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

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

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

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

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

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

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

    バッチ発話実行アイコン

Cloud Logging を表示する

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

Cloud Logging を使用する

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

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

デフォルトでは、ログの最大行数は 50 行です。ユーザーがさらにログを表示する場合は、下にスクロールして [もっと見る] をクリックし、その他のログを表示します。

その他のログを表示

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

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

ホームグラフ ビューア

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

Google Home テストスイート

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

テスト結果

Matter のデバッグに Google Home Extension を使用する

Android のロギング

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

Android のロギング

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

Android Logging フィルタ済み

Matter デバイスのロギング

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

Matter デバイスのロギング

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

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

次に、デバイスからすべてのデバイスログを取得し、重大度や検索などのフィルタを使用して目的の情報を探します。

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

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

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

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

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

Matter ログの保存

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

Matter ログの保存先フォルダ

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

Matter ログの Zipfile

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

Matter ログのデバッグ

フィードバックを送信

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

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