Toldo para casa inteligente
action.devices.types.AWNING
: Los toldos son retráctiles y se pueden abrir y cerrar. Se pueden instalar en interiores o exteriores.
Este tipo indica que el dispositivo obtiene el ícono de Toldo y algunos sinónimos y alias relacionados.
Funciones del dispositivo
Consulta la documentación de características correspondiente para obtener detalles de la implementación, como atributos y estados que tu servicio debe admitir, y cómo compilar respuestas de EXECUTE y QUERY.
Características obligatorias
Estos rasgos y comandos son necesarios, si corresponde, en 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 menor o igual que 2,500 ms.
- Confiabilidad: Debe ser mayor o igual que el 97%.
Dispositivo de ejemplo: Toldo simple
En esta sección, se incluyen ejemplos de cargas útiles de intents que representan un "tendencia" común según el tipo de dispositivo y las características anteriores. Si agregas o quitas características en tu implementación, modifica tus respuestas según corresponda para reflejar esos cambios.
Respuesta de muestra de SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.AWNING", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple awning" }, "willReportState": true, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Respuesta de muestra QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "openPercent": 50 } } } }
Comandos EXECUTE de muestra
Abrir y cerrar
Para obtener detalles adicionales 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": 100 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openPercent": 100 } } ] } }