Sifat yang disederhanakan di iOS

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

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

Sifat yang disederhanakan menawarkan subset alternatif atribut dan perintah yang lebih spesifik per perangkat daripada sifat 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 sifat 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 yang lebih luas.

Tabel berikut menunjukkan setiap karakteristik sederhana dan karakteristik standar yang mendasarinya. Setiap nama ciri ditautkan ke dokumentasi API terkait:

Tabel: Sifat yang disederhanakan

Sifat yang disederhanakan	Sifat standar
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

Sifat yang disederhanakan dan Discovery API

Discovery API melaporkan karakteristik sederhana serta karakteristik standar yang mendasarinya, selama 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 sifat dalam otomatisasi mereka.

Lihat Konfigurasi rumah untuk mengetahui informasi selengkapnya.