Google Home Plugin for Android Studio は、Google Home プラットフォームのデベロッパー向けに設計されています。このプラグインにより、Google Assistant Simulator や Cloud Logging などのツールにアクセスして、スマートホーム開発プロセスを簡素化できます。
![Android Studio 用 Google Home プラグイン](https://developers.home.google.com/static/tools/images/android-studio-overview.png?authuser=5&hl=ja)
セキュリティ通知
Android Studio がシークレットとパスワードを保存しないようにするには、次の手順を行います。
- [File]、[Settings...] の順にクリックします。
- [Appearance & Behavior] で、[System Settings] を展開し、[Passwords] をクリックします。
- [再起動後にパスワードを保存しない] を選択します。
![Android Studio 用 Google Home プラグイン](https://developers.home.google.com/static/tools/images/android-studio-password.png?authuser=5&hl=ja)
機能
アシスタント シミュレータ
スマートホーム デバイスが Google Home エコシステムと適切に連携するかどうかをテストするには、Android Studio を終了せずにいつでも Assistant Simulator を操作します。
Actions on Google Console コンソールで提供されている既存のアシスタント シミュレータと同様に、Assistant Simulator では「ライトをつけて」などのクエリを入力するだけでデバイスを簡単に操作できます。Android Studio 内で、Assistant Simulator はコマンド(例: 「了解、ライトをつけて」)に基づいてテキスト メッセージで応答します。
![アシスタント シミュレータでテストする](https://developers.home.google.com/static/tools/images/android-studio-assistant.png?authuser=5&hl=ja)
Cloud Logging を表示する
Google Cloud Logging は、アクションの使用状況に関する分析情報を提供するデバッグ情報と主要な指標を提供します。開発を簡素化するために、トラブルシューティングでは、Google Home Plugin がコードのすぐ近くにリアルタイムの Cloud Logging メッセージを表示します。
リアルタイムのログを表示したり、期間を選択したりできます。
![Cloud Logging ビュー](https://developers.home.google.com/static/tools/images/android-studio-logging.png?authuser=5&hl=ja)
バッチ発話
1 つの発話に対する Assistant Simulator の応答は決定的ではありません。たとえば、レスポンスには次のようなフレーズがあります。
- 了解しました。2 つのライトを点灯します。
- 2 個のライトを点灯します。
- 了解しました。2 つのライトを点灯します。
- 2 個のライトを点灯します。
自動テストを実行し、さまざまなレスポンスで Google との統合がどのように機能するかを確認するには、発話スクリプトを実行して、発話のバッチを Assistant Simulator に送信します。スクリプトを保存すると、レスポンスを収集し、クエリに対して複数のテストを実行できます。
ホームグラフ ビューア
ホームグラフ ビューアを使用すると、デバイスの状態を表示し、ブラウザで Google Home テストスイートを起動できます。
Android Debug Bridge(adb)ログビューア
Adb ログビューアは、ログファイル(Matter デバイス ログファイル、Google Home ログ、Android ログなど)を表示して分析するためのツールです。
インストール
Android Studio に Google Home Plugin をインストールする手順は次のとおりです。
- Android Studio をダウンロードまたは更新します。 Android Studio のダウンロード
- [File] > [Settings](MacOS では [Android Studio] > [Preferences])に移動します。
- [Plugins] セクションで [Marketplace] に移動し、
google home
を検索します。 - ツールをインストールして Android Studio を再起動します。
このプラグインは、JetBrains Marketplace から直接ダウンロードすることもできます。
セットアップ
プラグインをインストールした後、Assistant Simulator を使用して Cloud Logging を表示するには、次の手順を完了する必要があります。
Google でログイン
Google ホームパネルからデベロッパー アカウントにログインして、Android Studio がユーザーに代わって Google サービスと通信することを承認できます。
Android Studio ウィンドウの左側にある垂直タブ列にある [Google Home] タブをクリックします。
[ログイン方法] で [Google] をクリックしてブラウザを起動します。
スマートホーム デバイスにリンクしているアカウントを選択します。
[Sign in with Google] の認証ページで、[Allow](許可)をクリックします。
ブラウザ ウィンドウを閉じて Android Studio に戻ります。
これでログインが完了し、[Sign Out] のオプションが表示されます。
Cloud プロジェクトを選択
ログインしたら、プルダウンから [プロジェクト] を選択します。プロジェクト リストをフィルタリングするには、Filter 式(例: matter
)を入力して、Enter
キーを押します。
[プロジェクト] プルダウンに、フィルタに基づいて最初の 100 個のプロジェクトが読み込まれます。Android Studio を終了しても、選択内容は保持されます。
![プロジェクトの選択](https://developers.home.google.com/static/tools/images/android-studio-select-project.png?authuser=5&hl=ja)
プロジェクト フィルタについては、Google Cloud リファレンスのクエリ パラメータをご覧ください。
アシスタント シミュレータを使用する
Android Studio で Assistant Simulator を開くには、Google Home Plugin パネルの [発話パネル] をクリックします。
![発話パネルを開く](https://developers.home.google.com/static/tools/images/android-studio-utterances-button.png?authuser=5&hl=ja)
Assistant Simulator にクエリを送信するには、いくつかの方法があります。次に各オプションについて説明します
クエリを入力して回答を収集する
Assistant Simulator を操作するには、クエリを入力して Enter キーを押します。
クエリを再送信するには、クエリの最後にある
再送信アイコンをクリックします。1 つ以上のクエリを送信したら、
[リプレイ] をクリックしてクエリを再実行し、レスポンスを確認します。[Utterances] パネルは、保存されたキャッシュでクエリとレスポンスを追跡します。リプレイでは、この内部キャッシュに新しいレスポンスのみが追加されます。ボタンをクリックするたびにクエリが重複することはありません。![アシスタント シミュレータで発話を再生する](https://developers.home.google.com/static/tools/images/android-studio-replay.png?authuser=5&hl=ja)
[保存] をクリックして、[発話] パネルに入力したクエリとレスポンスを保存します。操作は、次の形式の 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 によってクエリが実行されます。新しいレスポンスが収集されると通知され、クエリの処理中はステータスバーにカウンタが表示されます。
![アシスタント シミュレータで発話を収集する](https://developers.home.google.com/static/tools/images/android-studio-collect.png?authuser=5&hl=ja)
Collect が完了すると、ステータスバーが更新され、.json
パスの前に緑色のチェックマークが表示されます。回答の候補が発話ファイルに表示されます。
![アシスタント シミュレータで発話を収集する](https://developers.home.google.com/static/tools/images/android-studio-collect-complete.png?authuser=5&hl=ja)
{
"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."
![アシスタント シミュレータによる発話の実行](https://developers.home.google.com/static/tools/images/android-studio-run.png?authuser=5&hl=ja)
このシナリオは、テストが失敗したことを示します。それ以外の場合、Assistant Simulator は各クエリを実行してレスポンスを返します。テストが成功すると、ステータスバーに チェックが表示されます。
![アシスタント シミュレータによる発話の実行](https://developers.home.google.com/static/tools/images/android-studio-success.png?authuser=5&hl=ja)
Cloud Logging を表示する
Cloud ログツール ウィンドウでプロジェクト タブを開くには、Google Home Plugin パネルで [Cloud ログ] をクリックします。プロジェクトごとに個別の Cloud ログタブを開くことができます。
![Cloud Logging のタブ](https://developers.home.google.com/static/tools/images/android-studio-mult-tabs.png?authuser=5&hl=ja)
検索キーワード
選択したプロジェクトでは、[クエリ] フィールドを使用してログをフィルタリングすることもできます。たとえば、light
というキーワードでログをフィルタするには、次のようにします。
![Cloud Logging のクエリ](https://developers.home.google.com/static/tools/images/android-studio-log-query.png?authuser=5&hl=ja)
Logging のクエリ言語を使用するには、[QL を使用する] を選択します。
![Cloud Logging クエリ言語](https://developers.home.google.com/static/tools/images/android-studio-log-ql.png?authuser=5&hl=ja)
手始めに、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"
日時クエリ
日付によるログのクエリもオプションです。有効にするには、[次の日付より後] または [次の日付より前] をクリックします。表示されるテキスト フィールドに日付と時刻の形式(5/11/22, 12:37 PM
など)を入力するか、日付選択ツール を使用して日付を選択し、テキスト フィールドに時刻を入力します。
5/1/22
より後の日付を選択するには、[次の日付より後] を選択して、日付アイコン をクリックします。5/1/22
より前の日付を選択するには、[次の日付より前] を選択して、日付アイコン をクリックします。5/1/22
~6/30/22
の日付を選択するには、[次の日付より前] と [次の日付より後] を選択し、日付アイコン から日付を選択します。
ライブのプロジェクト ログを取得するには、[リアルタイム] を選択します。[停止] をクリックして、リアルタイム フィードを終了します。
重大度
プルダウンから [最小重要度] を選択することもできます。
クエリ結果
[
取得] をクリックして、クエリ パラメータを送信します。ログが読み込まれたら、任意のレコード
をクリックして、JSON ペイロード全体を展開します。もう一度 をクリックすると、メッセージ全体が表示されます。必要に応じて、[フィルタ] ボックスにキーワードを入力して、ログの結果を絞り込むことができます。x
をクリックしてフィルタを削除し、元の取得結果に戻ります。
![Cloud Logging を表示する](https://developers.home.google.com/static/tools/images/android-studio-log-payload.png?authuser=5&hl=ja)
ホームグラフを表示してテストを実行する
デバイスを一覧表示するには、Google Home Plugin パネルから [ホームグラフ] を選択します。
Google Home Graph パネルを開くことができます。
[更新] をクリックすると、選択したプロジェクトに関連付けられているデバイスのデバイス名、デバイス ID、デバイスの種類が表示されます。別々のプロジェクトに対して、複数のデバイスが読み込まれたら、レコード
をクリックして完全な JSON ペイロードを展開します。![ホームグラフ JSON ペイロード](https://developers.home.google.com/static/tools/images/android-studio-hg-payload.png?authuser=5&hl=ja)
[開く] と [閉じる] を使用して、デバイスの JSON ペイロードの表示と非表示を切り替えることもできます。
![ホームグラフの JSON の開閉](https://developers.home.google.com/static/tools/images/android-studio-hg-expand.png?authuser=5&hl=ja)
特定のデバイス用にテストスイートを起動するには、[Test] をクリックします。これにより、デバイスが選択され、テストの準備ができた状態で、ブラウザでテストスイートが起動します。[開始] をクリックし、テスト結果を待ちます。
![ホームグラフ実行テスト](https://developers.home.google.com/static/tools/images/android-studio-test-run.png?authuser=5&hl=ja)
テストが完了したら、テストの詳細やログを確認できます。
![ホームグラフ完了済みテスト](https://developers.home.google.com/static/tools/images/android-studio-test-done.png?authuser=5&hl=ja)
Android Debug Bridge(adb)ログビューア
[Adb Log] ツール ウィンドウで [プロジェクト] タブを開くには、Google Home プラグイン ツールバー(左側)の [Adb Log] コマンドを使用します。ログファイルごとに別々の [ADB Log] タブを開くことができます。タブを削除するには、
アイコンをクリックします。[選択] フィールドを使用して、表示する特定のロギング コンポーネントを選択し、[重大度] プルダウンを使用して、ログの重大度が一致するエントリのみを表示します。
選択した adb ログに対して、[Filter] フィールドとオプションの [Case-sensitive] 修飾子または [Regex] 修飾子を使用すると、ログエントリをフィルタリングできます。
さらに、次のことが可能です。
- 特定のエントリを検索するには、[Find] フィールド、次を検索( アイコン)および前を検索( アイコン)コマンドを使用します。
- Use optional Case-sensitive or Regex modifiers.
- 行に移動: ログ内の指定した行(番号順)に移動します。
[番号付き] を選択すると、行番号が追加されたログ行が表示されます。[未加工] を選択すると、未加工のログエントリが表示されます。
![adb ログ閲覧者](https://developers.home.google.com/static/tools/images/android-studio-adb-logs.png?authuser=5&hl=ja)
リソースとフィードバック
[リソース] をクリックすると、デベロッパー ツールとリソースの一覧が表示されます。
Google Home Plugin の開発エクスペリエンスについてご意見やフィードバックをお送りいただく場合は、[フィードバック] をクリックしてください。
![フィードバックを送信](https://developers.home.google.com/static/tools/images/android-studio-resources.png?authuser=5&hl=ja)