スマートホームの FanSpeed トレイトのスキーマ
action.devices.traits.FanSpeed
- この特性は、ファンの速度の設定をサポートするデバイスに属します。
デバイスの属性
この特性を持つデバイスは、SYNC
オペレーションの一部として次の属性を報告する可能性があります。SYNC
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
reversible |
ブール値 |
(デフォルト: true に設定すると、ファンは両方向に送られるようになります。コマンドを受け入れてファンの方向を逆にすることができます。 |
commandOnlyFanSpeed |
ブール値 |
(デフォルト: デバイスが一方向(True)または双方向(False)の通信をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
次の項目が含まれます。 | ||
0
|
オブジェクト |
速度設定のサポート。 |
availableFanSpeeds |
オブジェクト |
必須。 デバイスでサポートされている速度設定です。 |
speeds |
配列 |
必須。 速度設定のリスト。 |
[item, ...] |
オブジェクト |
速度設定です。 |
speed_name |
文字列 |
必須。 速度設定の内部名。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。 |
speed_values |
配列 |
必須。 サポートされている各言語の速度設定の類義語です。 |
[item, ...] |
オブジェクト |
特定の言語での速度設定の類義語です。 |
speed_synonym |
配列 |
必須。 速度設定の類義語には、該当する場合は単数形と複数形の両方を含める必要があります。リスト内の最初の類義語は、速度設定の正規名と見なされます。 |
[item, ...] |
文字列 |
類義語 |
lang |
文字列 |
必須。 言語コード(ISO 639-1)。サポートされている言語をご覧ください。 |
ordered |
ブール値 |
必須。 true に設定すると、速度配列を増加(減少)させるための追加の文法が適用されます。 |
1
|
オブジェクト |
速度の割合に対するサポート。 |
supportsFanSpeedPercent |
ブール値 |
必須。 (デフォルト: 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 |
文字列 |
|
currentFanSpeedPercent |
Number |
現在のファン速度をパーセンテージで示します。 |
例
リビングルームのファンの速さはどのくらいですか?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
デバイスのコマンド
この特性を持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
action.devices.commands.SetFanSpeed
速度を設定します。
パラメータ
ペイロードには次のいずれかが含まれています。
速度は設定で設定できます。
パラメータ | タイプ | 説明 |
---|---|---|
fanSpeed |
文字列 |
必須。 ファンの速度設定のリクエストです。 |
速度をパーセンテージで設定します。
パラメータ | タイプ | 説明 |
---|---|---|
fanSpeedPercent |
Number |
必須。 リクエストされた速度設定の割合です。 |
例
扇風機の温度を高くする。
{ "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 |
Integer |
必須。 この値は、速度変化の相対的な量を示します。絶対値はスケーリングされた量を示し、数値記号は変化の方向を示します。 |
相対速度をパーセンテージで設定します。
パラメータ | タイプ | 説明 |
---|---|---|
fanSpeedRelativePercent |
Number |
必須。 この値は、変更する速度の割合を表します。 |
例
ファンの速度を少し下げます。
{ "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": {} }
サンプル音声
de-DE
-
stell die Geschwindigkeit
vom Ventilator aufhoch
en-US
-
drop
the AC fan speed tomedium
es-ES
-
cambia la velocidad del
ventilador amedio
fr-FR
-
mets
la ventilation aumaximum
hi-IN
-
बेडरूम में पंखे
की गति
मीडियम करें
it-IT
-
metti
il condizionatore in salotto a velocitàmedia
ja-JP
-
エアコン の風量を高速 にセット
ko-KR
-
선풍기 강풍 으로 틀어 줘
nl-NL
-
zet de snelheid van
de ventilator opmedium
pt-BR
-
definir a velocidade do
ventilador parabaixa -
põe
a ventoinha nomáximo
sv-SE
-
Ställ in
fläkten påmedel
デバイスエラー
エラーと例外のリストをご覧ください。maxSpeedReached
: デバイスはすでに最高速度に設定されています。minSpeedReached
: デバイスはすでに最低速度に設定されています。