Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

スマートホーム Scene トレイトのスキーマ

action.devices.traits.Scene - このトレイトは、仮想デバイスを SCENE のデバイスタイプと一緒に実装するために使用されます。

詳しくは、シーンタイプ ガイドをご覧ください。

たとえば、デバイスでコマンドのワンタッチ グループ化の設定(ライトの特定の色の設定、さまざまなセキュリティ機能の順序付け、その他のアクティビティの組み合わせなど)をサポートしている場合、この構成は SYNC という名前付きシーンとして公開し、アシスタントはシンプルなアクティベーション文法によってこうしたシーンをユーザーに提供します。

  • 「パーティー モードを始めて」
  • 「ミッドナイト シーンを有効にして」

仮想オブジェクトとして、明確化のためにシーンを部屋に配置することもできます。

  • 「キッチンでパーティー タイムを始めて」
  • 「寝室で常夜灯モードを有効にして」

シーンと物理ターゲットの違いの 1 つは、アシスタントが自動的にシーンコマンドに複数の効果を適用し、ユーザーが複数のパートナーにまたがってシーンをトリガーできるようになることです。たとえば、ユーザーが 2 つのパートナーに「パーティー モード」のシーンを持っていて、1 つはセキュリティ用、もう 1 つはライト用の場合、「パーティー モードを有効にして」と言うと両方がトリガーされます。

シーンは、近日公開するカスタム文法のためのパーソナル アクションとうまくやり取りできます(たとえば「パーティー モードを有効にして」→「パーティーを始めよう」)。

シーンには、デフォルトの「B 社のシーン」といった名前ではなく、必ずユーザー指定の名前を付ける必要があります。各シーンは、それぞれ独自の名前を持つ独自の仮想デバイスです。ユーザー指定の名前は SYNC から取得できます。

デバイスの属性

このトレイトを持つデバイスは、SYNC オペレーションの一環として以下の属性を報告することがあります。SYNC インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

属性 タイプ 説明
sceneReversible ブール値

(デフォルト: false

このシーンをキャンセルできることを示します。この属性は、状態を変更して前の状態を記憶しているシーンにのみ関連します。デバイスは、deactivate パラメータを true に設定した ActivateScene コマンドをサポートします。

リバーシブル シーンをサポートするデバイス。

{
  "sceneReversible": true
}

デバイスのステータス

なし。

デバイスのコマンド

このトレイトを持つデバイスは、EXECUTE オペレーションの一環として次のコマンドに応答できます。EXECUTE インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

action.devices.commands.ActivateScene

シーンを有効または無効にします。

パラメータ

パラメータ タイプ 説明
deactivate ブール値

必須。

シーンを元に戻すことができる場合は true を、シーンを有効にする場合は false にします。

名前を指定してシーンを有効にします。

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

名前を指定してシーンを無効にします。

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

デバイスエラー

エラーと例外の完全なリストをご覧ください。