편의상 일부 트레잇의 단순화된 버전을 iOS의 Automation API와 함께 사용할 수 있습니다.
단순화된 트레잇은 퍼사드 패턴의 작동 방식과 마찬가지로 표준 Home API 트레잇을 대신합니다. 간소화된 트레잇은 특정 기기 유형에서 일반적인 작업을 더 쉽게 할 수 있는 명령어를 제공합니다. 단순화된 트레잇은 Home API 트레잇이며 다른 Home API 트레잇과 마찬가지로 Matter 및 Cloud-to-cloud 기기에서 모두 작동합니다.
단순화된 트레잇은 상응하는 표준 트레잇의 속성과 명령어보다 기기별로 더 적합한 대체 하위 집합을 제공합니다.
예를 들어 표준 LevelControlTrait
트레잇은 숫자 값 범위에서 연속적으로 변하는 설정이 있는 모든 기기에 사용할 수 있는 일반 트레잇입니다.
BrightnessTrait
는 LevelControlTrait
를 대신하는 단순화된 트레잇으로, DimmableLightDeviceType
기기에 필요한 명령어와 속성만 제공합니다. BrightnessTrait
에는 단일 brightnessPercent
인수를 사용하는 moveToBrightness
명령어가 있는 반면 LevelControlTrait
에는 여러 move
명령어가 있으며, 대부분의 명령어에는 더 다양한 사용 사례를 수용하기 위해 4개 이상의 매개변수가 있습니다.
다음 표에는 각 단순화된 트레잇과 그에 따른 표준 트레잇이 나와 있습니다. 각 트레잇 이름은 해당 API 문서로 연결됩니다.
간소화된 트레잇 | 표준 트레잇 |
---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTrait OnOffTrait
|
간소화된 트레잇 및 Discovery API
Discovery API는 두 트레잇이 모두 앱 구성에서 ReferencedAutomationTypes
로 올바르게 구성된 경우 간소화된 트레잇과 기본 표준 트레잇을 모두 보고합니다. 예를 들어 DimmableLightDeviceType
기기가 구조에 있고 개발자가 LevelControlTrait
및 BrightnessTrait
트레잇을 모두 등록한 경우 Discovery API는 두 트레잇의 존재를 나타냅니다. 개발자는 자동화에서 두 트레잇 중 하나를 사용할 수 있습니다.
자세한 내용은 홈 구성을 참고하세요.