Aby ułatwić korzystanie z interfejsu Automation API na iOS, udostępniamy 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óry jest bardziej specyficzny dla urządzenia niż atrybuty i polecenia odpowiadającej mu standardowej cechy. Na przykład standardowa cecha LevelControlTrait to cecha ogólna, której można używać w przypadku każdego urządzenia, które ma ustawienie zmieniające 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. Cecha BrightnessTrait ma polecenie moveToBrightness, które przyjmuje jeden argument brightnessPercent, natomiast cecha LevelControlTrait ma wiele poleceń move, z których większość ma co najmniej 4 parametry, aby uwzględnić szerszy zakres przypadków użycia.
W tabeli poniżej znajdziesz uproszczone cechy i odpowiadające im standardowe cechy. Każda nazwa cechy zawiera link do odpowiedniej dokumentacji 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.