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 vereinfachtes Trait ersetzt ein Standard-Trait der Home API, ähnlich wie das Fassadenmuster funktioniert. Vereinfachte Traits bieten Befehle, die gängige Aufgaben für bestimmte Gerätetypen erleichtern. Vereinfachte Traits sind Home API-Traits und funktionieren wie andere Home API-Traits sowohl für Matter als auch für Cloud-to-cloud Geräte.

Ein vereinfachtes Trait bietet eine alternative Teilmenge von Attributen und Befehlen, die gerätespezifischer sind als die des entsprechenden Standard-Traits. Das Standard LevelControlTrait Trait ist beispielsweise ein generisches Trait, das für jedes Gerät verwendet werden kann, das eine Einstellung hat, die sich kontinuierlich über einen Bereich numerischer Werte ändert. BrightnessTrait ist ein vereinfachtes Trait, das LevelControlTrait ersetzt 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 ein breiteres Spektrum an 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

Vereinfachtes 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 Gerät vom Typ DimmableLightDeviceType in der Struktur vorhanden ist und der Entwickler sowohl das Trait LevelControlTrait als auch das Trait BrightnessTrait registriert hat, gibt die Discovery API das Vorhandensein beider Traits an. Der Entwickler kann in seiner Automatisierung eines der beiden Traits verwenden.

Weitere Informationen finden Sie unter Home-Konfiguration.