Tratti semplificati su iOS

bookmark_border Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Per semplicità d'uso, sono disponibili versioni semplificate di alcuni tratti per l'utilizzo con l'API Automation su iOS.

Un trait semplificato sostituisce un trait dell'API Home standard, in modo simile al funzionamento del pattern di facciata. Le caratteristiche semplificate forniscono comandi che semplificano le attività comuni per alcuni tipi di dispositivi. Gli attributi semplificati sono attributi dell'API Home e, come gli altri attributi dell'API Home, funzionano sia per i dispositivi Matter sia per quelli Cloud-to-cloud.

Un trait semplificato offre un sottoinsieme alternativo di attributi e comandi più specifico del dispositivo rispetto a quello del trait 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 è un tratto semplificato che sostituisce LevelControlTrait e fornisce solo i comandi e gli attributi richiesti da un dispositivo DimmableLightDeviceType. BrightnessTrait ha un moveToBrightness comando 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 del tratto rimanda alla documentazione dell'API corrispondente:

Caratteristiche semplificate 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 dell'app. Ad esempio, se nella struttura è presente un dispositivo DimmableLightDeviceType e lo sviluppatore ha registrato sia i tratti LevelControlTrait sia i tratti 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 Configurazione della casa.