Google Home API untuk Android menyediakan platform API terpadu untuk memungkinkan developer berinteraksi dengan status entitas di rumah pengguna. Entitas ini dapat mendeskripsikan perangkat dan informasi non-perangkat yang terkait dengan struktur dan ruangan pengguna.
Home API menentukan entitas berikut yang dapat digunakan pengguna untuk berinteraksi:
- Struktur merepresentasikan rumah yang berisi ruangan dan perangkat.
- Ruangan adalah bagian dari struktur dan berisi perangkat.
- Perangkat menerapkan fitur yang berisi atribut, sesuai dengan jenis, memancarkan peristiwa, dan merespons perintah.
- Otomatisasi adalah bagian dari struktur dan menggunakan metadata dan perangkat rumah untuk mengotomatiskan tugas di rumah.
Gambar 1 mengilustrasikan arsitektur ini:
Jenis perangkat Home API dapat didukung oleh Matter, standar terbuka untuk smart home, atau berupa perangkat Cloud-to-cloud di ekosistem Google Home. Beberapa jenis perangkat dapat menggabungkan fungsi dari keduanya. Lihat Jenis perangkat yang didukung di Android untuk mengetahui informasi selengkapnya.
Di Matter, fungsi perangkat dikelompokkan berdasarkan cluster, yang direpresentasikan di Home API sebagai karakteristik standar Matter. Home API mendukung kumpulan standar cluster Matter seperti yang ditentukan dalam spesifikasi Matter saat ini.
Dalam ekosistem Google Home, fungsi perangkat dikelompokkan berdasarkan sifat smart home, yang ditampilkan di Home API sebagai sifat smart home Google. Home API mendukung serangkaian karakteristik smart home seperti yang ditentukan dalam program Cloud-to-cloud.
Ciri lainnya, seperti Cluster khusus produsen dan Ciri platform, juga tersedia. Untuk mempelajari lebih lanjut, lihat Model data di Android.
Ekosistem
Ekosistem Google Home menyediakan fondasi yang disederhanakan untuk membangun, mengelola, mengamankan, dan mengintegrasikan pengalaman smart home. Gambar 2 menunjukkan cara kerja semua komponen bersama-sama.
Ekosistem ini mencakup Google Automation Engine yang menyimpan dan menjalankan otomatisasi yang menyediakan cara untuk mengotomatiskan tugas dan setelan perangkat di rumah.
Home API menggunakan OAuth 2.0 untuk memberikan akses ke perangkat dalam struktur. OAuth memungkinkan pengguna memberikan izin ke aplikasi atau layanan tanpa harus mengungkapkan kredensial login mereka.
Google Home Developer Console digunakan untuk mengelola semua tahap project Home API, mulai dari verifikasi merek, hingga pengembangan, pengujian, dan sertifikasi hingga peluncuran akhir. API ini menyederhanakan proses pengembangan sekaligus menyediakan alat dan distribusi yang andal melalui ekosistem Google Home.
Language
Home API untuk Android ditulis dalam Kotlin dan menyediakan antarmuka Kotlin idiomatis yang menggunakan Flow untuk mengelola status dan langganan. Hal ini memberikan sejumlah keunggulan dibandingkan API langganan standar.
Sebaiknya Anda memahami dokumentasi Kotlin tentang coroutine, flow, dan Jetpack Compose, jika Anda belum melakukannya:
- Mengembangkan aplikasi Android dengan Kotlin
- Mempelajari Kotlin untuk Android
- Coroutine Kotlin di Android. Codelab spesifik berikut mungkin berguna:
- Flow Kotlin di Android dan lebih khusus lagi, StateFlow.
- Status dan Jetpack Compose, khususnya fungsi
collectAsStateWithLifecycle(). Fungsi ini otomatis mengelola berlangganan dan berhenti berlangganan dari alur berdasarkan apakah UI yang menampilkan status tersebut benar-benar berada di latar depan atau tidak. - Jika Anda menggunakan Automation API, membaca tentang builder jenis aman Kotlin akan berguna untuk memahami cara kerja Automation DSL.
ID entitas
Setiap entity di Home API memiliki ID yang mewakili ID utamanya. ID ini adalah ID unik dan stabil yang tidak akan pernah berubah selama masa aktif entitas. ID ini dapat digunakan untuk menyimpan objek dalam cache atau memeriksa kesamaan karena metadata entitas dapat berubah.
Lihat antarmuka HasId untuk mempelajari
entitas mana yang memiliki ID.
Pemetaan terminologi
Entitas di Home API dipetakan ke konsep Matter dan Cloud-to-cloud sebagai berikut:
| API Home | Matter | Cloud-to-cloud |
|---|---|---|
| Ciri | Cluster | Ciri |
| Atribut | Atribut | Atribut, Status |
| Perintah | Perintah | Perintah |
| Acara | Acara | Respons tindak lanjut, Notifikasi |