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

action.devices.traits.FanSpeed - このトレイトは、ファンの速度を設定できるデバイスに使用します。

ファンの速度（つまり、デバイスからさまざまなレベルでの空気の吹き出し。 エアコンや暖房装置、車内など）では、低、中、高などの設定が含まれることがあります。 指定します。

デバイスの属性

このトレイトを持つデバイスは、以下をレポートすることがあります。 SYNC オペレーションの一部として使用できます。学習内容 SYNC インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

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

（デフォルト: false）。

true に設定した場合、このデバイスでは両方向のファンの風通しがサポートされ、ファンの向きを逆にするコマンドを使用できます。
commandOnlyFanSpeed ブール値

（デフォルト: false）。

デバイスが一方向（true）または双方向（false）の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。
次のいずれかを含む:
0 オブジェクト

速度設定のサポート。
availableFanSpeeds オブジェクト

必須。

デバイスでサポートされている速度設定。
speeds 配列

必須。

速度設定のリスト。
[item, ...] オブジェクト

速度設定。
speed_name String

必須。

速度設定の内部名。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。
speed_values 配列

必須。

サポートされている各言語での速度設定と同義語。
[item, ...] オブジェクト

特定の言語の速度設定と同義。
speed_synonym 配列

必須。

速度設定の同義語には、必要に応じて単数形と複数形の両方を含める必要があります。リスト内の最初の類義語が、速度設定の正規名になります。
[item, ...] String

同義。
lang String

必須。

言語コード（ISO 639-1）。サポートされている言語をご確認ください。
ordered ブール値

必須。

true に設定した場合、speeds 配列の順番（昇順）で増減ロジックの文法が適用されます。
1 オブジェクト

速度の割合をサポート。
supportsFanSpeedPercent ブール値

必須。

（デフォルト: false）。

true に設定した場合、このデバイスは速度を 0.0 ～ 100.0 の範囲で調整するコマンドを受け付けます。

例

2 種類の速度設定があるデバイス（逆方向と割合の調整をサポート）。

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

デバイスのステータス

このトレイトを持つエンティティは、以下を報告する場合があります。 複数の状態を QUERY オペレーションの一部として呼び出します。学習内容 QUERY インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

州 タイプ 説明
currentFanSpeedSetting String

これは、availableFanSpeeds 属性からの現在の速度設定の内部名を表します。
currentFanSpeedPercent 番号

現在のファンの速度をパーセンテージで示します。supportsFanSpeedPercent 属性が true に設定されている場合は必須

例

リビングの扇風機の速さは？

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

デバイスのコマンド

このトレイトを持つデバイスは、以下の動作に反応します。 コマンドを EXECUTE オペレーションの一部として使用できます。学習内容 EXECUTE インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

action.devices.commands.SetFanSpeed

速度を設定します。

パラメータ

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

速度は設定で設定できます。

パラメータ タイプ 説明
fanSpeed String

必須。

リクエストされたファンの速度設定。

速度をパーセントで設定します。

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

必須。

リクエストされた速度設定の割合。

例

ファンを強に設定して。

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

ファンを 50% に設定して。

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

相対的な速度を設定します。

このコマンドには、次の属性が必要です。 
{
  "commandOnlyFanSpeed": true
}

パラメータ

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

重量で相対的な速度を設定します。

パラメータ タイプ 説明
fanSpeedRelativeWeight 整数

必須。

この値は、速度の変化の相対的な量を示します。絶対値はスケーリングされた量を示し、数字記号は変化の方向を示します。

相対速度をパーセントで設定します。

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

必須。

この値は、変更する速度をパーセンテージで表します。

例

風量を少し下げて。

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

風量を 10% 上げて。

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

ファンの方向を逆にします。

このコマンドには、次の属性が必要です。 
{
  "reversible": true
}

パラメータ

パラメータ タイプ 説明

プロパティがありません

例

ファンの向きを逆にします。

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

サンプル音声

<ph type="x-smartling-placeholder">

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

デバイスエラー

詳しくは、 エラーと例外をご覧ください。
  • maxSpeedReached: デバイスはすでに最高速度に設定されています。
  • minSpeedReached: デバイスはすでに最小速度に設定されています。