Google Home Playground

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

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

Google Home Playground を使用するには、まずツールをアカウントにリンクすることをおすすめします。スマートフォンで Google Home app (GHA) を開き、アカウントのリンク手順を行います。

1. 左上の [+] アイコンをクリックします。
2. [デバイスのセットアップ] > [Google と連携させる] を選択します。
3. 「Google Home Playground」というアクションを検索します。
4. アクションを選択すると、GHA からログインページに移動します。[Google でログイン] をクリックし、アカウントを選択してログインします。
5. [Authorize]（承認）ボタンをタップして、アカウントのリンクを承認します。

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

ログイン

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

Playground を起動

[Google でログイン] をクリックします。アカウントのリンクを完了するには、GHA で使用したものと同じアカウントでログインしてください。

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

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

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

仮想デバイス

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

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

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

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

デバイス情報パネルでは、仮想デバイスの情報を確認するだけでなく、Home Graph に保存されている情報を直接編集することもできます。

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

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

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

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

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

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

仮想デバイスに 2 回目のユーザー確認を追加する

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

デバイスで SUV を構成する

1. [Device list] パネルで、構成する仮想デバイスを選択します。
2. [デバイス情報] パネルで [SUV] タブを選択し、以下の構成を行います。
   • Enabled: デバイスで SUV が有効か無効か（no challenge）。
   • チャレンジの種類: SUV が明示的な確認応答（ackNeeded）と個人識別番号（pinNeeded）のどちらを必要とするかを指定します。
   • PIN: 有効な PIN。
   • PIN が正しくない場合の処理: PIN が正しくない場合、ユーザーにもう一度尋ねるかどうか、尋ねない場合は返すエラー。

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

[デバイスリスト] パネルに、SUV 対応デバイスの横に鍵アイコン 鍵が表示されます。

SUV が必要なトレイトは次のとおりです。

• ArmDisarm
• LockUnlock
• OpenClose
• 再起動する
• SoftwareUpdate

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

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

仮想デバイスを削除する

1. [デバイスリスト] パネルで、削除するデバイスを選択します。次に、[デバイス情報] パネルで [基本情報] タブを選択し、[デバイス情報] パネルの [基本情報] タブを選択して、下部にある [デバイスを削除] をクリックします。
2. 表示されたポップアップ アラートでデバイスの削除を確定します。
3. デバイスの削除を確定すると、デバイスが Home Graph から削除されます。

SYNC レスポンス エディタ

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

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

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

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

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

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

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

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

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

仮想デバイスを操作すると、Google Home Playground が変更を自動的に Home Graph に適用します。Home Graph とのやり取りは [ログ領域] パネルに記録されます。このパネルでは、各エントリを開いて Home Graph API リクエストとレスポンスのペイロードを調べることができます。

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

{
  "uri": string,
  "request": object,
  "response": object
}

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

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

問題を報告する

右上の感嘆符アイコン フィードバックを使用して、発生した問題を報告します。