スマートホームの Rotation トレイトのスキーマ
action.devices.traits.Rotation
- このトレイトは、回転をサポートするデバイスに属します。
回転はパーセントまたは度で指定できます。デバイスが角度の回転をサポートしている場合、デフォルトの回転方向は時計回りです。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性をレポートできます。SYNC
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
supportsDegrees |
ブール値 |
必須。 度単位での回転が可能な場合は true に設定します。 |
supportsPercent |
ブール値 |
必須。 デバイスで割合による回転が許可されている場合は true に設定します。 |
rotationDegreesRange |
温度計 |
デバイスが回転できる範囲を度数で表します。 |
rotationDegreesMin |
番号 |
必須。 最小回転(度単位)。 |
rotationDegreesMax |
番号 |
必須。 最大回転角度(度単位)。 |
supportsContinuousRotation |
ブール値 |
(デフォルト: デバイスで連続回転が許可されている場合は、true に設定します。相対クエリを指定すると、 |
commandOnlyRotation |
ブール値 |
(デフォルト: デバイスが一方向(true)または双方向(false)の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
例
パーセントと度の両方の回転をサポートするデバイス。
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
角度の回転しかサポートしていないデバイス。
{ "supportsDegrees": true, "supportsPercent": false, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 90 } }
連続回転コマンドのみをサポートするデバイス。
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 360 }, "supportsContinuousRotation": true, "commandOnlyRotation": true }
デバイスのステータス
このトレイトを持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
rotationDegrees |
番号 |
デバイスが何度回転したかを示す |
rotationPercent |
番号 |
デバイスが現在何パーセント回転しているかを示す現在のレベル。0.0 は閉位置に対応し、100.0 は開位置に対応します。 |
例
デバイスはどの程度回転させますか?(パーセントと度)。
{ "rotationDegrees": 45, "rotationPercent": 25 }
デバイスはどの程度回転させますか?(度数のみ)。
{ "rotationDegrees": 45 }
デバイスはどの程度回転させますか?(連続)。
{ "rotationDegrees": 270, "rotationPercent": 75 }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.RotateAbsolute
デバイスの絶対回転を設定します。
パラメータ
ペイロードには、次のいずれかが含まれています。
絶対回転を度単位で設定します。
パラメータ | タイプ | 説明 |
---|---|---|
rotationDegrees |
番号 |
必須。 デバイスの最終的な時計回りの回転を指定する度単位の絶対値。値は |
絶対回転をパーセンテージで設定します。
パラメータ | タイプ | 説明 |
---|---|---|
rotationPercent |
番号 |
必須。 デバイスの最終的な回転をパーセンテージで指定する絶対値。 |
例
デバイスを 50% まで傾けます。
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationPercent": 50 } }
デバイスを反時計回り(rotationDegrees: 45
)に 15 度回転させます。
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 30 } }
デバイスを時計回りに 100 度回転(supportsContinuousRotation: true
、rotationDegrees: 270
)します。
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 10 } }
関連エラー
デバイスの回転の設定中にエラーが発生しました。
サポートされている値:
deviceJammingDetected