Google Home Developer Center への移行が完了しました。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Google Home Playground

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

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

Google Home Playground を使用するには、まずツールをアカウントにリンクすることをおすすめします。スマートフォンで Google Home app (GHA) を開き、 Google Home アプリでサードパーティ製スマートホームデバイスを接続するに記載されているアカウントへの関連付けプロセスを行います。

「Google Home Playground 」という統合を検索します。
統合を選択すると、GHA のログインページが表示されます。[Sign in with Google]（Google でログイン）をタップし、アカウントを選択してログインします。
[Authorize]（承認）ボタンをタップして、アカウントのリンクを承認します。

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

この図は、Google Home Playground をアカウントに正しくリンクしたときに表示されるデフォルトのデバイスリストを示しています。

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

仮想デバイス

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

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

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

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

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

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

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

この図は、Google Home Playground で選択したデバイスでサポートされているトレイトを追加または削除するための UX ツールを示しています。

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

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

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

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

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

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

デバイスで SUV を構成する

[デバイスリスト] パネルで、構成する仮想デバイスを選択します。
[デバイス情報] パネルで、[SUV] タブを選択し、次の項目を構成します。
- Enabled: デバイスで SUV が有効か無効か（チャレンジなし）。
- チャレンジタイプ: SUV で明示的な確認応答（ackNeeded）が必要か、個人識別番号（pinNeeded）が必要か。
- PIN: 有効な PIN。
- Handling of incorrect PIN: PIN が間違っている場合に、ユーザーに再度入力を求めるかどうか。求めない場合は、どのエラーを返すか。

この図は、Google Home Playground で選択したデバイスで Secondary User Verification トレイトを有効にするための UX ツールを示しています。

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

[**デバイスリスト**] パネルで、[**鍵アイコン**] key が有効になっている各デバイスの横に表示されます。

この図は、二次的なユーザー確認を有効にすることが推奨されるデバイスを示しています。

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

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

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

この図は、Google Home Playground で新しいデバイスタイプを追加するための UX ツールを示しています。

仮想デバイスを削除する

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

この図は、Google Home Playground で仮想デバイスタイプを削除するための UX ツールを示しています。

SYNC レスポンスエディタ

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

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

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

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

この図は、Google Home Playground で仮想デバイスをインポートまたはエクスポートするための UX ツールを示しています。

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

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

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

をクリックして、仮想デバイスをファイルからインポートします。
インポートするファイルを選択して [OK] をクリックします
ファイルを確定すると、Google Home Playgroundファイルから仮想デバイスとその状態がインポートされ、インポートされたデバイスの情報と状態がHome Graphに適用されます。

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

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

各ログエントリは、次のような構造の要素を含む 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。

問題を報告する

ご意見をお聞かせください。右上にある 感嘆符アイコン のフィードバックを使用して、発生した問題を報告してください。

この図は、Google Home Playground でフィードバックを提供したり問題を報告したりするためのアイコンを示しています。