API platform pembangun AqaraLink: apa yang ditawarkan kepada pembangun

Jawapan ringkas — AqaraLink ialah platform pembangun Aqara yang dikendalikan oleh Lumi United Technology. Ia mempunyai dua bahagian: API HTTP awan serta tolakan mesej (message push) untuk kerja pelayan-ke-pelayan, dan set App SDK (Android dan iOS) untuk meletakkan fungsi pemasangan peranti, kawalan, kamera, kunci, lengkung data dan OTA di dalam aplikasi anda sendiri. Dokumen bahasa Inggeris di opendoc.aqara.com menyusun permukaan API kepada 11 modul.

Apakah sebenarnya platform ini

Aqara mengutamakan Zigbee. Kebanyakan produknya ialah mesh peranti kecil berkuasa bateri yang melapor kepada hab, dan hab itulah yang berhubung dengan awan. Hakikat ini membentuk keseluruhan cerita pembangunan: aplikasi anda tidak bercakap dengan penderia di Seri Kembangan. Aplikasi anda bercakap dengan hab di unit itu, dan hab itu bercakap dengan penderia. Apa sahaja yang anda bina mesti mengambil kira perkara ini.

Dokumentasi menerangkan AqaraLink sebagai platform kerjasama terbuka untuk produk perisian dan perkakasan IoT daripada Lumi United Technology, meliputi rumah pintar, hotel, pejabat dan pendidikan. Bagi integrator Malaysia, bahagian yang berguna lebih sempit dan konkrit: API awan membolehkan pelayan anda menyoal status peranti, menghantar arahan kawalan jauh dan mengkonfigurasi linkage/automasi. Perkhidmatan tolakan mesej pula menghantar laporan peranti masa nyata terus ke pelayan anda tanpa perlu membuat polling.

Dokumen berada di opendoc.aqara.com. Versi Bahasa Cina Ringkas berada di domain asas; versi bahasa Inggeris ialah yang patut dijadikan rujukan pembangunan.

Dua bahagian, bukan satu

Kebanyakan kesilapan integrasi berlaku kerana pasukan memilih bahagian yang salah pada hari pertama.

Jika anda membina lapisan tambahan pengurusan bangunan atau aplikasi kemudahan, anda hampir pasti berada dalam dua baris pertama. Jika anda membina aplikasi pengguna yang mengendalikan proses pendaftaran peranti sendiri, anda berada dalam baris ketiga. Baris pertama dan ketiga boleh wujud bersama, tetapi ia memerlukan kerja tambahan.

Peta modul API awan

Bab API List dalam dokumentasi bahasa Inggeris disusun kepada 11 modul. Inilah bentuk permukaan API, dan ia patut diketahui sebelum anda menulis satu permintaan pun:

Dua nota reka bentuk yang menjimatkan masa. Pertama, fungsi peranti berasaskan trait, bukan model peranti yang rata: anda tidak mendapat satu API "suis", sebaliknya lapisan trait dengan senarai jenis peranti yang disokong dan senarai titik fungsi yang disokong. Tulis integrasi anda berdasarkan trait dan kos menambah model peranti baharu jauh lebih rendah. Kedua, pengurusan perisian tegar ialah modul utama, bermakna kawalan perisian tegar jarak jauh adalah mungkin. Putuskan awal sama ada projek anda membenarkan platform melakukannya, kerana bagi blok kondominium yang diurus, anda memerlukan dasar tetingkap penyelenggaraan, bukan kemas kini senyap.

Kebenaran: bahagian yang menentukan model data anda

Dokumentasi menerangkan tiga mod kebenaran, dan yang ketiga paling penting bagi sesiapa yang mengintegrasikan dengan sistem akaun sedia ada.

• Kebenaran akaun Aqara: pengguna sebenar log masuk dengan akaun Aqara dan memberi anda akses. Mudah untuk aplikasi pengguna.
• Kebenaran projek: anda mengendalikan satu projek (sebuah blok, hotel, kampus) dan memegang kuasa ke atas peranti di dalamnya, tanpa akaun pengguna bagi setiap orang.
• Kebenaran akaun maya: anda mencipta akaun Aqara maya untuk menyambung ke sistem akaun pihak ketiga anda sendiri. Jika sistem pengurusan hartanah anda sudah ada log masuk penghuni, rekod unit dan model peranan, beginilah cara memetakannya. Pengguna anda tidak pernah melihat akaun Aqara; platform menyimpan pemetaannya.

