Android Studio 用 Google Home プラグイン

Google Home Plugin for Android Studio は Google のために設計、開発されました ホーム プラットフォームのデベロッパー。このプラグインを使用すると、 Google Assistant Simulator、Cloud Logging、その他のツールで スマートホームの開発プロセスも 進めています

Android Studio 用 Google Home プラグイン

セキュリティ通知

Android Studio でシークレットとインスタンスの保存が行われないようにするには、 次の手順を完了します。

  1. [File]、[Settings...] の順にクリックします。
  2. [デザインと[Behavior] > [System Settings] を開き、 パスワード
  3. [再起動後にパスワードを保存しない] を選択します。
Android Studio 用 Google Home プラグイン

機能

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

スマートホーム デバイスが Google Home で正しく動作するかどうかをテストするには いつでもどこでも Assistant Simulator を利用できます。 出発駅: Android Studio

既存のアシスタントと類似 シミュレータの提供 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 Debug Bridge(adb)ログビューア

adb ログビューアは、ログファイルを表示および分析するためのツールです。たとえば、 Matter デバイスのログファイル、Google Home のログ、Android できます。

インストール

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

  1. Android Studio をダウンロードまたは更新します。 <ph type="x-smartling-placeholder"> Android Studio をダウンロードする
  2. [ファイル] >設定Android Studio > 環境設定を参照)。
  3. [Plugins] セクションで [Marketplace] に移動し、 google home
  4. ツールをインストールして Android Studio を再起動します。

また、 JetBrains マーケットプレイス

セットアップ

プラグインをインストールしたら、次の手順を Assistant Simulator と Cloud Storage を使用するには、 Cloud Logging を表示します。

Google でログイン

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

  1. 左側の縦方向のタブ列にある [Google Home] タブをクリックします クリックします。Android Studio

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

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

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

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

これでログインが完了し、[Sign Out] のオプションが表示されます。

Cloud プロジェクトを選択

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

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

プロジェクトの選択

プロジェクト フィルタについて詳しくは、このモジュールの クエリ パラメータ ご覧ください。

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

Android StudioAssistant Simulator を開くには、 Google Home Plugin パネルの [発話パネル] をクリックします。

発話パネルを開く

Assistant Simulator にクエリを送信するには、いくつかの方法があります。次に 各オプションを説明します

クエリを入力して回答を収集する

Assistant Simulator を操作するには、クエリを入力して Enter キーを押します。

クエリを再送信するには、 末尾にある 再送信アイコン 検索できます。

1 つ以上のクエリを送信したら、 [リプレイ] をクリックすると、 レスポンスを確認します。[Utterances] パネルでは、 キャッシュに格納します[リプレイ] を選択すると、 保存されるため、クリックしてもクエリが重複することはありません。 ] ボタンを離します。

アシスタント シミュレータで発話を再生する

[ 保存] をクリックしてクエリを保存し、 回答として [発話] パネル。次のように操作は 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] では、次のいずれかを選択できます。 ファイルまたはフォルダです。フォルダを選択すると、CollectTest が そのフォルダ内のすべての発話 .json ファイルを処理します。

たとえば、同じファイルまたは異なるファイルについて、複数のタブを開くことができます。 lightslights(1)plug

ステータスバーには、最後のテストの結果が表示されます(該当する場合)。 ファイルが収集されたことを示す黄色または緑色のドットが表示され、 発話 .json のファイルパス。[ 収集 Assistant Simulator がクエリを実行します。 新しい回答が収集されると通知が届き、ステータスバーにも情報が表示されるようになります。 クエリの処理中はカウンタが表示されます。

アシスタント シミュレータで発話を収集する

収集が完了すると、ステータスバーが更新され、緑色のチェックマークが表示されます。 が .json パスの前に置かれ、発話ファイルに 提示します。

<ph type="x-smartling-placeholder">
</ph> アシスタント シミュレータで発話を収集する
{
  "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 は、各クエリを実行してレスポンスを返します。 チェックが テストが成功した場合のステータスバー

<ph type="x-smartling-placeholder">
</ph> アシスタント シミュレータによる発話の実行

Cloud Logging を表示する

Cloud ログツール ウィンドウでプロジェクトのタブを開くには、[Cloud ログ] をクリックします。 [Google Home Plugin] パネルから行います。Cloud Log のタブを個別に開くと、 自動的に作成されます。

Cloud Logging のタブ

検索キーワード

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

Cloud Logging のクエリ

[Use 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 より前の日付を選択するには、[次の日付より前] を選択して、その日付をクリックします。 アイコン
  • 5/1/226/30/22 の日付を選択するには、[次の日付より前] を選択します。 [次の日付より後] を選択し、日付アイコンから日付を選択します。

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

重大度

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

クエリ結果

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

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

必要に応じて、[フィルタ] ボックスにキーワードを入力してログを絞り込むことができます。 表示されます。フィルタを解除して元の状態に戻すには、[x] をクリックします 結果を取得できます。

Cloud Logging を表示する

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

デバイスを一覧表示するには、メニューからホームグラフを選択します。 Google Home Plugin パネル。

[ [更新] をクリックして、 デバイスのデバイス名デバイス IDデバイスの種類 ロールが表示されます。1 つのテーブルに複数の 個別のプロジェクト用に Google Home Graph パネルが開きます。

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

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

[開く] と [閉じる] を使用して、JSON の表示と非表示を切り替えることもできます。 保存できます。

ホームグラフの JSON の開閉

特定のデバイス用にテストスイートを起動するには、次の手順を行います。 [テスト] をクリックします。これにより、ブラウザでテストスイートが起動し、 テストの準備ができました[開始] をクリックしてテストが完了するまで待ちます。 表示されます。

ホームグラフ実行テスト

テストが完了したら、テストの詳細やログを確認できます。

ホームグラフ完了済みテスト

Android Debug Bridge(adb)ログビューア

[Adb Log] ツール ウィンドウで [プロジェクト] タブを開くには、[Adb Log] コマンドをクリック をクリックします。個別の adb ログを開くことができます タブが表示されます。タブを削除するには、 アイコンをクリックします。

[選択] フィールドを使用して、表示する特定のロギング コンポーネントを選択し、 [重大度] プルダウンを使用すると、ログの重大度が一致するエントリのみが表示されます。

選択した adb ログについて、[Filter] を使用してログエントリをフィルタリングできます。 フィールドに、オプションの大文字と小文字を区別または正規表現の修飾子を付けたり、

さらに、次のことが可能です。

  • 特定のエントリを検索するには、[Find] フィールド、次を検索 アイコン)および前を検索 アイコン)コマンドを使用します。
  • 必要に応じて、大文字と小文字を区別する修飾子または正規表現の修飾子を使用します。
  • 行に移動: ログ内の指定した行(番号順)に移動します。

[番号付き] を選択すると、行番号が追加されたログ行が表示されます。[RAW] を選択します。 未加工ログエントリを表示できます

adb ログ閲覧者

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

[リソース] をクリックすると、デベロッパー ツールとリソースの一覧が表示されます。

開発の改善方法についてご意見やフィードバックを送信する Google Home Plugin の使用経験がある場合は、[フィードバック] をクリックします。

<ph type="x-smartling-placeholder">
</ph> フィードバックを送信