Platform Aqara Studio Diterangkan: Kecerdasan Ruang untuk Bangunan
Platform Aqara Studio diterangkan untuk integrator: tiga model penempatan, sokongan protokol, pengurusan ruang, automasi visual dan apa yang kekal di tapak.
Pembangun & penyepadu
Pemalam Aqara Studio, API Terbuka dan MCP: Memperluas Platform
Jawapan ringkas — Pemalam (plugin) pada Aqara Studio mengikut satu kitaran hayat yang berturutan, dan urutannya tidak boleh diubah: Cloud Connect mesti disediakan dahulu, kemudian anda memperoleh pemalam daripada Aqara Builder Lab Marketplace, menetapkannya kepada satu wilayah, ruang dan instans Studio, memasangnya dari Plugin Center, dan barulah keupayaannya tersedia. Pemalam rasmi Aqara dan pemalam yang dibangunkan pengguna mengikut laluan yang sama. Selain ekosistem pemalam, terdapat dua titik sambungan: API setempat untuk Studio, yang mencapai data dan kawalan di dalam persekitaran Studio anda sendiri dan memerlukan instans Studio yang boleh dicapai, alamat perkhidmatannya, token serta data projek dan peranti yang berkaitan; dan API terbuka serta antara muka MCP, yang menyokong aplikasi pihak ketiga dan ejen AI. Cloud Connect ialah prasyarat bagi laluan pemalam, bukan tambahan pilihan.
Aqara Studio ialah sebuah platform, dan platform menjadi berguna apabila sesuatu yang tidak disertakan bersamanya boleh ditambah di atasnya. Studio mempunyai tiga laluan sedemikian: ekosistem pemalam, API setempat untuk Studio, serta API terbuka bersama antara muka MCP. Setiap satu menjawab soalan yang berbeza. Pemalam menambah keupayaan di dalam ruang. API setempat membaca dan menulis di dalam persekitaran Studio anda sendiri. API terbuka dan antara muka MCP membolehkan aplikasi luaran atau ejen AI mencapai ruang itu.
Catatan ini membincangkan mekanisme yang perlu anda ketahui sebelum menulis sebarang kod integrasi.
Kitaran hayat pemalam, dari awal hingga akhir
Aqara mendokumenkan aliran pemalam sebagai satu urutan yang mempunyai kebergantungan. Tersalah urutan ialah punca paling biasa pemalam kelihatan berjaya dipasang tetapi tidak berbuat apa-apa.
- Sediakan Cloud Connect dahulu. Ini prasyarat, bukan ciri. Tanpa Cloud Connect yang dikonfigurasi dan dipautkan kepada persekitaran Studio, langkah memperoleh dan memasang tiada apa untuk dipaut.
- Peroleh pemalam daripada Aqara Builder Lab Marketplace.
- Tetapkan kepada satu wilayah, satu ruang dan satu instans Studio. Pemalam yang telah diperoleh tetapi tidak ditetapkan tidak mempunyai skop, dan pemalam dengan skop yang salah sama ada tidak berbuat apa-apa atau bertindak di tempat yang tidak anda maksudkan.
- Pasang dari Plugin Center di dalam Studio.
- Keupayaannya tersedia setelah pemasangan selesai — keupayaan peranti baharu, tindakan baharu, data baharu, bergantung pada fungsi pemalam itu.
| Langkah | Apa yang sebenarnya berlaku | Bergantung pada | Kegagalan lazim |
|---|---|---|---|
| 1. Cloud Connect | Pautan awan diwujudkan untuk persekitaran Studio | Akaun, wilayah dan persekitaran Studio | Dilangkau sepenuhnya, lalu langkah 3–5 nampak tersekat |
| 2. Peroleh | Pemalam diperoleh daripada Builder Lab Marketplace | Akaun yang sah dan akses pasaran | Pemalam diperoleh untuk wilayah yang salah |
| 3. Tetapkan | Pemalam diskopkan kepada wilayah, ruang dan Studio | Hierarki ruang sudah wujud | Struktur ruang belum dibina, jadi tiada apa untuk diskopkan |
| 4. Pasang | Pemalam dipasang dari Plugin Center | Langkah 1–3 selesai | Dipasang sebelum penetapan |
| 5. Keupayaan tersedia | Keupayaan dan tindakan peranti muncul dalam Studio | Dalam sesetengah kes, Studio perlu dimulakan semula atau disegarkan | Menganggap pemasangan yang gagal sebagai kerosakan peranti |
Langkah 3 ialah yang sering memerangkap orang. Penetapan memerlukan hierarki ruang wujud. Jika anda belum memodelkan bangunan itu, anda tidak boleh menskopkan pemalam kepada sesebuah bilik, kerana tiada objek bilik dalam platform. Bina struktur ruang dahulu — lihat catatan kami tentang platform Aqara Studio untuk cara hierarki itu ditakrifkan.
Pemalam rasmi dan pemalam yang dibangunkan pengguna
Pasaran menyediakan kedua-duanya. Pemalam rasmi Aqara ialah pilihan pertama untuk projek yang mempunyai obligasi sokongan, kerana ada pengeluar di belakangnya. Pemalam yang dibangunkan pengguna ialah cara pembina mendapatkan sesuatu yang tidak dilindungi katalog rasmi — panel BMS tertentu, kerenah protokol setempat, atau alat pelaporan dalaman — dan ia sepenuhnya sah pada projek yang penyelenggaraannya anda sendiri bertanggungjawab.
Disiplin praktikalnya sama sahaja: catatkan apa yang dilakukan pemalam itu, apa yang dicapainya, dan apa yang berlaku jika ia berhenti berfungsi. Pemalam yang gagal secara senyap pada pukul 2 pagi lebih teruk daripada yang menimbulkan ralat, dan terpulang kepada anda sama ada menerima risiko itu pada bangunan pelanggan.
API setempat untuk Studio
API setempat ialah untuk berintegrasi dengan data dan kawalan di dalam Aqara Studio. Ia laluan untuk papan pemuka pengurusan bangunan, jambatan BMS, atau alat dalaman yang perlu membaca apa yang diketahui oleh ruang itu dan mencetuskan apa yang boleh dilakukan oleh ruang itu.
Sebelum menulis satu baris kod pun, anda memerlukan empat perkara. Dokumentasi Aqara menyenaraikannya secara langsung:
| Keperluan | Maksudnya | Mengapa tidak boleh dilangkau |
|---|---|---|
| Persekitaran Studio yang boleh dicapai | Instans Studio yang benar-benar boleh anda capai, pada model penempatan yang anda pilih | Tiada API untuk persekitaran yang tidak boleh anda capai |
| Alamat perkhidmatannya | Titik akhir persekitaran Studio itu | Ia satu-satunya alamat yang dituju panggilan |
| Token | Kelayakan untuk persekitaran itu | Tanpanya, persekitaran menolak setiap permintaan |
| Data projek dan peranti yang berkaitan | Projek, ruang dan peranti yang menjadi subjek panggilan | API tidak boleh memulangkan data bagi objek yang tiada rekodnya |
Baris terakhir itulah tempat projek pembina tersekat. Panggilan API setempat yang tidak memulangkan apa-apa selalunya bukan masalah API — ia masalah pemodelan ruang. Jika peranti tidak dipautkan ke dalam hierarki ruang, tiada objek semantik untuk dialamatkan oleh API. Untuk latar belakang mengapa hierarki itu penting, mulakan dengan Aqara Studio diterangkan.
API terbuka dan antara muka MCP
API terbuka dan antara muka MCP ialah yang memperluas platform melangkaui sempadannya sendiri, kepada aplikasi pihak ketiga dan ejen AI.
API terbuka untuk aplikasi anda sendiri berhubung dengan platform — aplikasi mudah alih, sistem tempahan, papan pemuka operator, atau saluran pelaporan. Jika anda memerlukan aplikasi natif dan bukannya alat berasaskan pelayar, catatan kami tentang membenamkan SDK Aqara dalam aplikasi anda merangkumi sebelah klien kerja itu.
Antara muka MCP ialah yang penting bagi hala tuju Aqara. Ontologi ruang platform itu dihuraikan oleh Aqara sebagai penting untuk mengintegrasikan ejen AI pihak ketiga. MCP memberi ejen cara berstruktur yang berbentuk alat untuk mencapai ruang, bukannya antara muka teks yang longgar. Ejen yang boleh bertanya "zon mana di sayap timur yang sedang dihuni" melakukan sesuatu yang berbeza sama sekali daripada ejen yang hanya boleh diberitahu apa yang perlu dibuat.
Kekangan praktikalnya ialah disiplin pemodelan yang sama terpakai. Ejen hanya boleh membuat penaakulan atas perkara yang telah dihuraikan. Pemodelan natif ontologi menjadikan tugas ejen itu boleh dilaksanakan — ia bukan sekadar hiasan teori.
Permukaan pembangun di sebelah awan, termasuk butiran API dan SDK, dibincangkan secara berasingan dalam catatan kami tentang platform pembangun AqaraLink. Kami sengaja tidak mengulangi bilangan API atau modul yang khusus di sini — sila sahkan angka semasa dengan kami dan jangan bergantung pada angka yang disiarkan yang mungkin sudah berubah.
Urutan kerja untuk pembina
Jika anda memulakan integrasi pada projek yang sedang berjalan, urutan ini mengelakkan kerja berulang:
- Tentukan model penempatan (deployment) — bersepadu dalam hab, penempatan edge atau dihoskan di awan — sebelum apa-apa lagi. Ia menentukan di mana Cloud Connect dan titik akhir API setempat sebenarnya berada. Pertukarannya ada dalam memilih model penempatan untuk kecerdasan ruang di Malaysia.
- Bina hierarki ruang. Wilayah, ruang, zon, objek terpaut. Tiada apa-apa lain boleh diskopkan sehingga ini wujud.
- Sediakan Cloud Connect dan sahkan ia dipautkan kepada persekitaran Studio.
- Peroleh, tetapkan, pasang pemalam — mengikut urutan itu — dan sahkan keupayaan muncul sebelum membina apa-apa di atasnya.
- Kumpulkan empat prasyarat API setempat dan sahkan akses kepada persekitaran Studio dari mana-mana perkhidmatan anda akan dijalankan.
- Uji laluan itu sebelum bangunan menguji anda. Pemalam yang berfungsi di meja ujian tetapi gagal di tapak hampir selalunya masalah skop, token atau kebolehcapaian.
Perkara yang tidak dituntut oleh halaman ini
- Ia tidak menuntut harga yang disahkan di Malaysia, atau stok di Malaysia, bagi Aqara Studio, Studio Connect, sebarang langganan Studio atau sebarang pelesenan.
- Ia tidak menuntut bilangan tertentu API, modul atau pemalam pasaran. Sila sahkan katalog semasa dengan kami.
- Ia tidak menuntut bahawa Edge Hub M300 boleh dibeli di Malaysia. Wilayah jualan yang didokumenkan ialah Tanah Besar China, Amerika Utara, Eropah dan Rusia.
- Ia tidak menjanjikan bahawa pemalam yang dibangunkan pengguna mempunyai laluan sokongan yang sama seperti pemalam rasmi Aqara. Anda perlu menentukannya sendiri sebelum memasang pemalam sedemikian pada bangunan pelanggan.
