Vereinfachte Merkmale unter iOS

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

Ein vereinfachtes Attribut steht für ein Standard-Home API-Attribut, ä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 Standardmerkmal LevelControlTrait ist beispielsweise ein generisches Merkmal, 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 Merkmal, das für LevelControlTrait steht und nur die Befehle und Attribute bereitstellt, die für ein DimmableLightDeviceType-Gerät erforderlich sind. BrightnessTrait hat den Befehl moveToBrightness, der ein einzelnes brightnessPercent-Argument akzeptiert. LevelControlTrait hat mehrere move-Befehle, von denen die meisten mindestens vier Parameter haben, um eine größere Bandbreite von Anwendungsfällen zu unterstützen.

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

Tabelle: Vereinfachte Eigenschaften

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

Vereinfachte Merkmale und die Discovery API

Die Discovery API meldet vereinfachte Merkmale sowie die zugrunde liegenden Standardmerkmale, sofern beide Merkmale 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 das Merkmal LevelControlTrait als auch das Merkmal BrightnessTrait registriert hat, gibt die Discovery API das Vorhandensein beider Merkmale an. Der Entwickler kann in seiner Automatisierung eines der beiden Merkmale verwenden.

Weitere Informationen finden Sie unter Konfiguration des Zuhauses.