Google Home Playground

デバイス SDK

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: デバイスの Secondary User Verification の構成。

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

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

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

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

仮想デバイスに Secondary User Verification を追加する

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

デバイスで SUV を構成する

1. [デバイスリスト] パネルで、構成する仮想デバイスを選択します。
2. [Device info] パネルで [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. インポートするファイルが確認されると、Google Home Playground はファイルから状態を含む仮想デバイスをインポートし、インポートされたデバイスの情報と状態を Home Graph で更新します。

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

仮想デバイスを操作すると、Google 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 呼び出しのレスポンスの本文。各メソッドの形式については、リファレンス ドキュメントをご覧ください。

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

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

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

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