このページは Cloud Translation API によって翻訳されました。

VS Code 用 Google Home 拡張機能

Google Home Extension for Visual Studio CodeGoogle Home プラットフォーム開発者向けに設計、作成されています。この拡張機能を使用すると、Google Assistant Simulator 、Google Cloud Logging 、ホームグラフビューア、その他のツールで、Matterスマートホームの開発プロセス。

Google Home 拡張機能の機能

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

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

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

Batch Utterances

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

Matter ロギングツール

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

Cloud Logging

Cloud Logging は、アクションの使用状況を分析するためのデバッグ情報と主要指標を提供します。Google Home Extension では、効率的な開発を可能にするため、トラブルシューティング中のコードの横にリアルタイムの Google Cloud Logging メッセージが表示されます。詳細については、Cloud Logging の表示をご覧ください。

ホームグラフビューア

ホームグラフビューアが Google Home Extension で直接使用できるようになりました。これにより、VS Code 内でホームグラフ内のデバイスの状態を確認できます。詳細については、ホームグラフの表示とテストの実行をご覧ください。

VS Code 用の Google Home 拡張機能をインストールする

インストールするにはGoogle Home ExtensionVS Code 内から次の手順に従います。

アクティビティバーの [拡張機能] アイコンをクリックします。
検索するgoogle homeをクリックし、インストール。

ダウンロードすることもできますGoogle Home Extensionから直接VS Code マーケットプレイス。

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

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

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

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

開発者アカウントにログインするにはGoogle Home Extension、VS Code がユーザーに代わって Google サービスと通信することを承認します。

アクティビティバーの Google Home アイコンをクリックして、Google Home Extension を開きます。
[Sign in with Google]（Google でログイン）をクリックすると、ブラウザでログインビューが起動します。
スマートホームデバイスにリンクされているアカウントを選択します。
[Sign in with Google] の認証ページで、[Allow]（許可）をクリックします。
ブラウザタブが開き、[Open Visual Studio Code] ダイアログボックスが表示されます。[Open Visual Studio Code] をクリックして続行します。
VS Code にリダイレクトされます。そこで、Google Home 拡張機能が URI を開くことを許可する権限が必要になります。[開く] をクリックして、ログインプロセスを終了します。
ログイン後、Google Home Extension がプロジェクトを読み込みます。完了したら、[プロジェクトを選択] をクリックします。
表示された [プロジェクトを検索して選択] プルダウンウィンドウで、スマートホームプロジェクトを選択します。

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

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

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

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

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

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

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

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

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

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

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

閲覧できますAssistant Simulator回答を確認し、クエリの後のボタンをクリックして再送信それ。

バッチ発話を実行する

Google アシスタントシミュレーターのメニューバーにマウスを移動し、次のオプションから選択してスクリプトを設定します。

クリック既存の発話スクリプトを開きます。
クリック歴史を保存する*.utteranceスクリプト。

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

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

Cloud Logging を表示する

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

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

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

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

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

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

Google Home テストスイート

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

Matter のデバッグには Google Home 拡張機能を使用する

Android のロギング

下物質記録ツール、クリックAndroidログ開くにはAndroidログページで、Android接続したい電話を選択し、ログの表示を開始します。

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

Matter デバイスのロギング

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

次に、[Matter Device] を選択します。

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

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

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

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

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

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

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

フィードバックを送信

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

[ヘルプとフィードバック] パネルで [フィードバックを送信] をクリックして、ご提案をお送りください。
オンザヘルプとフィードバックパネルをクリック問題を報告する問題を発見した場合は報告してくださいGoogle Home Extension

また、[Resources]（リソース）ページにもフィードバックアイコンが配置されています。