Aby ułatwić korzystanie z interfejsu Automation API na iOS, dostępne są uproszczone wersje niektórych cech.
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 standardowej cechy.
Na przykład cecha standardowa
LevelControlTrait
to cecha ogólna, której można używać 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 obsługiwać szerszy zakres zastosowań.moveToBrightness
W tabeli poniżej znajdziesz uproszczone cechy i odpowiadające im standardowe cechy. Każda nazwa cechy jest powiązana z odpowiednią dokumentacją 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 strony głównej.