Características simplificadas en iOS

Para facilitar el uso, hay versiones simplificadas de algunos rasgos disponibles para usar con la API de Automation en iOS.

Un rasgo simplificado reemplaza a un rasgo estándar de la API de Home, de manera similar a cómo funciona el patrón de fachada. Los rasgos simplificados proporcionan comandos que facilitan las tareas comunes para ciertos tipos de dispositivos. Los rasgos simplificados son rasgos de la API de Home y, al igual que otros rasgos de la API de Home, funcionan para dispositivos Matter y Cloud-to-cloud.

Un rasgo simplificado ofrece un subconjunto alternativo de atributos y comandos que es más específico para el dispositivo que los del rasgo estándar correspondiente. Por ejemplo, el rasgo estándar LevelControlTrait es un rasgo genérico que se puede usar para cualquier dispositivo que tenga un parámetro de configuración que varíe de forma continua en un rango de valores numéricos. BrightnessTrait es un rasgo simplificado que reemplaza a LevelControlTrait y proporciona solo 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 rasgo se vincula a la documentación de la API correspondiente:

Tabla: Rasgos simplificados

Trait simplificado	Rasgo estándar
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Rasgos simplificados y la API de Discovery

La API de Discovery informa sobre los rasgos simplificados y sus rasgos estándar subyacentes, siempre y cuando ambos rasgos se hayan configurado correctamente como ReferencedAutomationTypes en la configuración de tu app. Por ejemplo, si hay un dispositivo DimmableLightDeviceType en la estructura y el desarrollador registró los rasgos LevelControlTrait y BrightnessTrait, la API de Discovery indicaría la presencia de ambos rasgos. El desarrollador puede optar por usar cualquiera de los dos rasgos en su automatización.

Consulta Configuración de la casa para obtener más información.