Google Home Playground

Cloud-to-cloud    Local Home SDK    Home APIs

Google Home Playground は、設定可能なデバイスタイプとトレイトでスマート ホーム プロジェクトをシミュレートするためのウェブ アプリケーションです。仮想 デバイスを作成する、デバイスの属性や状態を変更する、仮想デバイスを Google Home Graphに表示する、デバイス構成をインポートまたはエクスポートする、といった操作を行うことができます。

アカウントのリンクを完了する

Google Home Playground を使用するには、まず ツールをアカウントにリンクすることをおすすめします。スマートフォンでGoogle Home app (GHA)を開き、 Google Home アプリでサードパーティ製スマートホーム デバイスを接続するの手順に沿ってアカウントへの関連付けを行います。

  1. 「Google Home Playground 」という統合を検索します。
  2. 統合を選択すると、GHA のログインページが表示されます。[Sign in with Google]（Google でログイン）をタップし、アカウントを選択してログインします。
  3. [Authorize]（承認）ボタンをタップして、アカウントのリンクを承認します。
この図は、Google Home Playground を接続するための Google Home アプリ アカウントのリンク フローを示しています。

アカウントのリンクが完了すると、デフォルトの仮想デバイスのリストが GHAに表示され、操作できるようになります。

この図は、Google Home Playground をアカウントに正しくリンクしたときに表示されるデフォルトのデバイスリストを示しています。

ログイン

下のボタンをクリックして Google Home Playground を起動します。

Playground を起動

[Sign in with Google]（Google でログイン）をクリックします。GHAで使用しているものと同じアカウントでログインして、アカウントのリンクを完了します。

この図は、Google Home Playground の初期状態を示しています。右上のログインボタンがハイライト表示されています。

ログインすると、Google Home Playground にHome Graphに保存されている仮想デバイスが表示されます。

この図は、Google Home Playground のデフォルト ビューに表示されたデバイスリスト、デバイス情報、ログ領域を示しています。

ウェブ UI は次の 3 つのパネルで構成されています。

  • デバイスリスト には、すべての仮想デバイスが表示されます。このパネルでは、特定の仮想デバイスを選択して情報を表示したり、仮想デバイスを作成したりできます。
  • デバイス情報 には、選択した仮想デバイスの情報が表示されます。 このパネルでは、この情報を編集したり、選択した仮想デバイスを削除したりすることもできます。
  • ログ領域 には、 Google Home Playground と Home Graph のインタラクション ログが表示されます。このログを展開してリクエストとレスポンスのペイロードを調査し、トラブルシューティングを行うことができます。

仮想デバイス

仮想デバイスの情報を表示する

[デバイスリスト] パネルで、表示する仮想デバイスを選択します。 [デバイスリスト] パネルで、表示する仮想デバイスを選択します。 [デバイス情報] パネルに、以下の 5 つのタブに分類された情報が表示されます。

  • [Basic information]（基本情報）: デバイスの最上位プロパティ（デバイスのタイプ、ID、名前など）。
  • [Traits]（トレイト）: デバイスでサポートされているトレイト。
  • [Attributes]（属性）: デバイスのトレイト固有の属性。
  • [States]（状態）: すべてのデバイスの状態。
  • [**SUV**]（二次的なユーザー確認）: デバイスの二次的なユーザー確認の設定。

仮想デバイスの情報を編集する

仮想デバイスの情報を確認するだけでなく、 情報をHome Graphから [Device info] パネルで直接編集することもできます。

サポートされているトレイトを変更する

  1. [Traits] タブを選択し、[Edit]（編集）ボタンをクリックします。
  2. ポップアップ パネルに、デバイスで現在サポートされているトレイトと追加可能なトレイトが表示されます。デバイスでサポートされているトレイトを追加または削除するには、矢印 (arrow_forward/arrow_back)ボタンを使用します。
  3. サポートされているトレイトの変更が完了したら、[Save]（保存）をクリックします。 トレイトの変更がHome Graphに適用されます。
  4. こうしたトレイトの変更はログ領域 で確認できます。
この図は、Google Home Playground で選択したデバイスでサポートされているトレイトを追加または削除するための UX ツールを示しています。

デバイスの属性を変更する

  1. [Attributes] タブを選択し、デバイスでサポートされているトレイトの属性を変更します。
  2. 編集が完了したら、Enter キーを押すと、属性の変更が Home Graphに適用されます。
  3. こうした属性の変更はログ領域 で確認できます。

デバイスの状態を変更する

  1. [States] タブを選択し、状態を直接変更します。状態の変更が に適用されますHome Graph。
  2. こうした状態の変更はログ領域 で確認できます。

仮想デバイスに二次的なユーザー確認を追加する

仮想デバイスに SUV を追加し、各デバイスでチャレンジ タイプと対応する動作を設定できます。 仮想デバイスに SUV を追加し、各デバイスでチャレンジ タイプと 対応する動作を設定できます。

