API platform pembangun AqaraLink: apa yang ditawarkan kepada pembangun
Oleh Synchroweb, pengedar rasmi Aqara di Malaysia · 7 minit bacaan · Dikemas kini
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.
Bahagian
Gunakan apabila
Pengangkutan
Siapa pegang logik
Cloud API
Bahagian belakang anda menjalankan logik, contohnya sistem pengurusan hartanah, portal penghuni, papan pemuka pemantauan
HTTPS permintaan/respons
Pelayan anda
Tolakan mesej
Anda perlukan peristiwa peranti di pelayan tetapi tidak mahu polling
Tolakan HTTP atau tolakan MQ
Pelayan anda, dipacu peristiwa
App SDK
Pengguna akhir mesti menggunakan aplikasi anda, bukan Aqara Home
SDK natif, Android dan iOS
Aplikasi anda
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:
Modul
Perkara yang dilindungi
Position management
Hierarki rumah / bilik / kawasan yang anda cerminkan ke dalam model data anda
Add device interface
Menambah hab atau peranti ke dalam projek di bawah kebenaran anda
Device management
Senarai, soal, namakan, kongsi dan buang peranti
Device resource management
Keadaan langsung setiap sumber yang didedahkan oleh peranti
Device function interface (trait)
Jenis peranti yang disokong, titik fungsi yang disokong, butiran trait kompleks
IR device management
Pemancar inframerah dan set kodnya
Device firmware management
Pertanyaan dan kemas kini perisian tegar
Linkage configuration interface
Membaca semula takrifan automasi
Automation management
Mencipta, menyunting, menjalankan dan memadam automasi
Scene management
Babak
Multi-condition management
Set syarat yang digunakan oleh automasi
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:
Bahagian SDK
Fungsi
Pemasangan peranti / rangkaian pengedaran
Dengan UI, tanpa UI, Magic Pair, Wi-Fi, Ethernet, Bluetooth, dan pengedaran sub-peranti Zigbee
Kawalan peranti
Baca dan beri arahan kepada peranti daripada UI anda sendiri
Kawalan jauh inframerah
Kawal peranti IR daripada aplikasi anda
Barisan produk kamera
Integrasi SDK kamera, senarai peranti yang disokong
Barisan produk kunci pintu
Integrasi dan penggunaan SDK kunci, senarai peranti yang disokong
Data lengkung
Pengendalian data siri masa / trend
OTA
Laluan kemas kini perisian tegar dari sisi aplikasi
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:
Cloud API sahaja, App SDK sahaja, atau kedua-duanya?
Mod kebenaran yang mana? Jika akaun maya, siapa pemilik jadual pemetaan?
Tolakan atau polling, dan di mana titik akhir tolakan berada di Malaysia?
Adakah anda mahu kemas kini perisian tegar dari sisi platform, dan apakah tetingkap penyelenggaraan anda?
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.