iOS의 간소화된 트레잇

사용 편의성을 위해 일부 특성의 간소화된 버전을 iOS의 자동화 API와 함께 사용할 수 있습니다.

간소화된 특성은 퍼사드 패턴이 작동하는 방식과 유사하게 표준 Home API 특성을 대신합니다. 간소화된 특성은 특정 기기 유형의 일반적인 작업을 더 쉽게 수행할 수 있는 명령어를 제공합니다. 간소화된 특성은 Home API 특성이며 다른 Home API 특성과 마찬가지로 Matter 및 Cloud-to-cloud 기기 모두에서 작동합니다.

단순화된 특성은 해당 표준 특성의 속성 및 명령어보다 기기별로 더 적합한 대체 속성 및 명령어 하위 집합을 제공합니다. 예를 들어 표준 LevelControlTrait 특성은 숫자 값 범위에서 지속적으로 변하는 설정이 있는 모든 기기에 사용할 수 있는 일반 특성입니다. BrightnessTrait는 LevelControlTrait를 대신하는 단순화된 특성으로, DimmableLightDeviceType 기기에 필요한 명령과 속성만 제공합니다. BrightnessTrait에는 단일 brightnessPercent 인수를 사용하는 moveToBrightness 명령어가 있는 반면 LevelControlTrait에는 다양한 사용 사례를 수용하기 위해 대부분 4개 이상의 매개변수가 있는 여러 move 명령어가 있습니다.

다음 표에는 각 단순화된 특성과 기본 표준 특성이 표시되어 있습니다. 각 특성 이름은 해당 API 문서로 연결됩니다.

표: 간소화된 특성

단순화된 특성	표준 특성
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

간소화된 특성 및 Discovery API

두 특성이 앱 구성에서 ReferencedAutomationTypes로 올바르게 구성된 경우 Discovery API는 기본 표준 특성과 함께 간소화된 특성을 보고합니다. 예를 들어 DimmableLightDeviceType 기기가 구조에 있고 개발자가 LevelControlTrait 및 BrightnessTrait 특성을 모두 등록한 경우 Discovery API는 두 특성이 모두 있음을 나타냅니다. 개발자는 자동화에서 두 특성 중 하나를 선택하여 사용할 수 있습니다.

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