Caractéristiques simplifiées sur iOS

Pour faciliter l'utilisation, des versions simplifiées de certains traits sont disponibles avec l'API Automation sur iOS.

Un trait simplifié remplace un trait standard de l'API Home, de la même manière que le modèle façade fonctionne. Les traits simplifiés fournissent des commandes qui facilitent les tâches courantes pour certains types d'appareils. Les traits simplifiés sont des traits de l'API Home. Comme les autres traits de l'API Home, ils fonctionnent pour les appareils Matter et Cloud-to-cloud.

Un trait simplifié offre un sous-ensemble alternatif d'attributs et de commandes plus spécifiques à l'appareil que ceux du trait standard correspondant. Par exemple, le trait standard LevelControlTrait est un trait générique qui peut être utilisé pour tout appareil dont le paramètre varie de manière continue sur une plage de valeurs numériques. BrightnessTrait est un trait simplifié qui remplace LevelControlTrait et ne fournit que les commandes et les attributs dont un appareil DimmableLightDeviceType a besoin. BrightnessTrait comporte une commande moveToBrightness qui accepte un seul argument brightnessPercent, tandis que LevelControlTrait comporte plusieurs commandes move, dont la plupart ont au moins quatre paramètres pour s'adapter à un plus large éventail de cas d'utilisation.

Le tableau suivant présente chaque caractéristique simplifiée et les caractéristiques standards sous-jacentes. Chaque nom de trait renvoie à la documentation de l'API correspondante :

Tableau : Traits simplifiés

Caractéristique simplifiée	Trait standard
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Traits simplifiés et API Discovery

L'API Discovery signale les traits simplifiés ainsi que leurs traits standards sous-jacents, à condition que les deux traits aient été correctement configurés en tant que ReferencedAutomationTypes dans la configuration de votre application. Par exemple, si un appareil DimmableLightDeviceType est présent dans la structure et que le développeur a enregistré les traits LevelControlTrait et BrightnessTrait, l'API Discovery indique la présence des deux traits. Le développeur peut choisir d'utiliser l'un ou l'autre de ces traits dans son automatisation.

Pour en savoir plus, consultez Configuration de la maison.