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. こうした状態の変更はログ領域で確認できます。

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

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

デバイスで SUV を構成する

1. [デバイスリスト] パネルで、構成する仮想デバイスを選択します。
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 でサポートされている現在のデバイスタイプとトレイトのリストが表示されます。

問題を報告する

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