Guía de escenas para el hogar inteligente
action.devices.types.SCENE
: En el caso de escenas, el tipo asigna 1:1 a la característica, ya que las escenas no se combinan con otras características para formar dispositivos compuestos. Las escenas siempre deben tener nombres proporcionados por el usuario. Cada escena es su propio dispositivo virtual, con sus propios nombres.
Este tipo indica que el dispositivo obtiene el ícono de Escena y algunos sinónimos y alias relacionados.
Consulta la Característica de escena para obtener más información.
Funciones del dispositivo
Consulta la documentación de características correspondiente para obtener detalles de implementación, como atributos y estados que tu servicio debe admitir, y cómo compilar respuestas de EXECUTE y QUERY.
Características obligatorias
Estas características y comandos son necesarios si corresponden a tu dispositivo.
Requisitos de calidad
- Latencia: Debe ser menor o igual que 3,000 ms.
- Confiabilidad: Debe ser mayor o igual que 97%.
Ejemplo de dispositivo: Escena simple
Esta sección contiene cargas útiles de intent de ejemplo que representan una "escena" común basada en el tipo de dispositivo y las características anteriores. Si agregas o quitas rasgos 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.SCENE", "traits": [ "action.devices.traits.Scene" ], "name": { "name": "Simple scene" }, "willReportState": true, "attributes": { "sceneReversible": 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 } } } }
Comandos de EXECUTE de muestra
Activar escena
Para obtener detalles adicionales sobre los parámetros del comando, consulta la referencia de
action.devices.traits.Scene
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }