Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。

Google Home Playground

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

デバイス SDK

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

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

Home Playground を使用するには、まずこのツールをアカウントにリンクすることをおすすめします。スマートフォンで Google Home app (GHA) を開き、アカウントのリンク プロセスを行います。

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

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

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

ログイン

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

Playground を起動

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

この図は、Google Home Playground の初期状態を示しています。右上のログインボタンがハイライト表示されています。

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

この図は、Google Home Playground のデフォルト ビューに表示されたデバイスリスト、デバイス情報、ログ領域を示しています。

ウェブ UI は、

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

仮想デバイス

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

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

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

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

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

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

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

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

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

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

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

仮想デバイスにセカンダリ ユーザー確認を追加する

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

デバイスで SUV を設定する

  1. [デバイスリスト] パネルで、構成する仮想デバイスを選択します。
  2. [Device info(デバイス情報)] パネルで [SUV] タブを選択して、次のように構成します。
    • Enabled: デバイスで SUV が有効か無効か(チャレンジなし)か。
    • チャレンジの種類: SUV に明示的な確認応答(ackNeeded)または個人識別番号(pinNeeded)が必要かどうか。
    • PIN: 有効な PIN。
    • PIN が正しくない場合の処理: PIN が間違っている場合は、ユーザーに再度確認するかどうかを指定します。そうでない場合は、エラーを返します。
この図は、Google Home Playground で選択したデバイスでセカンダリ ユーザー確認トレイトを有効にする UX ツールを示しています。

SUV に対応しているデバイスを特定する

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

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

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

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

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

仮想デバイスを削除する

  1. [デバイスリスト] パネルで、削除するデバイスを選択します。 次に、[Device info] パネルで、[Basic Information] タブを選択し、下部にある [ゴミ箱アイコンRemove device] をクリックします。
  2. 表示されたポップアップ アラートでデバイスの削除を確定します。
  3. デバイスの削除を確定すると、デバイスは Home Graph から削除されます。
この図は、Google Home Playground で仮想デバイスタイプを削除するための UX ツールを示しています。

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

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

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

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

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

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

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

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

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

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

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