Guía de cortinas para casas inteligentes
action.devices.types.CURTAIN: Las cortinas se pueden abrir y cerrar, posiblemente en más de una dirección. Por ejemplo, las cortinas con dos secciones pueden abrirse hacia la izquierda o hacia la derecha.
Este tipo indica que el dispositivo obtiene el ícono de cortina y algunos sinónimos y alias relacionados.
Funciones del dispositivo
Consulta la documentación correspondiente de la función para obtener detalles de la implementación, como los atributos y estados que debe admitir tu servicio, y cómo compilar respuestas de EXECUTE y QUERY.
Características obligatorias
Estos atributos y comandos son obligatorios, si son aplicables a tu dispositivo. Si tu dispositivo no admite estas características, ingresa el código de error de functionNotSupported en una respuesta QUERY o EXECUTE. Consulta Errores y excepciones para obtener más información.
Requisitos de calidad
- Latencia: Debe ser inferior o igual a 2500 ms.
- Fiabilidad: Debe ser superior o igual al 97%.
Ejemplo de dispositivo: Cortina simple
En esta sección, se incluyen ejemplos de cargas útiles de intents que representan una "cortina" común según el tipo de dispositivo y los atributos anteriores. Si agregas o quitas atributos en tu implementación, modifica tus respuestas según corresponda para reflejar esos cambios.
Respuesta de SYNC de muestra
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CURTAIN", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple curtain" }, "willReportState": true, "attributes": { "openDirection": [ "LEFT", "RIGHT" ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Respuesta de QUERY de muestra
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "openState": [ { "openPercent": 30, "openDirection": "LEFT" }, { "openPercent": 50, "openDirection": "RIGHT" } ] } } } }
Comandos EXECUTE de muestra
OpenClose
Para obtener más detalles sobre los parámetros del comando, consulta la referencia de action.devices.traits.OpenClose.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 10, "openDirection": "LEFT" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "LEFT" }, { "openPercent": 50, "openDirection": "RIGHT" } ] } } ] } }