Para facilitar el uso, hay versiones simplificadas de algunos atributos disponibles para usar con la API de Automation en iOS.
Un atributo simplificado reemplaza un atributo estándar de la API de Home, de manera similar a como funciona el patrón de fachada. Los atributos simplificados proporcionan comandos que facilitan las tareas comunes en ciertos tipos de dispositivos. Los atributos simplificados son atributos de la API de Home y, al igual que otros atributos de la API de Home, funcionan para dispositivos Matter y Cloud-to-cloud.
Un atributo simplificado ofrece un subconjunto alternativo de atributos y comandos que es más específico del dispositivo que los del atributo estándar correspondiente.
Por ejemplo, el atributo estándar LevelControlTrait es un atributo genérico que se puede usar para cualquier dispositivo que tenga una configuración que varíe de forma continua en un rango de valores numéricos.
BrightnessTrait es un atributo simplificado que reemplaza a LevelControlTrait y solo proporciona los comandos y atributos que requiere un dispositivo DimmableLightDeviceType. BrightnessTrait tiene un comando moveToBrightness que toma un solo argumento brightnessPercent, mientras que LevelControlTrait tiene varios comandos move, la mayoría de los cuales tienen al menos cuatro parámetros para adaptarse a una gama más amplia de casos de uso.
En la siguiente tabla, se muestra cada rasgo simplificado y los rasgos estándar subyacentes. Cada nombre de atributo incluye un vínculo a la documentación de la API correspondiente:
| Trait simplificado | Rasgo estándar |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Atributos simplificados y la API de Discovery
La API de Discovery informa atributos simplificados, así como sus atributos estándar subyacentes, siempre que ambos atributos se hayan configurado correctamente como ReferencedAutomationTypes en la configuración de tu app. Por ejemplo, si hay un dispositivo DimmableLightDeviceType presente en la estructura y el desarrollador registró los atributos LevelControlTrait y BrightnessTrait, la API de Discovery indicaría la presencia de ambos atributos. El desarrollador puede elegir usar cualquiera de estos atributos en su automatización.
Consulta Configuración de la página principal para obtener más información.