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 fasad. 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 alternatif dari atribut dan perintah yang lebih spesifik untuk perangkat daripada karakteristik standar yang sesuai.
Misalnya, karakteristik standar
LevelControlTrait
adalah karakteristik generik 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 oleh perangkat
DimmableLightDeviceType. BrightnessTrait memiliki
moveToBrightness
perintah yang menggunakan satu brightnessPercent argumen, sedangkan
LevelControlTrait memiliki beberapa move perintah, yang sebagian besar memiliki setidaknya
empat parameter untuk mengakomodasi berbagai kasus penggunaan.
Tabel berikut menampilkan setiap karakteristik yang disederhanakan dan karakteristik standar yang mendasarinya. Setiap nama karakteristik ditautkan ke dokumentasi API yang sesuai:
| Karakteristik yang disederhanakan | Karakteristik standar |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
Karakteristik yang disederhanakan dan Discovery API
Discovery API melaporkan karakteristik yang disederhanakan serta karakteristik standar yang mendasarinya, selama kedua karakteristik 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 smart home untuk mengetahui informasi selengkapnya.