La API de Key Value proporciona nuevas APIs personalizadas de administración de datos para los objetos Device, Room y Automation. El ciclo de vida de los datos personalizados se limita estrictamente al ciclo de vida del objeto con el que se asocian. Por ejemplo, los datos personalizados (como "La habitación de Lucía") asociados a un objeto Room se borrarán, moverán o transferirán automáticamente (entre estructuras) con el objeto Room.
El cambio en la API de Kotlin se centra en la interfaz hasCustomAppData y proporciona extensiones a los objetos a los que pertenecen los datos de la aplicación personalizada, además de incluir las funciones estándar de creación, lectura, actualización y eliminación (CRUD).
Ejemplo de dispositivo
val device = homeClient.devicesWithLogging().findDeviceByName(deviceName)
var response = device.getValue(key)
println("Before: $response")
device.updateValue(key, value)
response = device.getValue(key)
println("After: $response")
device.deleteValue(key)
Ejemplo de Room
val room = homeClient.rooms().findRoomByName(roomName)
room.updateValue("nickname", "Lucy's Room")
val response = room.getValue("nickname")
room.deleteValue("nickname")
Ejemplo de automatización
val automation = homeClient.automations().findAutomationByName(automationName)
var response = automation.getValue(key)
println("Before: $response")
automation.updateValue(key, value)
response = automation.getValue(key)
println("After: $response")
automation.deleteValue(key)
Restricciones
- La clave debe ser una cadena de caracteres UTF-8 válidos, con una longitud máxima de 128. La clave puede ser una cadena vacía.
- El valor debe ser una cadena de caracteres UTF-8 válidos, con una longitud máxima de 1,024. El valor puede ser una cadena vacía.
- Cada objeto puede tener 10 filas de pares clave-valor.