Guía de la cafetera inteligente para el hogar
action.devices.types.COFFEE_MAKER
: Las interacciones con las cafeteras pueden incluir encenderlas y apagarlas, ajustar los modos de cocción y los ajustes predeterminados de los alimentos, ajustar la temperatura objetivo y ajustar varios parámetros de configuración de los modos que no son de cocción.
Este tipo indica que el dispositivo obtiene el ícono de cafetera 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 menor o igual que 800 ms.
- Fiabilidad: Debe ser superior o igual al 97%.
Ejemplo de dispositivo: Cafetera simple
Esta sección contiene cargas útiles de intents de ejemplo que representan una "cafetera" 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.COFFEE_MAKER", "traits": [ "action.devices.traits.Cook", "action.devices.traits.TemperatureControl", "action.devices.traits.OnOff" ], "name": { "name": "Simple coffee maker" }, "willReportState": true, "attributes": { "temperatureRange": { "minThresholdCelsius": 0, "maxThresholdCelsius": 100 }, "temperatureUnitForUX": "F", "supportedCookingModes": [ "BREW" ], "foodPresets": [ { "food_preset_name": "coffee_key", "supported_units": [ "NO_UNITS", "CUPS" ], "food_synonyms": [ { "synonym": [ "Coffee" ], "lang": "en" } ] } ] }, "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, "on": true, "temperatureSetpointCelsius": 70, "currentCookingMode": "BREW", "currentFoodPreset": "coffee_key", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" } } } }
Comandos EXECUTE de muestra
Descubre qué cocinar
Para obtener más detalles sobre los parámetros del comando, consulta la referencia de
action.devices.traits.Cook
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BREW" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentCookingMode": "NONE", "currentFoodPreset": "NONE" } } ] } }
SetTemperature
Para obtener más detalles sobre los parámetros del comando, consulta la referencia de
action.devices.traits.TemperatureControl
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetTemperature", "params": { "temperature": 85 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "temperatureSetpointCelsius": 85 } } ] } }
OnOff
Para obtener más detalles sobre los parámetros del comando, consulta la referencia de
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }