Guía de persianas para el hogar inteligente
action.devices.types.BLINDS: Las persianas se pueden abrir y cerrar, y se admiten varios tipos de persianas, como veneciano (se abre en una dirección), panel o vertical (puede abrirse hacia la izquierda o la derecha) y vertical hacia abajo (puede abrirse hacia arriba o hacia abajo). Algunas persianas pueden tener persianas que se puedan rotar.
Este tipo indica que el dispositivo obtiene el ícono de persianas y algunos sinónimos y alias relacionados.
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.
Características recomendadas
Recomendamos estas características, si se aplican a tu dispositivo. Sin embargo, puedes combinar todas las características disponibles para que se adapten mejor a la funcionalidad del producto existente.
Requisitos de calidad
- Latencia: Debe ser menor o igual que 2,500 ms.
- Confiabilidad: Debe ser mayor o igual que 97%.
Ejemplo de dispositivo: persianas simples
En esta sección, se incluyen cargas útiles de intent de ejemplo que representan una "persiana" común según 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.
En una ventana ciega de arriba abajo, la dirección UP aumenta la parte inferior de la persiana, y la dirección DOWN la baja. En la figura 1, se muestra un ejemplo de un ciego de arriba abajo en el que la dirección UP eleva la parte inferior de la persiana un 50% y la dirección DOWN la baja en un 30%.
Respuesta de muestra de SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.BLINDS",
"traits": [
"action.devices.traits.OpenClose"
],
"name": {
"name": "Simple blinds"
},
"willReportState": true,
"attributes": {
"openDirection": [
"UP",
"DOWN"
]
},
"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,
"openState": [
{
"openPercent": 30,
"openDirection": "DOWN"
},
{
"openPercent": 50,
"openDirection": "UP"
}
]
}
}
}
}
Comandos de EXECUTE de muestra
Abrir
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": "DOWN"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"openState": [
{
"openPercent": 10,
"openDirection": "DOWN"
},
{
"openPercent": 50,
"openDirection": "UP"
}
]
}
}
]
}
}