Aby ułatwić korzystanie z interfejsu Automation API na iOS, udostępniliśmy uproszczone wersje niektórych atrybutów.
Uproszczona cecha zastępuje standardową cechę interfejsu Home API, podobnie jak działa wzorzec fasady. Uproszczone cechy udostępniają polecenia, które ułatwiają wykonywanie typowych zadań na określonych typach urządzeń. Uproszczone cechy to cechy interfejsu Home API, które, podobnie jak inne cechy tego interfejsu, działają zarówno na urządzeniach Matter, jak i Cloud-to-cloud.
Uproszczone cechy oferują alternatywny podzbiór atrybutów i poleceń, który jest bardziej dostosowany do danego urządzenia niż odpowiadające mu cechy standardowe.
Na przykład standardowy atrybut LevelControlTrait to ogólny atrybut, który może być używany na dowolnym urządzeniu z ustawieniem, które zmienia się w sposób ciągły w zakresie wartości liczbowych.
BrightnessTrait to uproszczona cecha zastępująca LevelControlTrait. Zawiera tylko te polecenia i atrybuty, których wymaga urządzenie DimmableLightDeviceType. BrightnessTrait ma polecenie moveToBrightness, które przyjmuje jeden argument brightnessPercent, a LevelControlTrait ma wiele poleceń move, z których większość ma co najmniej 4 parametry, aby umożliwić stosowanie w szerszym zakresie.
Tabela poniżej zawiera uproszczone cechy i cechy standardowe, na których się one opierają. Każda nazwa cechy prowadzi do odpowiedniej dokumentacji interfejsu API:
| Uproszczona cecha | Właściwość standardowa |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Uproszczone cechy i interfejs Discovery API
Discovery API raportuje uproszczone cechy oraz ich podstawowe cechy standardowe, o ile obie cechy zostały prawidłowo skonfigurowane jako ReferencedAutomationTypes w konfiguracji aplikacji. Jeśli na przykład w strukturze występuje urządzenie DimmableLightDeviceType, a deweloper zarejestrował cechy LevelControlTrait i BrightnessTrait, Discovery API będzie wskazywać obecność obu cech. Deweloperzy mogą używać w automatyzacji dowolnej z tych cech.
Więcej informacji znajdziesz w artykule Konfiguracja strony głównej.