Per facilità d'uso, sono disponibili versioni semplificate di alcuni tratti da utilizzare con l'API Automation su iOS.
Una caratteristica semplificata sostituisce una caratteristica standard dell'API Home, in modo simile al funzionamento del pattern facciata. Le caratteristiche semplificate forniscono comandi che rendono più semplici le attività comuni per determinati tipi di dispositivi. Le caratteristiche semplificate sono caratteristiche dell'API Home e, come le altre caratteristiche dell'API Home, funzionano sia per i dispositivi Matter che per quelli 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, la caratteristica standard
LevelControlTrait
è una caratteristica generica che può essere utilizzata per qualsiasi dispositivo con un'impostazione che varia continuamente in un intervallo di valori numerici.
BrightnessTrait
è una
caratteristica semplificata 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 adattarsi a una gamma più ampia di casi d'uso.
La tabella seguente mostra ogni tratto semplificato e i tratti standard sottostanti. Ogni nome di caratteristica rimanda alla documentazione API corrispondente:
Tratto semplificato | Tratto standard |
---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTrait OnOffTrait
|
Tratti semplificati e API Discovery
L'API Discovery segnala i tratti semplificati e i relativi tratti standard sottostanti, a condizione che entrambi i tratti 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 tratti LevelControlTrait
e BrightnessTrait
, l'API Discovery indicherà la presenza di entrambi i tratti. Lo
sviluppatore può scegliere di utilizzare uno dei due tratti nell'automazione.
Per ulteriori informazioni, consulta la sezione Configurazione della casa.