Google Home Developer Center へようこそ。スマートホームアクションの開発方法を学習できます。注: アクションの構築は、引き続き Actions Console で行います。

このページは Cloud Translation API によって翻訳されました。

Google Home Playground

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 Home Playground と Home Graph のインタラクションログが表示されます。このログを展開してリクエストとレスポンスのペイロードを調査し、トラブルシューティングを行うことができます。

仮想デバイス

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

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

基本情報: デバイスの最上位プロパティ（デバイスのタイプ、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 が有効か無効か（no challenge）。
- チャレンジの種類: SUV が明示的な確認応答（ackNeeded）と個人識別番号（pinNeeded）のどちらを必要とするかを指定します。
- PIN: 有効な PIN。
- PIN が正しくない場合の処理: PIN が正しくない場合、ユーザーにもう一度尋ねるかどうか、尋ねない場合は返すエラー。

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

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

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

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

SUV が必要なトレイトは次のとおりです。

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

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

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

仮想デバイスを削除する

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

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

SYNC レスポンスエディタ

同期レスポンスを検証または更新するには、Google Home Playground を使用します。[Sync Response Editor] をクリックして、埋め込み IDE を開きます。

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

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

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

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

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

をクリックして、仮想デバイスをファイルにエクスポートします。
エクスポートするファイル名を入力して [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 でサポートされている現在のデバイスタイプとトレイトのリストが表示されます。

問題を報告する

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

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