Google Home Playground は、設定可能なデバイスタイプとトレイトでスマートホーム プロジェクトをシミュレートするウェブ アプリケーションです。仮想デバイスの作成、デバイスの属性や状態の変更、Google Home Graph でのデバイスの表示、デバイス構成のインポートやエクスポートを行うことができます。
アカウントのリンクを完了する
Google Home Playground を使用するには、最初にツールをツールにリンクすることをおすすめします。スマートフォンで Google Home app (GHA) を開き、アカウントのリンク プロセスを行います。
- 左上の [+] アイコンをクリックします。
- [デバイスのセットアップ] > [Google と連携させる] を選択します。
- 「Google Home Playground」というアクションを検索します。
- アクションを選択すると、GHA によってログインページが表示されます。[Google でログイン] をクリックし、アカウントを選択してログインします。
- [Authorize]（承認）ボタンをタップして、アカウントのリンクを承認します。
アカウントのリンクが完了すると、デフォルトの仮想デバイスのリストが GHA に表示され、操作できるようになります。
ログイン
下のボタンをクリックして Google Home 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 に保存されている情報を直接編集することもできます。
サポートされているトレイトを変更する
- [Traits] タブを選択し、[Edit]（編集）ボタンをクリックします。
- ポップアップ パネルに、デバイスで現在サポートされているトレイトと追加可能なトレイトが表示されます。デバイスでサポートされているトレイトを追加または削除するには、矢印
（arrow_forward/arrow_back） ボタンを使用します。 - サポートされているトレイトの変更が完了したら、[Save]（保存）をクリックします。トレイトの変更が Home Graph に適用されます。
- こうしたトレイトの変更はログ領域で確認できます。
デバイスの属性を変更する
- [Attributes] タブを選択し、デバイスでサポートされているトレイトの属性を編集します。
- 編集が完了したら Enter キーを押します。属性の変更が Home Graph に適用されます。
- こうした属性の変更はログ領域で確認できます。
デバイスの状態を変更する
- [States] タブを選択し、状態を直接変更します。状態の変更は Home Graph に適用されます。
- こうした状態の変更はログ領域で確認できます。
仮想デバイスに Secondary User Verification を追加する
SUV を仮想デバイスに追加して、チャレンジの種類と各デバイスで対応する動作を構成できます。SUV を仮想デバイスに追加して、チャレンジの種類と各デバイスでの対応する動作を構成できます。
デバイスで SUV を構成する
- [デバイスリスト] パネルで、構成する仮想デバイスを選択します。
- [Device info] パネルで [SUV] タブを選択して、次のように設定します。
SUV を有効にするデバイスを特定する
[デバイスリスト] パネルで、各 SUV 対応デバイスの横に鍵アイコン キーが表示されます。
次のトレイトには SUV が必要です。
新しい仮想デバイスを作成する
- [デバイスリスト] パネルで、[デバイスを追加] をクリックします。
- ポップアップ パネルでデバイスタイプを選択し、新しいデバイスの名前を入力します。事前定義されたデバイスのセットを選択して追加することもできます。
- すべての手順を完了すると、新しいデバイスが Home Graph に追加されます。
仮想デバイスを削除する
- [デバイスリスト] パネルで、削除するデバイスを選択します。
次に、[デバイス情報] パネルで [基本情報] タブを選択し、[デバイス情報] パネルで [基本情報] タブを選択して、下部にある [削除] をクリックします。
- 表示されたポップアップ アラートでデバイスの削除を確定します。
- デバイスの削除を確定すると、デバイスが Home Graph から削除されます。
同期レスポンス編集者
同期レスポンスは Google Home Playground で検証または更新できます。[Sync Response Editor] をクリックして埋め込み IDE を開きます。
同期レスポンスを編集またはコピーして貼り付け、[保存] をクリックして変更を適用し、Google Home エコシステムでの動作を確認します。
仮想デバイスのインポートとエクスポート
事象のトラブルシューティングや再現を行う場合は、他の人が仮想デバイスをインポートして複製できるように、仮想デバイスの状態をファイルにエクスポートして共有します。
仮想デバイスをファイルにエクスポートする
- 仮想デバイスをファイルにエクスポートするには、[] をクリックします。
- エクスポートするファイル名を入力して [OK] をクリックします。
- エクスポートされた仮想デバイスのファイルが、ブラウザによってダウンロードされます。
仮想デバイスをファイルからインポートする
- [] をクリックして、ファイルから仮想デバイスをインポートします。
- インポートするファイルを選択して [OK] をクリックします。
- インポートするファイルが確認されると、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 でサポートされている現在のデバイスタイプとトレイトのリストが表示されます。
問題を報告する
問題が発生した場合は、右上の感嘆符アイコン フィードバックを使用して問題を報告してください。
