Guía sobre la pérgola para casas inteligentes
action.devices.types.PERGOLA
: Las pérgolas (una estructura de jardín exterior) se pueden abrir y cerrar, posiblemente en más de una dirección. Por ejemplo, algunas pérgolas con lienzo pueden abrirse hacia la IZQUIERDA o la DERECHA.
Este tipo indica que el dispositivo obtiene el ícono de Pérgola 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 los atributos y los estados que tu servicio debe admitir, y cómo compilar respuestas EXECUTE y QUERY.
Características requeridas
Estas características y comandos son obligatorios si corresponde para tu dispositivo. Si tu dispositivo no admite estas características, ingresa el código de error functionNotSupported
en una respuesta de QUERY o EXECUTE. Consulta Errores y excepciones para obtener más información.
Traits recomendados
Te recomendamos que agregues estas características a tu dispositivo, si corresponde. Sin embargo, puedes combinar todas las características disponibles para adaptarlas mejor a las funciones del producto existentes.
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: Pérgola simple
Esta sección contiene ejemplos de cargas útiles de intents que representan una "Pérgola" común según el tipo y las características de dispositivo mencionados anteriormente. Si agregas o quitas rasgos en tu implementación, modifica las 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.PERGOLA", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple pergola" }, "willReportState": true, "attributes": { "openDirection": [ "LEFT", "RIGHT" ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Respuesta de muestra de QUERY
{ "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" } ] } } } }
Ejemplo de comandos EXECUTE
OpenClose
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": 10, "openDirection": "LEFT" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "LEFT" }, { "openPercent": 50, "openDirection": "RIGHT" } ] } } ] } }