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

action.devices.traits.Rotation - このトレイトは、回転をサポートするデバイスに属します。

回転はパーセントまたは度で指定できます。デバイスが角度の回転をサポートしている場合、デフォルトの回転方向は時計回りです。

デバイスの属性

このトレイトを持つデバイスは、SYNC オペレーションの一部として次の属性をレポートできます。SYNC インテントの処理方法については、インテントのフルフィルメントをご覧ください。

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

必須。

度単位での回転が可能な場合は true に設定します。
supportsPercent ブール値

必須。

デバイスで割合による回転が許可されている場合は true に設定します。
rotationDegreesRange 温度計

デバイスが回転できる範囲を度数で表します。
rotationDegreesMin 番号

必須。

最小回転（度単位）。
rotationDegreesMax 番号

必須。

最大回転角度（度単位）。
supportsContinuousRotation ブール値

（デフォルト: false）

デバイスで連続回転が許可されている場合は、true に設定します。相対クエリを指定すると、RotateAbsolute コマンドは、サポートされている回転範囲をラップします。
commandOnlyRotation ブール値

（デフォルト: false）

デバイスが一方向（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 番号

デバイスが何度回転したかを示す rotationDegreesRange 内の現在のレベル。この値は常に時計回りの回転を基準とします。
rotationPercent 番号

デバイスが現在何パーセント回転しているかを示す現在のレベル。0.0 は閉位置に対応し、100.0 は開位置に対応します。

例

デバイスはどの程度回転させますか？（パーセントと度）。

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

デバイスはどの程度回転させますか？（度数のみ）。

{
  "rotationDegrees": 45
}

デバイスはどの程度回転させますか？（連続）。

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

デバイスのコマンド

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

action.devices.commands.RotateAbsolute

デバイスの絶対回転を設定します。

パラメータ

ペイロードには、次のいずれかが含まれています。

絶対回転を度単位で設定します。

パラメータ タイプ 説明
rotationDegrees 番号

必須。

デバイスの最終的な時計回りの回転を指定する度単位の絶対値。値は rotationDegreesRange 属性内で指定してください。

絶対回転をパーセンテージで設定します。

パラメータ タイプ 説明
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

デバイスエラー

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