Sifat yang disederhanakan di iOS

Untuk kemudahan penggunaan, versi sederhana dari beberapa karakteristik tersedia untuk digunakan dengan Automation API di iOS.

Trait yang disederhanakan menggantikan trait Home API standar, mirip dengan cara kerja pola fasad. Trait yang disederhanakan menyediakan perintah yang mempermudah tugas umum untuk jenis perangkat tertentu. Trait yang disederhanakan adalah trait Home API, dan, seperti trait Home API lainnya, trait ini berfungsi untuk perangkat Matter dan Cloud-to-cloud.

Trait sederhana menawarkan subset alternatif atribut dan perintah yang lebih spesifik per perangkat daripada atribut dan perintah trait standar yang sesuai. Misalnya, sifat LevelControlTrait standar adalah sifat generik yang dapat digunakan untuk perangkat apa pun yang memiliki setelan yang bervariasi secara berkelanjutan di seluruh rentang nilai numerik. BrightnessTrait adalah trait sederhana yang menggantikan LevelControlTrait dan hanya menyediakan perintah dan atribut yang diperlukan perangkat DimmableLightDeviceType. BrightnessTrait memiliki perintah moveToBrightness yang menggunakan satu argumen brightnessPercent, sedangkan LevelControlTrait memiliki beberapa perintah move, yang sebagian besar memiliki setidaknya empat parameter untuk mengakomodasi berbagai kasus penggunaan.

Tabel berikut menunjukkan setiap sifat yang disederhanakan dan sifat standar yang mendasarinya. Setiap nama karakteristik ditautkan ke dokumentasi API yang sesuai:

Tabel: Ciri-ciri yang disederhanakan

Trait yang disederhanakan	Ciri standar
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Trait yang disederhanakan dan Discovery API

Discovery API melaporkan sifat yang disederhanakan serta sifat standar yang mendasarinya, selama kedua sifat tersebut dikonfigurasi dengan benar sebagai ReferencedAutomationTypes dalam konfigurasi untuk aplikasi Anda. Misalnya, jika perangkat DimmableLightDeviceType ada dalam struktur, dan developer mendaftarkan sifat LevelControlTrait dan BrightnessTrait, Discovery API akan menunjukkan keberadaan kedua sifat tersebut. Developer dapat memilih untuk menggunakan salah satu karakteristik dalam otomatisasinya.

Lihat Konfigurasi rumah untuk mengetahui informasi selengkapnya.