Caractéristiques simplifiées sur iOS

Pour plus de simplicité, des versions simplifiées de certains traits sont disponibles pour l'API Automation sur iOS.

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

Un trait simplifié offre un sous-ensemble alternatif d'attributs et de commandes plus spécifique à 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 un paramètre varie en continu sur une plage de valeurs numériques. BrightnessTrait est un trait simplifié qui remplace LevelControlTrait et fournit uniquement les commandes et les attributs requis par un appareil DimmableLightDeviceType. BrightnessTrait dispose d'une commande moveToBrightness qui n'accepte qu'un seul argument brightnessPercent, tandis que LevelControlTrait dispose de plusieurs commandes move, dont la plupart comportent au moins quatre paramètres afin de s'adapter à un plus grand nombre 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	Caractéristique standard
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Caractéristiques simplifiées et API Discovery

L'API Discovery indique les caractéristiques simplifiées ainsi que les caractéristiques standards sous-jacentes, à condition que les deux caractéristiques aient été correctement configurées 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 caractéristiques LevelControlTrait et BrightnessTrait, l'API Discovery indique la présence des deux caractéristiques. 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.