Aby ułatwić korzystanie z niektórych cech, dostępne są ich uproszczone wersje, które można wykorzystywać w interfejsie Automation API na iOS.
Uproszczona cecha zastępuje standardową cechę interfejsu Home API, podobnie jak działa wzorzec fasady. Uproszczone cechy zapewniają polecenia, które ułatwiają wykonywanie typowych zadań na niektórych typach urządzeń. Uproszczone cechy to cechy interfejsu Home API, które podobnie jak inne cechy tego interfejsu działają na urządzeniach Matter i Cloud-to-cloud.
Uproszczona cecha oferuje alternatywny podzbiór atrybutów i poleceń, które są bardziej specyficzne dla urządzenia niż te z odpowiedniej cechy standardowej.
Na przykład standardowy
LevelControlTrait
atrybut to atrybut ogólny, który można stosować w przypadku dowolnego urządzenia z ustawieniem, które zmienia się w sposób ciągły w zakresie wartości liczbowych.
BrightnessTrait to uproszczona cecha, która zastępuje LevelControlTrait i zawiera tylko polecenia i atrybuty wymagane przez urządzenie DimmableLightDeviceType. BrightnessTrait ma polecenie z 1 argumentem brightnessPercent, a LevelControlTrait ma kilka poleceń move, z których większość ma co najmniej 4 parametry, aby uwzględnić szerszy zakres zastosowań.moveToBrightness
W tabeli poniżej znajdziesz uproszczone cechy i odpowiadające im standardowe cechy. Każda nazwa cechy zawiera link do odpowiedniej dokumentacji interfejsu API:
| Uproszczona cecha | Cechy standardowe |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Uproszczone cechy i interfejs Discovery API
Interfejs Discovery API zgłasza uproszczone cechy, a także 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 DimmableLightDeviceType, a deweloper zarejestrował cechy LevelControlTrait i BrightnessTrait, interfejs Discovery API wskaże obecność obu tych cech. Deweloper może użyć w automatyzacji dowolnej z tych cech.
Więcej informacji znajdziesz w sekcji Konfiguracja domu.