Matter クラウドからクラウド Local Home SDK デバイス SDK
Google Home Extension for Visual Studio Code は、Google Home Platform のデベロッパー向けに設計、作成されています。この拡張機能を使用すると、Google Assistant Simulator、Google Cloud Logging、Home Graph Viewer などのツールにアクセスして、Matter やスマートホームの開発プロセスを簡素化できます。
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 に送信されます。
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 内から次の手順を行います。
- アクティビティ バーの拡張機能アイコンをクリックします。
google home
を検索し、[インストール] をクリックします。
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 サービスと通信できるようになります。
アクティビティ バーの Google Home アイコンをクリックして Google Home Extension を開きます。
[Sign in with Google] をクリックして、ブラウザでログインビューを開きます。
スマートホーム デバイスにリンクされているアカウントを選択します。
[Sign in with Google] の認証ページで、[Allow](許可)をクリックします。
ブラウザタブが開き、[Open Visual Studio Code] ダイアログ ボックスが表示されます。[Open Visual Studio Code] をクリックして次に進みます。
VS 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 拡張機能を使用する
デベロッパー リソースを表示する
[ヘルプとフィードバック] で [使ってみるとリソース] をクリックして [リソース] ページを開きます。このページでは、Google Home エコシステムでの開発に役立つ情報を確認できます。
Google アシスタント シミュレータを使用する
VS Code で Assistant Simulator を開くには、サイドバーの [GOOGLE ASSISTANT SIMULATOR] をクリックします。[メッセージ] ボックスにクエリを入力して、Enter
キーを押します。
Assistant Simulator レスポンスを確認できます。クエリの後にボタンをクリックすると、再送信できます。
バッチ発話の実行
[Google アシスタント シミュレータ] メニューバーにカーソルを合わせ、次のいずれかのオプションを選択してスクリプトを設定します。
をクリックして、既存の発話スクリプトを開きます。
をクリックして、履歴を*.utterance
スクリプトに保存します。
一括発話の送信を開始するには、次のいずれかのオプションを選択します。
- [ ] をクリックして、プルダウン ウィンドウから発話スクリプトを選択します。
*.utterance
ファイルを直接開き、 をクリックします。
Cloud Logging を表示する
[クイック アクセス] で [Cloud ログ] をクリックして [Cloud ログ] ページを開きます。このページでは、選択したプロジェクトに属するログを確認できます。
ユーザーは、重大度と期間に基づいてログをフィルタできます。
デフォルトでは、ログは 50 行に制限されています。ユーザーがさらにログを表示する場合は、一番下までスクロールして、[More] をクリックして他のログを表示します。
ホームグラフを表示してテストを実行する
[クイック アクセス] で [Home Graph Viewer] をクリックして [Home Graph Viewer] パネルを開きます。ここで、選択したプロジェクトに属するデバイスを確認できます。[Run Test] をクリックして、デバイスのテストを実行することもできます。
これにより、デバイスが選択された状態で、ブラウザでテストスイートが起動し、テストの準備が整います。[開始] をクリックしてテスト結果を待ちます。
すべてのテストが完了すると、テストの詳細を確認し、ログを表示できます。
Google Home 拡張機能を使用して Matter をデバッグする
Android のロギング
[MATTER LOGGING TOOLS] で [Android Logs] をクリックして [Android Logs] ページを開き、接続する Android スマートフォンを選択してログの表示を開始します。
Android スマートフォンが接続されると、ログを 1 行ずつ表示できます。ログはフィルタされているため、GHA と Google Play services Matter モジュールに関連するログのみが表示されます。[重大度] を設定してログをフィルタすることも、ログ内のキーワードを検索することもできます。
Matter デバイスのロギング
[MATTER LOGGING TOOLS] で [Device Logs] をクリックして [Resources] ページを開き、まず [SoC Type] を選択します。
次に、Matter 対応デバイスを選択します。
デバイスからすべてのデバイスログを取得し、[重大度] や [検索] などのフィルタを使用して関心のある情報を検索できます。
すべての案件のログをダウンロード
[クイック アクセス] で、[ログをダウンロード] をクリックして [ログのダウンロード] ダイアログを開き、ダウンロードするログを選択して、[OK] をクリックします。
ログをダウンロードするフォルダを選択し、[保存] をクリックします。
ログは宛先フォルダに保存されます。
保存した zip ファイルを展開します。デバイス情報とログファイルが表示されます。
デバイス情報ファイルには、問題のデバッグに必要なすべてのバージョン情報が含まれます。
フィードバックの送信
Google Home Extension の開発エクスペリエンスの改善について、ご意見やご感想がございましたら、次のいずれかを選択してください。
- [ヘルプとフィードバック] パネルで [フィードバックを送信] をクリックして、ご意見をお寄せください。
- [ヘルプとフィードバック] パネルで [問題を報告] をクリックして、Google Home Extension で見つかった問題を報告します。
- また、[Resources](リソース)ページにもフィードバック アイコンが配置されています。