Android Studio 用 Google Home プラグイン

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Google Home Plugin for Android Studio は、Google Home Platform のデベロッパー向けに設計、作成されています。このプラグインを使用すると、Google Assistant Simulator、Cloud Logging などのツールにアクセスして、スマートホーム開発プロセスを簡素化できます。

Android Studio 用 Google Home プラグイン

セキュリティ通知

Android Studio にシークレットとパスワードが保存されないようにするには、次の手順を行います。

  1. [File]、[Settings...] の順にクリックします。
  2. [Appearance & amp; Behavior] で [System Settings] を展開し、[Passwords] をクリックします。
  3. [保存せず、再起動後にパスワードを保存する] を選択します。
Android Studio 用 Google Home プラグイン

機能

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

スマートホーム デバイスが 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 メッセージを表示します。

リアルタイム ログを表示したり、期間を指定したりできます。

Cloud Logging ビュー

バッチ発話

1 つの発話に対する Assistant Simulator レスポンスは確定的ではありません。たとえば、次のいずれかのフレーズが返されます。

  • 2 個のライトを点灯します。
  • 2 個のライトを点灯します。
  • 2 個のライトを点灯します。
  • 2 個のライトを点灯します。

自動テストを実行して、Google との統合でこれらのさまざまなレスポンスがどのように機能するかを確認するには、発話スクリプトを実行してバッチ発話を Assistant Simulator に送信します。スクリプトを保存すると、レスポンスを収集し、クエリに対して複数のテストを実行できます。

ホームグラフ ビューア

ホームグラフ ビューアを使用すると、デバイスの状態を表示し、Google Home テストスイートをブラウザで起動できます。

インストール

Android StudioGoogle Home Plugin をインストールする手順は次のとおりです。

  1. Android Studio をダウンロードまたは更新します。

    Android Studio をダウンロードする

  2. [File] > [Settings](MacOS では [Android Studio] > [Preferences])に移動します。

  3. [Plugins] セクションで [Marketplace] に移動し、google home を検索します。

  4. ツールをインストールして Android Studio を再起動します。

プラグインは、JetBrains Marketplace から直接ダウンロードすることもできます。

セットアップ

プラグインをインストールしたら、Assistant Simulator を使用して Cloud Logging を表示する前に、次の手順を行う必要があります。

Google でログイン

Google ホームパネルからデベロッパー アカウントにログインして、Android Studio が Google サービスと通信することを承認できます。

  1. Android Studio ウィンドウの左側にある [垂直] タブ列の [Google Home] タブをクリックします。

  2. [ログイン] で [Google] をクリックし、ブラウザを起動します。

    Android Studio の Google ログイン
  3. スマートホーム デバイスにリンクしているアカウントを選択します。

  4. [Sign in with Google] の認証ページで、[Allow](許可)をクリックします。

  5. ブラウザ ウィンドウを閉じて、Android Studio に戻ります。

ログインするには、ログアウトするオプションが表示されます。

Cloud プロジェクトを選択

ログインしたら、プルダウンから [プロジェクト] を選択します。プロジェクト リストをフィルタするには、Filter 式(matter など)を入力し、Enter を押します。

[プロジェクト] プルダウンには、[フィルタ] に基づいて最初の 100 件のプロジェクトが読み込まれます。Android Studio を終了しても、選択内容は保持されます。

プロジェクトの選択

プロジェクト フィルタについては、Google Cloud リファレンスのクエリ パラメータをご覧ください。

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

Android StudioAssistant 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 ファイルで、CollectTest が機能します。

同じファイルまたは異なるファイル(lightslights(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 のタブを個別に開くことができます。

Cloud Logging のタブ

検索キーワード

選択したプロジェクトについて、[クエリ] フィールドを使用してログをフィルタすることもできます。たとえば、ログを light というキーワードでフィルタするには、次のようにします。

Cloud Logging クエリ

[QL を使用する] を選択して、Logging のクエリ言語を使用します。

Cloud 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/226/30/22 の日付を選択するには、[Before] と [After] を選択し、日付アイコン から日付を選択します。

ライブ プロジェクトのログを取得するには、[Real Time] を選択します。[停止] をクリックしてリアルタイム フィードを終了します。

重大度

プルダウンから [最小限の重要度] を選択することもできます。

クエリ結果

[取得] をクリックして、クエリ パラメータを送信します。

ログが読み込まれたら、任意のレコード をクリックして JSON ペイロードを展開します。もう一度 をクリックすると、メッセージ全体が表示されます。

必要に応じて、[フィルタ] ボックスにキーワードを入力して、ログ結果を絞り込めます。x をクリックしてフィルタを削除し、元の取得結果に戻ります。

Cloud Logging を表示する

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

デバイスを一覧表示するには、Google Home Plugin パネルから [Home Graph] を選択します。

[ 更新] をクリックして、選択したプロジェクトに関連付けられているデバイスのデバイス名デバイス IDデバイスタイプを表示します。複数のプロジェクトで Google Home Graph パネルを複数開くことができます。

デバイスが読み込まれたら、任意のレコード をクリックして JSON ペイロードを展開します。

ホームグラフ JSON ペイロード

[開く] と [閉じる] を使用して、デバイスの JSON ペイロードの表示と非表示を切り替えることもできます。

ホームグラフ JSON の展開と折りたたみ

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

ホームグラフ実行テスト

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

ホームグラフの完了したテスト

リソースとフィードバック

デベロッパー ツールとリソースの一覧については [リソース] をクリックします。

Google Home Plugin での開発エクスペリエンスの改善に関するご意見やフィードバックがございましたら、[フィードバック] をクリックしてください。

フィードバックを送信