Mendesain otomatisasi di Android

Sebelum mulai menggunakan Automation API, Anda harus mendesain otomatisasi.

Tentukan parameter berikut untuk setiap otomatisasi:

• Keadaan yang membuat otomatisasi harus disarankan kepada pengguna. Misalnya, jika pengguna baru saja menambahkan tiga lampu baru ke rumahnya, dia mungkin tertarik dengan otomatisasi tertentu yang disesuaikan untuk mengontrol lampu.
• Jenis perangkat yang diperlukan untuk otomatisasi. Misalnya, jika pengguna baru saja menambahkan tiga lampu baru ke rumahnya, dia mungkin tertarik dengan otomatisasi tertentu yang disesuaikan untuk mengontrol lampu. Contoh jenis perangkat lampu mencakup OnOffLightDevice, ColorTemperatureLightDevice, DimmableLightDevice, atau ExtendedColorLightDevice.
• Atribut dan perintah ciri mana yang diperlukan untuk otomatisasi, dan apakah atribut dan perintah tersebut didukung oleh Automation API di Android.
• Karakteristik yang akan mengaktifkan otomatisasi sebagai pemicu. Pemicu dibahas dalam Komponen otomatisasi di Android.
• Kondisi tambahan yang menentukan apakah otomatisasi harus benar-benar dijalankan, dan tindakan mana yang harus dilakukan.
• Alur eksekusi untuk otomatisasi. Apakah sebaiknya dijalankan secara berurutan atau paralel? Apakah Anda memerlukan beberapa jalur logika?

Saat mendesain, sebaiknya buat diagram alur otomatisasi, node demi node, dengan logika yang diperlukan di setiap langkah.

Setelah Anda mendesain otomatisasi, gunakan DSL Otomatisasi untuk membuatnya. Otomatisasi yang Anda buat pada dasarnya adalah "template" — struktur dan perangkat apa pun di dalamnya adalah placeholder dan diisi dengan struktur dan perangkat spesifik setiap pengguna saat mereka "mengadopsi" otomatisasi untuk penggunaan mereka sendiri.

Berikut adalah berbagai jenis otomatisasi yang dapat dibuat aplikasi menggunakan Home API. Lihat halaman Membuat otomatisasi untuk mengetahui kutipan kode yang berkaitan dengan contoh ini.

Otomatisasi sederhana

Misalnya, Anda perlu menulis aplikasi yang membuat otomatisasi yang menaikkan tirai pada pukul 08.00. Untuk melakukannya, aplikasi memerlukan daftar tirai (perangkat dengan jenis perangkat WindowCoveringDevice) yang ada dalam struktur yang mendukung otomatisasi, yang dapat disediakan oleh Discovery API.

Untuk otomatisasi yang perlu dijalankan pada waktu tertentu, Anda juga perlu memastikan bahwa pengguna telah menetapkan alamat jalan untuk struktur yang dipilih (baik selama pembuatan struktur atau di Google Home app (GHA)), jika tidak, otomatisasi tidak akan mengetahui zona waktu tempat otomatisasi akan dijalankan. Discovery API dapat membantu Anda menentukan apakah alamat ditetapkan ke struktur atau tidak.

Jadi, alur eksekusinya akan terlihat seperti ini:

1. Dengan Discovery API, kumpulkan daftar perangkat WindowCoveringDevice.
2. Jika alamat tidak diisi, beri tahu pengguna bahwa mereka harus memberikan alamat (misalnya, di GHA), dan hentikan eksekusi.
3. Jika tidak, tentukan otomatisasi:
   1. Mulai otomatisasi pada pukul 08.00.
   2. Untuk setiap tirai, panggil perintah upOrOpen pada karakteristik WindowCovering.

Otomatisasi kompleks

Bayangkan sebuah aplikasi yang membuat otomatisasi yang memicu lampu berkedip saat gerakan terdeteksi.

Salah satu tugas pertama dalam menerapkan aplikasi ini adalah mencari tahu lampu apa yang tersedia di rumah pengguna menggunakan Discovery API. Dengan informasi ini, aplikasi Anda kini dapat menampilkan lampu yang tersedia dan mungkin memungkinkan pengguna memilih lampu mana yang ingin mereka kedipkan.

Alur eksekusi:

1. Dengan Discovery API, kumpulkan daftar perangkat lampu yang ada dalam struktur, yang dapat berupa perangkat apa pun dengan jenis perangkat OnOffLightDevice, ColorTemperatureLightDevice, DimmableLightDevice, atau ExtendedColorLightDevice.
2. Menyediakan cara untuk memilih lampu yang berkedip, mungkin melalui panel Setelan kustom.
3. Tentukan otomatisasi:
   1. Mulai otomatisasi setiap kali seseorang meninggalkan atau tiba di lokasi, dengan memantau AreaPresenceState.
   2. Jika presenceState menunjukkan bahwa struktur ditempati, kedipkan lampu yang dipilih.

Otomatisasi umum

Untuk contoh otomatisasi yang lebih canggih, pertimbangkan otomatisasi yang memandu pengguna membuat otomatisasi terbuka, berdasarkan salah satu atau semua perangkat yang mereka miliki di rumah.

Otomatisasi mungkin akan meminta pengguna untuk memilih struktur terlebih dahulu.

Kemudian, otomatisasi dapat menampilkan semua ruangan dalam struktur dalam tampilan struktur yang dapat diperluas, dengan memperluas ruangan akan menampilkan perangkat di dalamnya. Memperluas perangkat lebih lanjut akan mencantumkan pemicu dan perintah yang didukung oleh perangkat tersebut.

Pengguna dapat memilih perangkat, pemicu, dan perintah yang ingin digunakan, dan otomatisasi akan memandu pengguna dalam menyusun otomatisasi.

Setelah semua pilihan dan keputusan pengguna bersifat final, otomatisasi akan membuat otomatisasi dan menyimpannya ke struktur yang dipilih.

Secara umum, otomatisasi tersebut perlu mengumpulkan beberapa set data tentang rumah pengguna menggunakan Structure API untuk Android, Device API untuk Android, dan Discovery API.

Tabel 1: Home API dan informasi yang dapat diberikan

API	Informasi
Structure API	Struktur yang tersedia Ruangan apa saja yang ada dalam struktur
Device API	Perangkat apa yang ada dalam struktur yang dipilih Lokasi perangkat tersebut (ruangan mana)
Discovery API	Karakteristik yang didukung oleh perangkat Pemicu dan perintah yang tersedia di karakteristik tersebut Batasan apa yang ada pada parameter untuk perintah ini