iOS'te basitleştirilmiş özellikler

Kullanım kolaylığı için bazı özelliklerin basitleştirilmiş sürümleri iOS'teki Automation API ile kullanılabilir.

Basitleştirilmiş özellik, façade pattern'ın işleyişine benzer şekilde standart bir Home API özelliğinin yerini alır. Basitleştirilmiş özellikler, belirli cihaz türlerinde yaygın görevleri kolaylaştıran komutlar sağlar. Basitleştirilmiş özellikler Home API özellikleridir ve diğer Home API özellikleri gibi hem Matter hem de Cloud-to-cloud cihazlarda çalışır.

Basitleştirilmiş özellik, ilgili standart özellikten daha cihaza özgü olan alternatif bir özellik ve komut alt kümesi sunar. Örneğin, standart LevelControlTrait özelliği, bir sayı aralığında sürekli olarak değişen bir ayarı olan tüm cihazlar için kullanılabilen genel bir özelliktir. BrightnessTrait, LevelControlTrait yerine geçen basitleştirilmiş bir özelliktir ve yalnızca DimmableLightDeviceType cihazının gerektirdiği komutları ve özellikleri sağlar. BrightnessTrait, tek bir brightnessPercent bağımsız değişkeni alan bir moveToBrightness komutuna sahiptir. LevelControlTrait ise daha geniş bir kullanım alanı sağlamak için çoğu en az dört parametreye sahip olan birden fazla move komutuna sahiptir.

Aşağıdaki tabloda her basitleştirilmiş özellik ve temel standart özellikler gösterilmektedir. Her özellik adı, ilgili API belgelerine bağlantı verir:

Tablo: Basitleştirilmiş özellikler
Basitleştirilmiş özellik Standart özellik
SimplifiedThermostatTrait ThermostatTrait
BrightnessTrait LevelControlTrait
SimplifiedOnOffTrait OnOffTrait
VolumeTrait LevelControlTrait
OnOffTrait

Basitleştirilmiş özellikler ve Discovery API

Discovery API, basitleştirilmiş özelliklerin yanı sıra temel özelliklerini de raporlar. Bunun için her iki özellik de uygulamanızın yapılandırmasında ReferencedAutomationTypes olarak doğru şekilde yapılandırılmış olmalıdır. Örneğin, yapıda bir DimmableLightDeviceType cihaz varsa ve geliştirici hem LevelControlTrait hem de BrightnessTrait özelliklerini kaydettiyse Discovery API her iki özelliğin de varlığını gösterir. Geliştirici, otomasyonunda bu özelliklerin ikisinden birini kullanmayı seçebilir.

Daha fazla bilgi için Ev yapılandırması başlıklı makaleyi inceleyin.