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

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

action.devices.traits.Rotation - このトレイトはローテーションに対応しているデバイスです。

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

デバイスの属性

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

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

必須。

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

必須。

デバイスがパーセント単位で回転する場合は true に設定します。
rotationDegreesRange オブジェクト

デバイスが回転できる範囲を表します。
rotationDegreesMin Number

必須。

回転角度（最小値）。
rotationDegreesMax Number

必須。

最大回転角度（度）。
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 Number

デバイスが現在何度回転しているかを示す現在のレベル。rotationDegreesRangeこの値は常に時計回りに相対的である必要があります。
rotationPercent Number

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

例

デバイスはどのくらい回転していますか？（パーセンテージと度数）。

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

デバイスはどのくらい回転していますか？（学位のみ）。

{
  "rotationDegrees": 45
}

デバイスはどのくらい回転していますか？（続き）

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

デバイスのコマンド

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

action.devices.commands.RotateAbsolute

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

パラメータ

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

絶対回転角度を設定します。

パラメータ タイプ 説明
rotationDegrees Number

必須。

デバイスの最終的な時計回りの回転を指定する絶対値（度数）。値は rotationDegreesRange 属性の範囲内でなければなりません。

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

パラメータ タイプ 説明
rotationPercent Number

必須。

デバイスの最終回転を指定する絶対値（%）。

例

デバイスを 50% 傾けます。

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

デバイスを反時計回りに 15 度回転させます（rotationDegrees: 45）。

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

デバイスを時計回りに 100 度回転させます（supportsContinuousRotation: true、rotationDegrees: 270）。

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

デバイスの回転の設定中にエラーが発生しました。

サポートされている値:

deviceJammingDetected

デバイスエラー

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