Ringkasan Automation API

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.

Sekarang, Otomatisasi di ekosistem Google Home tersedia melalui Home API. Keduanya menggunakan konsep dasar yang sama dengan yang digunakan dalam Rutinitas GHA dan script editor, tetapi dengan fitur dan kemampuan yang ditingkatkan yang hanya dapat dilakukan melalui Home API, termasuk:

  • Akses ke semua karakteristik Matter standar dan smart home untuk perangkat, seperti yang ditampilkan di Home API.
  • Dukungan untuk alur eksekusi berurutan, paralel, dan tertentu.

Otomatisasi ditulis menggunakan Automation DSL, bahasa khusus domain yang dirancang untuk mem-build otomatisasi di Kotlin.

Setiap karakteristik dan jenis yang ingin Anda gunakan di aplikasi dengan Device & Structure atau Automation API harus didaftarkan saat inisialisasi. Lihat Melakukan inisialisasi rumah.

Perjalanan developer

Automation API adalah salah satu bagian dari perjalanan pengembangan yang lebih besar. Hal ini dilakukan setelah mengintegrasikan Structure dan Device API untuk memastikan bahwa saat pengguna ingin menggunakan otomatisasi, mereka dapat melakukannya.

  1. Developer merencanakan otomatisasi, dan menentukannya menggunakan Automation DSL.
  2. Developer menyematkan definisi otomatisasi di aplikasi Android Kotlin.
  3. Aplikasi menampilkan otomatisasi kepada pengguna berdasarkan informasi tentang perangkat mereka, termasuk karakteristik, atribut, perintah, dan peristiwa, yang dikumpulkan menggunakan Discovery API atau Device API.
    1. Dengan Discovery API, aplikasi dapat menghasilkan otomatisasi draf yang disesuaikan dengan jenis dan karakteristik perangkat yang ada dalam struktur pengguna, dengan atau tanpa input pengguna.
    2. 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.
  4. Aplikasi membuat otomatisasi sebenarnya yang dihubungkan ke struktur yang dipilih.
  5. Otomatisasi kini tersedia di struktur pengguna dan dapat dijalankan atau dihapus menggunakan metode Structure API.

Pengguna dapat membuat instance otomatisasi baru kapan saja, memilih struktur yang berbeda atau, bergantung pada logika aplikasi, mungkin kumpulan perangkat yang berbeda. Setiap kali melakukannya, aplikasi akan membuat instance otomatisasi baru.

Dalam skenario paling dasar, Anda dapat menyarankan kepada pengguna otomatisasi yang telah ditentukan sebelumnya yang melakukan tugas yang relatif mendasar. Atau, Anda dapat menampilkan kerangka otomatisasi yang disesuaikan pengguna untuk memenuhi kebutuhan mereka. Atau, Anda dapat menulis editor otomatisasi terbuka yang memungkinkan pengguna membuat otomatisasi kompleks menggunakan semua elemen penyusun yang tersedia di Automation API.

Batas Resource

Batas berikut berlaku untuk otomatisasi di Home API:

Tabel: Batas resource Automation API
Metrik Batas
Jumlah maksimum otomatisasi per struktur 64
Jumlah node maksimum 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