Guía de portones de casa inteligente
action.devices.types.GATE: Las puertas se pueden abrir y cerrar, posiblemente en más de una dirección.
Este tipo indica que el dispositivo obtiene el ícono de puerta de enlace 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.
Rasgos recomendados
Se recomiendan estas características, si corresponde a tu dispositivo. Sin embargo, puedes combinar todos los atributos disponibles para que coincidan mejor con la funcionalidad de tu producto existente.
Requisitos de calidad
- Latencia: Debe ser inferior o igual a 2500 ms.
- Fiabilidad: Debe ser superior o igual al 97%.
Ejemplo de dispositivo: Puerta simple
Esta sección contiene cargas útiles de intents de ejemplo que representan una "Puerta de enlace" 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.GATE", "traits": [ "action.devices.traits.LockUnlock", "action.devices.traits.OpenClose" ], "name": { "name": "Simple gate" }, "willReportState": true, "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, "openPercent": 50, "isLocked": false, "isJammed": false } } } }
Comandos EXECUTE de muestra
LockUnlock
Para obtener más detalles sobre los parámetros del comando, consulta la referencia de action.devices.traits.LockUnlock.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.LockUnlock", "params": { "lock": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isLocked": true, "isJammed": false } } ] } }
OpenClose
Para obtener más detalles sobre los parámetros del comando, consulta la referencia de action.devices.traits.OpenClose.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openPercent": 100 } } ] } }