Vereinfachte Merkmale unter iOS

Zur Vereinfachung der Verwendung sind vereinfachte Versionen einiger Traits für die Verwendung mit der Automation API unter iOS verfügbar.

Ein vereinfachter Trait steht für einen Standard-Trait der Home API, ähnlich wie das Fassadenmuster funktioniert. Vereinfachte Traits bieten Befehle, die allgemeine Aufgaben für bestimmte Gerätetypen erleichtern. Vereinfachte Traits sind Traits der Home API und funktionieren wie andere Traits der Home API sowohl für Matter als auch für Cloud-to-cloud Geräte.

Ein vereinfachter Trait bietet eine alternative Teilmenge von Attributen und Befehlen, die gerätespezifischer sind als die des entsprechenden Standard-Traits. Der Standard LevelControlTrait Trait ist beispielsweise ein generischer Trait, der für jedes Gerät verwendet werden kann, das eine Einstellung hat, die sich kontinuierlich über einen Bereich numerischer Werte ändert. BrightnessTrait ist ein vereinfachter Trait, der für LevelControlTrait steht und nur die Befehle und Attribute bietet, die ein DimmableLightDeviceType Gerät benötigt. BrightnessTrait hat einen moveToBrightness Befehl, der ein einzelnes brightnessPercent Argument akzeptiert, während LevelControlTrait mehrere move Befehle hat, von denen die meisten mindestens vier Parameter haben, um eine größere Bandbreite von Anwendungsfällen zu berücksichtigen.

In der folgenden Tabelle sind die einzelnen vereinfachten Traits und die zugrunde liegenden Standard-Traits aufgeführt. Jeder Trait-Name ist mit der entsprechenden API-Dokumentation verlinkt:

Tabelle: Vereinfachte Traits

Vereinfachter Trait	Standard-Trait
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Vereinfachte Traits und die Discovery API

Die Discovery API meldet sowohl vereinfachte Traits als auch die zugrunde liegenden Standard-Traits, sofern beide Traits in der Konfiguration für Ihre App korrekt als ReferencedAutomationTypes konfiguriert wurden. Wenn beispielsweise ein DimmableLightDeviceType Gerät in der Struktur vorhanden ist und der Entwickler sowohl den LevelControlTrait als auch den BrightnessTrait registriert hat, gibt die Discovery API das Vorhandensein beider Traits an. Der Entwickler kann in seiner Automatisierung einen der beiden Traits verwenden.

Weitere Informationen finden Sie unter Home-Konfiguration.