Per facilità d'uso, sono disponibili versioni semplificate di alcuni tratti da utilizzare con l'API Automation su iOS.
Un tratto semplificato sostituisce un tratto standard dell'API Home, in modo simile al funzionamento del pattern Facade. I tratti semplificati forniscono comandi che semplificano le attività comuni per determinati tipi di dispositivi. I tratti semplificati sono tratti delle API Home e, come altri tratti delle API Home, funzionano sia per i dispositivi Matter che per i dispositivi Cloud-to-cloud.
Un tratto semplificato offre un sottoinsieme alternativo di attributi e comandi più specifico per il dispositivo rispetto a quelli del tratto standard corrispondente.
Ad esempio, il tratto standard LevelControlTrait è un tratto generico che può essere utilizzato per qualsiasi dispositivo con un'impostazione che varia continuamente in un intervallo di valori numerici.
BrightnessTrait è un tratto semplificato che sostituisce LevelControlTrait e fornisce solo i comandi e gli attributi richiesti da un dispositivo DimmableLightDeviceType. BrightnessTrait ha un comando moveToBrightness che accetta un singolo argomento brightnessPercent, mentre LevelControlTrait ha più comandi move, la maggior parte dei quali ha almeno quattro parametri per supportare una gamma più ampia di casi d'uso.
La tabella seguente mostra ogni tratto semplificato e i tratti standard sottostanti. Ogni nome di tratto rimanda alla documentazione dell'API corrispondente:
| Tratto semplificato | Tratto standard |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Tratti semplificati e API Discovery
L'API Discovery segnala i trait semplificati e i relativi trait standard sottostanti, purché entrambi i trait siano stati configurati correttamente come ReferencedAutomationTypes nella configurazione della tua app. Ad esempio, se nella struttura è presente un dispositivo DimmableLightDeviceType e lo sviluppatore ha registrato i trait LevelControlTrait e BrightnessTrait, l'API Discovery indicherà la presenza di entrambi i trait. Lo sviluppatore può scegliere di utilizzare uno dei due tratti nella sua automazione.
Per saperne di più, consulta Configurazione della casa.