スマートホーム除湿器ガイド
action.devices.types.DEHUMIDIFIER
- 除湿機は、空気中の湿気を取り除くデバイスです。電源のオン / オフの切り替え、目標湿度の報告と調整が可能です。また、さまざまな調整可能なモードやファン速度設定を備えている場合もあります。
このタイプのデバイスには除湿機のアイコンと関連するものが与えられます 類義語と別名を使用します。
デバイスの機能
詳しくは、対応するトレイトのドキュメントをご覧ください。 実装の詳細(サービスがサポートする必要がある属性と状態、 EXECUTE レスポンスと QUERY レスポンスを作成します。
必要なトレイト
以下のトレイトとコマンドは必須です(
ダウンロードしますデバイスがこれらのトレイトをサポートしていない場合は、次のエラーコードを入力してください。
QUERY または EXECUTE レスポンスの functionNotSupported
。詳しくは、
エラーと例外をご覧ください。
推奨されるトレイト
お使いのデバイスに応じて、以下のトレイトを使用することをおすすめします。 ただし、利用可能なすべてのトレイトの中から、既存のテクノロジーに合わせて自由に組み合わせて使用することができます。 提供します。
-
action.devices.traits.FanSpeed
-
action.devices.traits.HumiditySetting
-
action.devices.traits.StartStop
品質要件
- レイテンシ: 1,000 ミリ秒以下である必要があります。
- 信頼性: 97% 以上にする必要があります。
デバイスの例: シンプルな除湿機
このセクションでは、一般的な「除湿装置」を表すインテント ペイロードの例を示します。 デバイスは上記のデバイスタイプとトレイトに基づきます。実装でトレイトを追加または削除すると、 変更に合わせて回答を修正してください。
SYNC レスポンスの例
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DEHUMIDIFIER", "traits": [ "action.devices.traits.FanSpeed", "action.devices.traits.HumiditySetting", "action.devices.traits.OnOff" ], "name": { "name": "Simple dehumidifier" }, "willReportState": true, "attributes": { "humiditySetpointRange": { "minPercent": 5, "maxPercent": 50 }, "availableFanSpeeds": { "speeds": [ { "speed_name": "low_key", "speed_values": [ { "lang": "en", "speed_synonym": [ "Low", "Slow" ] }, { "lang": "de", "speed_synonym": [ "Niedrig", "Schleppend" ] } ] }, { "speed_name": "high_key", "speed_values": [ { "lang": "en", "speed_synonym": [ "High" ] }, { "lang": "de", "speed_synonym": [ "Hoch" ] } ] } ], "ordered": true } }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
QUERY レスポンスの例
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "on": true, "currentFanSpeedSetting": "low_key", "humiditySetpointPercent": 10, "humidityAmbientPercent": 20 } } } }
EXECUTE コマンドの例
SetFanSpeed
コマンド パラメータの詳細については、
<ph type="x-smartling-placeholder"></ph>をご覧ください
action.devices.traits.FanSpeed
ご覧ください。
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "high_key" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentFanSpeedSetting": "high_key" } } ] } }
SetHumidity
コマンド パラメータの詳細については、
<ph type="x-smartling-placeholder"></ph>をご覧ください
action.devices.traits.HumiditySetting
ご覧ください。
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetHumidity", "params": { "humidity": 15 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "humiditySetpointPercent": 15, "humidityAmbientPercent": 20 } } ] } }
OnOff
コマンド パラメータの詳細については、
<ph type="x-smartling-placeholder"></ph>をご覧ください
action.devices.traits.OnOff
ご覧ください。
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }