iOS의 간소화된 트레잇

사용 편의성을 위해 일부 특성의 간소화된 버전을 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는 두 속성이 모두 있음을 나타냅니다. 개발자는 자동화에서 두 특성 중 하나를 사용할 수 있습니다.

자세한 내용은 홈 구성을 참고하세요.