Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator , Cloud Logging, and other tools to simplify your smart home development process.
セキュリティ通知
Android Studio にシークレットとパスワードが保存されないようにするには、次の手順を行います。
- [File]、[Settings...] の順にクリックします。
- [Appearance & Behavior] で [System Settings] を展開し、[Passwords] をクリックします。
- [保存せず、再起動後にパスワードを保存する] を選択します。
機能
アシスタント シミュレータ
スマートホーム デバイスが Google Home エコシステムと正しく動作するかどうかをテストするには、Android Studio から離れることなく、いつでも Assistant Simulator を操作できます。
Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light." で提供されている既存のアシスタント シミュレータと同様
Cloud Logging を表示する
Google Cloud Logging は、アクションの使用状況を分析するためのデバッグ情報と主要指標を提供します。開発を簡素化するため、トラブルシューティング中のコードの横にはリアルタイムの Cloud Logging メッセージが表示されます。
リアルタイム ログを表示したり、期間を指定したりできます。
バッチ発話
1 つの発話に対する Assistant Simulator レスポンスは確定的ではありません。たとえば、次のいずれかのフレーズが返されます。
- 2 個のライトを点灯します。
- 2 個のライトを点灯します。
- 2 個のライトを点灯します。
- 2 個のライトを点灯します。
自動テストを実行して、Google との統合がさまざまなレスポンスにどのように作用するかを確認するには、発話スクリプトを実行してバッチ発話を Assistant Simulator に送信します。スクリプトを保存すると、レスポンスを収集し、クエリに対して複数のテストを実行できます。
ホームグラフ ビューア
ホームグラフ ビューアを使用すると、デバイスの状態を表示し、Google Home テストスイートをブラウザで起動できます。
インストール
Android Studio に Google Home Plugin をインストールする手順は次のとおりです。
- Android Studio をダウンロードまたは更新します。 が必要です Android Studio をダウンロード
- [File] > [Settings]（MacOS では [ Android Studio] > [Preferences]）に移動します。
- [Plugins] セクションで [Marketplace] に移動し、
google homeを検索します。 - ツールをインストールして再起動します。 Android Studio
セットアップ
プラグインをインストールしたら、Assistant Simulator を使用して Cloud Logging を表示する前に、次の手順を行う必要があります。
Google でログイン
Google ホームパネルからデベロッパー アカウントにログインして、Android Studio がお客様に代わって Google サービスと通信することを許可します。
Android Studio ウィンドウの左側にある [垂直] タブ列の [Google Home] タブをクリックします。
[ログイン] で [Google] をクリックし、ブラウザを起動します。
スマートホーム デバイスにリンクしているアカウントを選択します。
[Sign in with Google] の認証ページで、[Allow]（許可）をクリックします。
ブラウザ ウィンドウを閉じて、Android Studio に戻ります。
ログインするには、ログアウトするオプションが表示されます。
Cloud プロジェクトを選択
ログインしたら、プルダウンから [プロジェクト] を選択します。プロジェクト リストをフィルタするには、Filter 式（matter など）を入力し、Enter を押します。
[プロジェクト] プルダウンには、[フィルタ] に基づいて最初の 100 件のプロジェクトが読み込まれます。Android Studio を終了しても、選択内容は保持されます。
プロジェクト フィルタについては、Google Cloud リファレンスのクエリ パラメータをご覧ください。
アシスタント シミュレータを使用する
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 ファイルで、Collect と Test が機能します。
同じファイルまたは異なるファイル（lights、lights(1)、plug など）に対して複数のタブを開くことができます。
ステータスバーには、最後のテストの結果（該当する場合）、ファイルが収集されたかどうかを示す黄色または緑色のドット、発話 .json ファイルのパスが表示されます。[収集] をクリックすると、Assistant Simulator がクエリを実行します。新しいレスポンスが収集されると通知が届きます。また、クエリの処理中は、ステータスバーにカウンタが表示されます。
[Collect] が完了すると、ステータスバーが更新され、.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 ログツール ウィンドウで [プロジェクト] タブを開くには、Google Home Plugin パネルで [Cloud ログ] をクリックします。プロジェクトごとに Cloud Logging のタブを個別に開くことができます。
検索キーワード
選択したプロジェクトについて、[クエリ] フィールドを使用してログをフィルタすることもできます。たとえば、ログを light というキーワードでフィルタするには、次のようにします。
[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より前の日付を選択するには、Before を選択し、日付アイコン をクリックします。5/1/22～6/30/22の日付を選択するには、[Before] と [After] を選択し、日付アイコン から日付を選択します。
ライブ プロジェクトのログを取得するには、[Real Time] を選択します。[停止] をクリックしてリアルタイム フィードを終了します。
重大度
プルダウンから [最小限の重要度] を選択することもできます。
クエリ結果
[取得] をクリックして、クエリ パラメータを送信します。
ログが読み込まれたら、任意のレコード をクリックして JSON ペイロードを展開します。もう一度 をクリックすると、メッセージ全体が表示されます。
必要に応じて、[フィルタ] ボックスにキーワードを入力して、ログ結果を絞り込めます。x をクリックしてフィルタを削除し、元の取得結果に戻ります。
ホームグラフを表示してテストを実行する
デバイスを一覧表示するには、Google Home Plugin パネルから [Home Graph] を選択します。
[ 更新] をクリックして、選択したプロジェクトに関連付けられているデバイスのデバイス名、デバイス ID、デバイスタイプを表示します。複数の Google Home Graph panels open for separate projects. を使用できます。
デバイスが読み込まれたら、任意のレコード をクリックして JSON ペイロードを展開します。
[開く] と [閉じる] を使用して、デバイスの JSON ペイロードの表示と非表示を切り替えることもできます。
特定のデバイスのテストスイートを起動するには、[テスト] をクリックします。これにより、デバイスでテストスイートが起動され、デバイスが選択されてテストの準備が整います。[開始] をクリックし、テスト結果を待ちます。
テストが完了すると、テストの詳細を確認してログを表示できます。
リソースとフィードバック
デベロッパー ツールとリソースの一覧については [リソース] をクリックします。
Google Home Plugin での開発エクスペリエンスの改善に関するご意見やフィードバックがございましたら、[フィードバック] をクリックしてください。
