スマートホーム Scene トレイトのスキーマ
action.devices.traits.Scene - このトレイトは、仮想デバイスを SCENE デバイスタイプとともに実装するために使用します。
詳しくは、シーンタイプに関するガイドをご覧ください。
たとえば、ユーザーがワンタッチでコマンドを分類できる場合（ライトを特定の色に設定する、さまざまなセキュリティ機能を順番に並べる、その他のアクティビティを組み合わせるなど）は、SYNC を介して、名前付きのシーンとして公開できます。アシスタントは、以下のような場面を、シンプルなアクティベーション用文法によって利用できます。
- 「パーティー モードを始めて」
- 「ミッドナイト シーンを有効にして」
仮想オブジェクトとして、明確化のためにシーンを部屋に配置することもできます。
- 「キッチンでパーティー タイムを始めて」
- 「寝室で常夜灯モードを有効にして」
シーンと物理ターゲットの違いの 1 つは、アシスタントが自動的にシーンコマンドに複数の効果を適用し、ユーザーが複数のパートナーにまたがってシーンをトリガーできるようになることです。たとえば、ユーザーが 2 つのパートナーに「パーティー モード」のシーンを持っていて、1 つはセキュリティ用、もう 1 つはライト用の場合、「パーティー モードを有効にして」と言うと両方がトリガーされます。
シーンは、近日公開するカスタム文法のためのパーソナル アクションとうまくやり取りできます（たとえば「パーティー モードを有効にして」→「パーティーを始めよう」）。
シーンには、デフォルトの「B 社のシーン」といった名前ではなく、必ずユーザー指定の名前を付ける必要があります。各シーンは、それぞれ独自の名前を持つ独自の仮想デバイスです。ユーザー指定の名前は SYNC から取得されます。
デバイスの属性
この特性を持つデバイスは、SYNC オペレーションの一部として次の属性を報告する可能性があります。SYNC インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
| 属性 | タイプ | 説明 |
|---|---|---|
sceneReversible |
ブール値 |
（デフォルト: このシーンをキャンセルできることを示します。この属性は、状態を変更して前の状態を記憶するシーンにのみ関連します。デバイスは、 |
例
反転可能なシーンをサポートするデバイス。
{
"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
}
}