Uproszczone cechy na iOS

Aby ułatwić korzystanie, uproszczone wersje niektórych cech są dostępne do użycia z interfejsem Automation API w iOS.

Uproszczona cecha zastępuje standardową cechę Home API, podobnie jak działa wzorzec fasady. Uproszczone cechy udostępniają polecenia, które ułatwiają wykonywanie typowych zadań na niektórych typach urządzeń. Uproszczone cechy to cechy Home API, które podobnie jak inne cechy Home API działają zarówno w przypadku urządzeń Matter jak i urządzeń 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 cechy standardowej. Na przykład standardowa cecha LevelControlTrait jest cechą ogólną, której można używać w przypadku każdego 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 udostępnia tylko polecenia i atrybuty wymagane przez urządzenie DimmableLightDeviceType. BrightnessTrait ma moveToBrightness polecenie, które przyjmuje jeden argument brightnessPercent, natomiast LevelControlTrait ma kilka poleceń move, z których większość ma co najmniej cztery parametry, aby obsługiwać szerszy zakres przypadków użycia.

W tabeli poniżej znajdziesz każdą uproszczoną cechę i odpowiadające jej cechy standardowe. Każda nazwa cechy zawiera link do odpowiedniej dokumentacji API:

Tabela: uproszczone cechy

Uproszczona cecha	Standardowa cecha
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Uproszczone cechy i interfejs Discovery API

Interfejs Discovery API zgłasza uproszczone cechy oraz odpowiadające im cechy standardowe, o ile obie cechy zostały prawidłowo skonfigurowane jako ReferencedAutomationTypes w konfiguracji aplikacji. Jeśli na przykład w strukturze znajduje się urządzenie DimmableLightDeviceType a deweloper zarejestrował cechy LevelControlTrait i BrightnessTrait interfejs Discovery API wskaże obecność obu cech. Deweloper może użyć w automatyzacji dowolnej z tych cech.

Więcej informacji znajdziesz w artykule Konfiguracja Home.