Google Home Playground

デバイス SDK

Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.

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

Home Playground を使用するには、まずツールをアカウントにリンクすることをおすすめします。Google Home app (GHA) on your phone, and go through the account linking process: を開く

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

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

ログイン

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

Playground を起動

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

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

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

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

仮想デバイス

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

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

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

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

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

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

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

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

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

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

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

仮想デバイスに予備のユーザー確認を追加する

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

デバイスで SUV を構成する

1. [デバイスリスト] パネルで、設定する仮想デバイスを選択します。
2. [デバイス情報] パネルで [SUV] タブを選択し、次のように設定します。
   • Enabled: デバイスで SUV が有効か無効か（チャレンジなし）。
   • チャレンジ タイプ: SUV に明示的な確認応答（ackNeeded）または個人識別番号（pinNeeded）が必要かどうか。
   • PIN:有効な PIN。
   • PIN が正しくない場合の対処: PIN が間違っている場合は、ユーザーに再度尋ねるかどうかを指定します。そうでない場合は、エラーを返します。

SUV を利用できるデバイスを特定する

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

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

• ArmDisarm
• LockUnlock
• OpenClose
• Reboot
• SoftwareUpdate

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

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

仮想デバイスを削除する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

フィードバックと問題の報告

右上のスマイル顔アイコン sentiment_satisfied をクリックしてフィードバックを送信するか、感嘆符アイコン フィードバックを使用して問題を報告してください。