Google Home Plugin for Android Studio は Google のために設計、開発されました ホーム プラットフォームのデベロッパー。このプラグインを使用すると、 Google Assistant Simulator、Cloud Logging、その他のツールで スマートホームの開発プロセスも 進めています
セキュリティに関するお知らせ
Android Studio でシークレットとインスタンスの保存が行われないようにするには、 次の手順を完了します。
- [File]、[Settings...] の順にクリックします。
- [デザインと[Behavior] > [System Settings] を開き、 パスワード。
- [再起動後にパスワードを保存しない] を選択します。
機能
アシスタント シミュレータ
スマートホーム デバイスが Google Home エコシステムで適切に機能するかどうかをテストするには、Android Studio を離れずにいつでも Assistant Simulator を操作できます。
既存のアシスタントと類似 シミュレータの提供 Actions on Google Console コンソールで Assistant Simulator を使用すると、次のことができます。 クエリを入力するだけで、デバイスを簡単に操作できます。 「電気をつけて」Android Studioの中で、 Assistant Simulator はあなたの内容に基づいてテキスト メッセージで返信します コマンド（「了解しました。電気をつけて」など）
Cloud Logging を表示する
Google Cloud Logging デバッグ情報と主な指標を確認し、 アクションの使用状況。開発を簡素化するために、Google Home Plugin に、 リアルタイムでCloud Loggingのメッセージを トラブルシューティングを行います
リアルタイム ログを表示したり、期間を選択したりできます。
バッチ発話
1 つの発話に対する Assistant Simulator 件の応答は 決定的です。たとえば、レスポンスには次のようなフレーズがあります。
- 了解しました。2 つのライトを点灯します。
- 2 個のライトを点灯します。
- 了解しました。2 つのライトを点灯します。
- 2 個のライトを点灯します。
自動テストを実行し、Google との統合がどのように機能するかを確認するには 送信する場合は、その会話の宛先に一括発話を送信できます。 Assistant Simulator。発話スクリプトを実行します。スクリプトが 保存した回答を収集し、クエリに対して複数のテストを実施できます。
ホームグラフ ビューア
Home Graph Viewer を使用すると、デバイスの状態を表示し、ブラウザで Google Home テストスイートを起動できます。
Android Debug Bridge（adb）ログビューア
adb ログビューアは、ログファイルを表示および分析するためのツールです。たとえば、 Matter デバイスのログファイル、Google Home のログ、Android できます。
インストール
Android Studio に Google Home Plugin をインストールするには: 手順は次のとおりです。
- Android Studio をダウンロードまたは更新します。 Android Studio をダウンロード
- [ファイル] >設定（Android Studio > 環境設定を参照）。
- [Plugins] セクションで [Marketplace] に移動し、
google home。 - ツールをインストールして Android Studio を再起動します。
また、 JetBrains マーケットプレイス。
セットアップ
プラグインをインストールしたら、次の手順を Assistant Simulator と Cloud Storage を使用するには、 Cloud Logging を表示します。
Google でログイン
デベロッパー アカウントには、Google ホームパネルからログインできます。 Android Studio が Google と通信することを承認しています ユーザーに代わります。
左側の縦方向のタブ列にある [Google Home] タブをクリックします クリックします。Android Studio
[ログイン] で [Google] をクリックしてブラウザを起動します。
スマートホーム デバイスにリンクしているアカウントを選択します。
[Sign in with Google] の認証ページで、[Allow]（許可）をクリックします。
ブラウザ ウィンドウを閉じて、Android Studio に戻ります。
これでログインが完了し、[Sign Out] のオプションが表示されます。
Cloud プロジェクトを選択する
ログインしたら、プルダウンから [プロジェクト] を選択します。フィルタ条件として
プロジェクト リストで、Filter 式（matter など）を入力してから、
Enter。
[プロジェクト] プルダウンには、プロジェクトに基づいて最初の 100 個のプロジェクトが読み込まれます。 フィルタ。終了しても、選択内容は保持されます Android Studio。
プロジェクト フィルタについて詳しくは、このモジュールの クエリ パラメータ ご覧ください。
アシスタント シミュレータを使用する
Android Studio で Assistant Simulator を開くには、 Google Home Plugin パネルの [発話パネル] をクリックします。
Assistant Simulator にクエリを送信するには、いくつかの方法があります。次に、各オプションについて説明します。
クエリを入力して回答を収集する
Assistant Simulator を操作するには、クエリを入力して Enter キーを押します。
クエリを再送信するには、 末尾にある 再送信アイコン 検索できます。
1 つ以上のクエリを送信したら、 [リプレイ] をクリックすると、 レスポンスを確認します。[発話] パネルには、保存されたキャッシュにクエリとレスポンスが記録されます。[リプレイ] を選択すると、 保存されるため、クリックしてもクエリが重複することはありません。 ] ボタンを離します。
[ 保存] をクリックしてクエリを保存し、 回答として [発話] パネル。インタラクションは次の形式で JSON に変換されます。
ask: クエリ。answers: 取り得る Assistant Simulator レスポンスの配列。
この JSON ファイルは Android Studio で編集できます。
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
バッチ レスポンスを収集する
Google Home Plugin パネルで [発話ファイル] をクリックして開きます。
新しいタブに JSON ファイルが表示されます。[Select Path] では、次のいずれかを選択できます。
ファイルまたはフォルダです。フォルダを選択すると、[収集] と [テスト] は、そのフォルダ内のすべての発話 .json ファイルに対して機能します。
たとえば、同じファイルまたは異なるファイルについて、複数のタブを開くことができます。
lights、lights(1)、plug。
ステータスバーには、最後のテストの結果が表示されます（該当する場合）。
ファイルが収集されたことを示す黄色または緑色のドットが表示され、
発話 .json のファイルパス。[
収集
Assistant Simulator がクエリを実行します。
新しい回答が収集されると通知が届きます。クエリの処理中はステータスバーにカウンタが表示されます。
[収集] が完了すると、ステータスバーが更新され、.json パスの前に緑色のチェックマークが表示され、音声ファイルに可能なレスポンスが入力されます。
{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
収集を早めに停止すると、.json パスにマークが付きません。
収集します。
バッチ発話をテストする
回答を収集したら、 テストでクエリをリプレイ 回答とログを確認できます。バッチ発話をテストすると、 Assistant Simulator は JSON に保存されるレスポンスを想定しています 表示されます。テストでまだ収集されていないレスポンスが返された場合は、 次のようなレスポンスが返されます。
Expected one of: "Got it, turning on
2 lights."
このシナリオは、テストが失敗したことを示します。それ以外の場合、 Assistant Simulator は、各クエリを実行してレスポンスを返します。 チェックが テストが成功した場合のステータスバー。
Cloud Logging を表示する
Cloud ログツール ウィンドウでプロジェクトのタブを開くには、[Cloud ログ] をクリックします。 [Google Home Plugin] パネルから行います。Cloud Log のタブを個別に開くと、 自動的に作成されます。
検索キーワード
選択したプロジェクトでは、[クエリ] フィールドを使用してログをフィルタすることもできます。
たとえば、light というキーワードでログをフィルタするには、次のようにします。
[Use QL] を選択して Logging のクエリ言語。
手始めに、QL クエリの例をいくつか示します。
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
日時クエリ
日付によるログのクエリもオプションです。
[After] と [Before]:テキストに日付と時刻の形式を入力できます。
フィールド（5/11/22, 12:37 PM など）を使用するか、日付選択ツールを使用して
テキスト欄に時刻を入力します。
5/1/22より後の日付を選択するには、[次の日付より後] を選択して日付アイコンをクリックします。 。5/1/22より前の日付を選択するには、[次の日付より前] を選択して、その日付をクリックします。 アイコン 。5/1/22～6/30/22の日付を選択するには、[次の日付より前] を選択します。 [次の日付より後] を選択し、日付アイコンから日付を選択します。 。
ライブのプロジェクト ログを取得するには、[リアルタイム] を選択します。[Stop] をクリックして リアルタイムのフィードです
重大度
プルダウンから [最小重要度] を選択することもできます。
クエリ結果
[ 取得] をクリックして送信します クエリパラメータを指定します
ログが読み込まれたら、任意のレコードをクリックします。 すべて開く: JSON ペイロード。 をもう一度クリックすると、メッセージ全体が表示されます。
必要に応じて、[フィルタ] ボックスにキーワードを入力してログを絞り込むことができます。
表示されます。フィルタを解除して元の状態に戻すには、[x] をクリックします
結果を取得できます。
ホームグラフを表示してテストを実行する
デバイスを一覧表示するには、メニューからホームグラフを選択します。 Google Home Plugin パネル。
[ [更新] をクリックして、 デバイスのデバイス名、デバイス ID、デバイスの種類 ロールが表示されます。1 つのテーブルに複数の 個別のプロジェクト用に Google Home Graph パネルが開きます。
デバイスが読み込まれたら、レコードをクリックします。 すべて開く: JSON ペイロード。
[展開] と [閉じる] を使用して、デバイスの JSON ペイロードを表示または非表示にすることもできます。
特定のデバイス用にテストスイートを起動するには、次の手順を行います。 [テスト] をクリックします。これにより、ブラウザでテストスイートが起動し、 テストの準備ができました[開始] をクリックしてテストが完了するまで待ちます。 表示されます。
テストが完了したら、テストの詳細やログを確認できます。
Android Debug Bridge（adb）ログビューア
[Adb Log] ツール ウィンドウで [プロジェクト] タブを開くには、[Adb Log] コマンドをクリック をクリックします。個別の adb ログを開くことができます タブが表示されます。タブを削除するには、 アイコンをクリックします。
[選択] フィールドを使用して、表示する特定のロギング コンポーネントを選択し、 [重大度] プルダウンを使用すると、ログの重大度が一致するエントリのみが表示されます。
選択した adb ログについて、[Filter] を使用してログエントリをフィルタリングできます。 フィールドに、オプションの大文字と小文字を区別または正規表現の修飾子を付けたり、
さらに、次のことが可能です。
- 特定のエントリを検索するには、[Find] フィールド、次を検索（ アイコン）および前を検索（ アイコン）コマンドを使用します。
- 必要に応じて、大文字と小文字を区別する修飾子または正規表現の修飾子を使用します。
- [行に移動] をクリックすると、ログ内の指定した行（番号で指定）に移動できます。
[番号付き] を選択すると、行番号が追加されたログ行が表示されます。[RAW] を選択します。 未加工ログエントリを表示できます
リソースとフィードバック
[リソース] をクリックすると、デベロッパー ツールとリソースの一覧が表示されます。
開発の改善方法についてご意見やフィードバックを送信する Google Home Plugin の使用経験がある場合は、[フィードバック] をクリックします。
