智能家居干衣机指南
action.devices.types.DRYER - 烘干机的开始和停止功能独立于开启或关闭功能。有些烘干机在烘干过程中可以暂停和继续。烘干机也有多种模式，每种模式都有自己的相关设置。这些设置特定于烘干机，并且以通用形式进行解释。
此类型表示设备会获取烘干机图标以及一些相关的同义词和别名。
设备功能
如需了解实现详情（例如您的服务应支持的属性和状态，以及如何构建 EXECUTE 和 QUERY 响应），请参阅相应的 trait 文档。
必需的特征
这些 trait 和命令是必需的（如果适用于您的设备）。如果您的设备不支持这些 trait，请在 QUERY 或 EXECUTE 响应中输入 functionNotSupported 错误代码。如需了解详情，请参阅错误和异常。
建议的特征
建议您使用以下 trait（如果适用于您的设备）。 不过，您可以自由组合使用所有可用的 trait，以便尽可能匹配现有的产品功能。
-
action.devices.traits.Modes -
action.devices.traits.OnOff -
action.devices.traits.RunCycle -
action.devices.traits.Toggles
质量要求
- 延迟时间：必须小于或等于 3000 毫秒。
- 可靠性：必须大于或等于 97%。
设备示例：简单烘干机
本部分包含基于上述设备类型和特征的常见“烘干机”的 intent 载荷示例。如果您在实现中添加或移除 trait，请相应地修改响应以反映这些更改。
SYNC 响应示例
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DRYER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.RunCycle", "action.devices.traits.StartStop", "action.devices.traits.Modes" ], "name": { "name": "Simple dryer" }, "willReportState": true, "attributes": { "availableModes": [ { "name": "load_key", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_key", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "large_key", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true } ], "pausable": 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, "isRunning": true, "isPaused": false, "currentRunCycle": [ { "currentCycle": "dry", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300, "currentModeSettings": { "load_key": "small_key" } } } } }
EXECUTE 命令示例
OnOff
如需详细了解命令参数，请参阅
action.devices.traits.OnOff 参考文档。
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
StartStop
如需详细了解命令参数，请参阅
action.devices.traits.StartStop 参考文档。
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.StartStop", "params": { "start": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }
SetModes
如需详细了解命令参数，请参阅
action.devices.traits.Modes 参考文档。
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_key": "large_key" } } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentModeSettings": { "load_key": "large_key" } } } ] } }