Vereinfachte Merkmale unter iOS

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

Ein vereinfachtes Trait ersetzt ein Standard-Home API-Trait, ähnlich wie das Fassadenmuster funktioniert. Vereinfachte Attribute bieten Befehle, die gängige Aufgaben für bestimmte Gerätetypen erleichtern. Vereinfachte Attribute sind Home API-Attribute und funktionieren wie andere Home API-Attribute sowohl für Matter- als auch für Cloud-to-cloud-Geräte.

Ein vereinfachtes Attribut bietet eine alternative Teilmenge von Attributen und Befehlen, die gerätespezifischer sind als die des entsprechenden Standardattributs. Das Standard-Trait LevelControlTrait 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 Attribut, das für LevelControlTrait steht und nur die Befehle und Attribute bereitstellt, 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 abzudecken.

In der folgenden Tabelle sind die einzelnen vereinfachten Attribute und die zugrunde liegenden Standardattribute aufgeführt. Jeder Attributname ist mit der entsprechenden API-Dokumentation verknüpft:

Tabelle: Vereinfachte Attribute

Vereinfachtes Trait	Standardmerkmal
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Vereinfachte Attribute und die Discovery API

Die Discovery API meldet vereinfachte Eigenschaften sowie die zugrunde liegenden Standardeigenschaften, sofern beide Eigenschaften in der Konfiguration für deine App korrekt als ReferencedAutomationTypes konfiguriert wurden. Wenn beispielsweise ein DimmableLightDeviceType-Gerät in der Struktur vorhanden ist und der Entwickler sowohl die Eigenschaft LevelControlTrait als auch die Eigenschaft BrightnessTrait registriert hat, meldet die Discovery API das Vorhandensein beider Eigenschaften. Der Entwickler kann in seiner Automatisierung beide Attribute verwenden.

Weitere Informationen findest du unter Konfiguration des Zuhauses.