Untuk kemudahan penggunaan, versi sederhana dari beberapa karakteristik tersedia untuk digunakan dengan Automation API di iOS.
Karakteristik yang disederhanakan menggantikan karakteristik Home API standar, mirip dengan cara kerja pola facade. Karakteristik yang disederhanakan menyediakan perintah yang memudahkan tugas umum untuk jenis perangkat tertentu. Karakteristik yang disederhanakan adalah karakteristik Home API, dan, seperti karakteristik Home API lainnya, karakteristik ini berfungsi untuk perangkat Matter dan Cloud-to-cloud.
Karakteristik yang disederhanakan menawarkan subset atribut dan perintah alternatif yang
lebih spesifik untuk perangkat daripada karakteristik standar yang sesuai.
Misalnya, karakteristik
LevelControlTrait
standar adalah karakteristik umum yang dapat digunakan untuk perangkat apa pun yang memiliki
setelan yang bervariasi secara terus-menerus di berbagai nilai numerik.
BrightnessTrait adalah
karakteristik yang disederhanakan 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 karakteristik yang disederhanakan dan karakteristik standar yang mendasarinya. Setiap nama karakteristik tertaut ke dokumentasi API yang sesuai:
| Karakteristik yang disederhanakan | Karakteristik standar |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Ciri yang disederhanakan dan Discovery API
Discovery API melaporkan karakteristik yang disederhanakan serta karakteristik standar yang mendasarinya, asalkan kedua karakteristik tersebut dikonfigurasi dengan benar sebagai ReferencedAutomationTypes dalam konfigurasi untuk aplikasi Anda. Misalnya, jika perangkat DimmableLightDeviceType ada dalam struktur, dan developer mendaftarkan karakteristik LevelControlTrait dan BrightnessTrait, Discovery API akan menunjukkan keberadaan kedua karakteristik tersebut. Developer dapat memilih untuk menggunakan salah satu karakteristik dalam otomatisasinya.
Lihat Konfigurasi rumah untuk mengetahui informasi selengkapnya.