Vereinfachte Merkmale unter iOS

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Für eine einfache Verwendung sind vereinfachte Versionen einiger Merkmale für die Verwendung mit der Automation API auf iOS verfügbar.

Ein vereinfachtes Attribut steht für ein Standardattribut der Home API, ähnlich wie beim Fassadenmuster. Vereinfachte Eigenschaften bieten Befehle, die häufige Aufgaben für bestimmte Gerätetypen erleichtern. Vereinfachte Eigenschaften sind Home API-Eigenschaften und funktionieren wie andere Home API-Eigenschaften 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 Standardattribut LevelControlTrait ist beispielsweise ein generisches Attribut, das für alle Geräte verwendet werden kann, deren Einstellung kontinuierlich über einen Bereich von numerischen Werten variiert. BrightnessTrait ist eine vereinfachte Eigenschaft, die für LevelControlTrait steht und nur die Befehle und Attribute enthält, die ein DimmableLightDeviceType-Gerät benötigt. BrightnessTrait hat den Befehl moveToBrightness, der ein einzelnes brightnessPercent-Argument annimmt, 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 Merkmale und die zugrunde liegenden Standardmerkmale aufgeführt. Jeder Merkmalname ist mit der entsprechenden API-Dokumentation verknüpft:

Tabelle: Vereinfachte Merkmale

Vereinfachter Merkmal	Standardmerkmal
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 Ihrer App korrekt als ReferencedAutomationTypes konfiguriert wurden. Wenn sich beispielsweise ein DimmableLightDeviceType-Gerät in der Struktur befindet und der Entwickler sowohl das Merkmal LevelControlTrait als auch das Merkmal BrightnessTrait registriert hat, gibt die Discovery API an, dass beide Merkmale vorhanden sind. Der Entwickler kann eine der beiden Eigenschaften in seiner Automatisierung verwenden.

Weitere Informationen finden Sie unter Zuhause-Konfiguration.