Otomatisasi adalah cara untuk mengotomatiskan tugas dan setelan perangkat di rumah. Otomatisasi telah tersedia di ekosistem Google Home sebagai Rutinitas di Google Home app (GHA) dan melalui automation script editor di Google Home for web.
Kini, Otomatisasi di ekosistem Google Home tersedia melalui Home API untuk Android. Otomatisasi menggunakan konsep dasar yang sama seperti yang digunakan dalam GHA Rutinitas dan script editor, tetapi dengan fitur dan kemampuan yang ditingkatkan yang hanya dapat dilakukan melalui Home API, termasuk:
- Akses ke semua Matter standar dan smart home karakteristik untuk perangkat, seperti yang ditampilkan di Home API.
- Dukungan untuk alur eksekusi berurutan, paralel, dan pilih.
Otomatisasi ditulis menggunakan Automation DSL, bahasa khusus domain yang dirancang untuk membuat otomatisasi di Kotlin.
Setiap karakteristik dan jenis yang ingin Anda gunakan di aplikasi dengan Device &Structure atau Automation API harus didaftarkan saat inisialisasi. Lihat Menginisialisasi smart home di Android.
Panduan jika pengguna mencabut izin penuh
Jika pengguna mencabut izin penuh, semua otomatisasi yang ada akan berhenti berfungsi. Selain itu, jika pengguna mencabut akses ke perangkat tertentu, pemicu, kondisi, dan tindakan yang terkait dengan perangkat tersebut akan berhenti berfungsi.
Setiap kali aplikasi dimulai, pastikan untuk memeriksa apakah izin masih berlaku. Jika izin telah dicabut, pastikan semua data sebelumnya dihapus, termasuk data yang di-cache di aplikasi.
Perjalanan developer
Automation API adalah salah satu bagian dari perjalanan pengembangan yang lebih besar. API ini hadir setelah mengintegrasikan Structure dan Device API untuk memastikan bahwa saat pengguna ingin menggunakan otomatisasi, mereka dapat melakukannya.
- Developer merencanakan otomatisasinya, dan menentukannya menggunakan Automation DSL.
- Developer menyematkan definisi otomatisasi di aplikasi Android Kotlin.
- Aplikasi menyajikan otomatisasi kepada pengguna berdasarkan informasi tentang perangkat mereka, termasuk karakteristik, atribut, perintah, dan peristiwa, yang dikumpulkan menggunakan Discovery API atau Device API.
- Dengan Discovery API, aplikasi dapat membuat draf otomatisasi yang disesuaikan dengan jenis perangkat dan karakteristik yang ada dalam struktur pengguna, dengan atau tanpa input pengguna.
- Device API dapat memberikan sebagian besar informasi yang sama dengan Discovery API, tetapi tidak dioptimalkan untuk kasus penggunaan otomatisasi. Lihat Membandingkan Device API dan Discovery API untuk mengetahui detail selengkapnya.
- Aplikasi membuat otomatisasi sebenarnya yang dikunci ke struktur yang dipilih.
- Otomatisasi kini tersedia dalam struktur pengguna dan dapat dijalankan atau dihapus menggunakan metode Structure API.
Pengguna dapat membuat instance baru otomatisasi kapan saja, memilih struktur yang berbeda atau, bergantung pada logika aplikasi, mungkin kumpulan perangkat yang berbeda. Setiap kali pengguna melakukannya, aplikasi akan membuat instance baru otomatisasi.
Dalam skenario paling dasar, Anda dapat menyarankan otomatisasi yang telah ditentukan kepada pengguna yang melakukan tugas yang relatif mendasar. Atau, Anda dapat menyajikan kerangka otomatisasi yang disesuaikan pengguna untuk memenuhi kebutuhannya. Atau, Anda dapat menulis editor otomatisasi terbuka yang memungkinkan pengguna membuat otomatisasi kompleks menggunakan semua blok penyusun yang tersedia di Automation API.
Saran otomatisasi
Home API dapat menyarankan otomatisasi untuk
Structure berdasarkan faktor
seperti jenis perangkat yang ada di ruang.
Saran otomatisasi diwakili oleh the
AutomationSuggestion
class.
Antarmuka Structure mencakup antarmuka HasSuggestions, yang menyediakan fungsi suggestions(), yang menampilkan kumpulan saran otomatisasi.
Metode
likeSuggestion()
dan
dislikeSuggestion()
dimaksudkan untuk terhubung ke kontrol UI
dan
yang dapat diketuk pengguna
untuk memberikan masukan.
Metode ketiga,
clearSuggestionFeedback(),
memungkinkan pengguna menghapus masukan mereka untuk otomatisasi yang disarankan.
Masukan pengguna memengaruhi saran di masa mendatang.
Batas Resource
Batas berikut berlaku untuk otomatisasi di Home API:
| Metrik | Batas |
|---|---|
| Jumlah maksimum otomatisasi per struktur | 64 |
| Jumlah maksimum node per otomatisasi | 128 |
| Jumlah maksimum node ekspresi per otomatisasi | 64 |
| Jumlah maksimum instance otomatisasi per struktur | 1024 |
| Jumlah maksimum instance otomatisasi per developer per struktur | 64 |
| Jumlah maksimum eksekusi per struktur per hari | 1024 |
| Jumlah maksimum eksekusi per developer per struktur per hari | 128 |