Untuk kerja kondominium dan hotel, kebenaran akaun maya hampir selalu menjadi titik permulaan yang betul. Rancangkannya pada minggu pertama, kerana menukar model kebenaran selepas unit disediakan amat menyusahkan.

Tolakan mesej, HTTP dan MQ

Tolakan (push) menentukan sama ada produk pemantauan berfungsi atau tidak. Polling setiap peranti setiap 30 saat merentasi pembangunan 2,000 unit tidak boleh berskala dan akan menyebabkan anda dihadkan kadar (rate-limited).

Perkhidmatan tolakan mesej menyokong tolakan HTTP dan tolakan MQ, dan dokumentasi menerangkan mod tolakan, format tolakan, API tolakan serta API tolakan berasaskan trait. Ringkasnya: anda memilih saluran, menentukan mod langganan, dan Aqara menghantar status yang dilaporkan peranti ke titik akhir yang anda kawal. Anda perlu memutuskan di mana titik akhir itu berada. Bagi projek Malaysia, soalan pertama biasanya sama ada pelayan setempat di dalam bangunan atau awan di rantau Singapura. Ini soal kediaman data, bukan soal MQTT lawan HTTPS.

Bahagian App SDK

Jika aplikasi anda yang perlu mengendalikan pendaftaran peranti, SDK dibahagikan mengikut tugas:

Pemasangan sub-peranti Zigbee ialah bahagian yang mesti anda kuasai. Penderia Zigbee tidak menyertai Wi-Fi pelanggan anda. Ia menyertai hab. Jika aliran pendaftaran anda menganggap senarai peranti yang rata tiba melalui rangkaian, ia tidak akan bertahan dalam pemasangan Aqara sebenar.

Sudut Matter SDK

Matter SDK dalam panduan pembangunan Android dan iOS didokumenkan dengan halaman integrasi, penggunaan dan peranti yang disokong tersendiri, dan syaratnya jelas: Matter SDK memerlukan pengawal Matter. Sub-peranti Matter mesti disambungkan dahulu ke hab Matter Aqara menggunakan protokol Magic Pair Aqara, dan barulah konfigurasi serta kawalan peranti boleh dilakukan pada skrin.

Fahamilah ini sebagai fakta pemasangan, bukan perincian teknikal. Matter tidak membolehkan kondominium Malaysia melangkau hab di dalam kotak DB. Ini bermakna hab masih perkara paling penting yang anda tentukan spesifikasinya semasa penyerahan, dan itulah hujah dalam spesifikasi penyerahan rumah pintar kondominium kami serta sebab platform pembangun ini dan penerangan Matter mesti dibaca bersama.

Skala, dan maksudnya untuk projek di Malaysia

Hab Aqara boleh mengawal sehingga 128 peranti berkaitan. Angka inilah yang membentuk pelan lantai: pembangunan 2,000 unit dengan lobi bersama, gim, dek kolam, pintu pagar tempat letak kereta dan pemasangan setiap unit bukan satu mesh. Peruntukkan bajet untuk kedudukan hab, serta kabel rangkaian dan bekalan kuasa yang menyertainya.

Pilihan hab dalam barisan produk Malaysia termasuk Hub M3, Hub M200 dan Hub M100, serta hab kamera seperti Camera Hub G3 dan Camera Hub G5 Pro. Panel Hub S1 Plus itu sendiri ialah hab Zigbee, dan boleh mengawal aksesori Matter setelah ditambah melalui pengawal Matter seperti Hub M3.

Sebelum anda melabur masa kejuruteraan

Tanyakan lima soalan ini dan catatkan jawapannya:

1. Cloud API sahaja, App SDK sahaja, atau kedua-duanya?
2. Mod kebenaran yang mana? Jika akaun maya, siapa pemilik jadual pemetaan?
3. Tolakan atau polling, dan di mana titik akhir tolakan berada di Malaysia?
4. Adakah anda mahu kemas kini perisian tegar dari sisi platform, dan apakah tetingkap penyelenggaraan anda?
5. Siapa pemilik hab, pemasangan dan pemasangan semula secara fizikal apabila unit dijual semula?

Soalan kelima paling kerap terlepas pandang dan paling banyak mencetuskan panggilan sokongan tiga tahun kemudian.