デバイスで SUV を設定する

  1. [デバイスリスト] パネルで、設定する仮想デバイスを選択します。
  2. [デバイス情報] パネルで、[SUV] タブを選択し、次の項目を設定します。
    • 有効: デバイスで SUV を有効にするか無効にするか（チャレンジなし）。
    • チャレンジ タイプ: SUV で明示的な確認応答 (ackNeeded) が必要か、 個人識別番号（pinNeeded）が必要か。
    • PIN:有効な PIN。
    • Handling of incorrect PIN （不正な PIN の処理）: PIN が間違っている場合に、ユーザーに再度入力を求めるかどうか。求めない場合は、どのエラーを返すか。
この図は、Google Home Playground で選択したデバイスで Secondary User Verification トレイトを有効にするための UX ツールを示しています。

SUV を有効にするデバイスを特定する

[**デバイスリスト**] パネルで、[**鍵アイコン**] key が有効になっている各デバイスの横に表示されます。

この図は、二次的なユーザー確認を有効にすることが推奨されるデバイスを示しています。

次のトレイトでは SUV が必要です。

新しい仮想デバイスを作成する

  1. [デバイスリスト] パネルで [Add a device]（デバイスを追加）をクリックします。
  2. ポップアップ パネルでデバイスタイプを選択し、新しいデバイスの名前を入力します。事前定義されたデバイスのセットを選択して追加することもできます。
  3. すべての手順が完了すると、新しいデバイスが Home Graphに追加されます。
この図は、Google Home Playground で新しいデバイスタイプを追加するための UX ツールを示しています。

仮想デバイスを削除する

  1. [デバイスリスト] パネルで、削除するデバイスを選択します。 次に、[デバイス情報] パネルで [Basic Information]（基本情報）タブを選択し、 次に、[デバイス情報] パネルで [Basic Information]（基本情報）タブを選択し、 下部の ゴミ箱アイコン[Remove device]（デバイスを削除）をクリックします。
  2. 表示されたポップアップ アラートでデバイスの削除を確定します。
  3. デバイスの削除を確定すると、デバイスが Home Graphから削除されます。
この図は、Google Home Playground で仮想デバイスタイプを削除するための UX ツールを示しています。

SYNC レスポンス エディタ

Google Home Playground で同期レスポンスを検証または更新できます。 [Sync Response Editor]（SYNC レスポンス エディタ）をクリックして、埋め込み IDE を開きます。

この図は、同期レスポンス エディタを開くボタンを示しています。

同期レスポンスを編集またはコピーして貼り付け、[Save]（保存）をクリックして変更を適用すると、Google Home エコシステムでの動作を確認できます。

この図は、同期レスポンスを編集するウィンドウを示しています。

仮想デバイスのインポートとエクスポート

事象のトラブルシューティングや再現を行う場合は、他の人が仮想デバイスをインポートして複製できるように、仮想デバイスの状態をファイルにエクスポートして共有します。

この図は、Google Home Playground で仮想デバイスをインポートまたはエクスポートするための UX ツールを示しています。

仮想デバイスをファイルにエクスポートする

  1. をクリックして、仮想デバイスをファイルにエクスポートします。
  2. エクスポートするファイル名を入力して [OK] をクリックします。
  3. ファイル名を入力すると、エクスポートされた仮想デバイスのファイルがブラウザによってダウンロードされます。

仮想デバイスをファイルからインポートする

  1. をクリックして、仮想 デバイスをファイルからインポートします。
  2. インポートするファイルを選択して [OK] をクリックします
  3. ファイルを確定すると、Google Home Playgroundファイルから仮想デバイスとその状態が インポートされ、インポートされた デバイスの情報と状態がHome Graphに適用されます。

インタラクション ログを調べる

仮想デバイスを操作すると、Google Home Playground 変更が自動的にHome Graphに適用されます。 とのインタラクションはログ領域 に記録されます。ログ領域の各エントリを展開すると、 API のリクエストとレスポンスのペイロードを調べることができます。Home GraphHome Graph

各ログエントリは、次のような構造の要素を含む JSON 配列です。

{
  "uri": string,
  "request": object,
  "response": object
}
フィールド タイプ 説明
uri string Home Graph API 呼び出しの URL。
request object Home Graph API 呼び出しのリクエストの本文。各メソッドの形式については、 リファレンス ドキュメント リファレンス ドキュメント をご覧ください。
response object Home Graph API 呼び出しのレスポンスの本文。各メソッドの形式については、 リファレンス ドキュメント リファレンス ドキュメント をご覧ください。

サポートされているデバイスタイプとトレイトを表示する

右上の疑問符 ヘルプ アイコンをクリックすると、その時点でサポートされているデバイスタイプとトレイトのリストが表示されます Google Home Playground。

この図は、Google Home Playground で新しいデバイスタイプを追加するための UX ツールを示しています。

問題を報告する

ご意見をお聞かせください。右上にある 感嘆符アイコン フィードバックを使用して、発生した問題を報告してください。

この図は、Google Home Playground でフィードバックを提供したり問題を報告したりするためのアイコンを示しています。