Mendesain otomatisasi di Android

Sebelum mulai menggunakan Automation API, Anda harus mendesain otomatisasi.

Tentukan parameter berikut untuk setiap otomatisasi:

• Kondisi saat 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 mana 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 karakteristik mana yang diperlukan untuk otomatisasi, dan apakah didukung oleh Automation API di Android.
• Ciri yang harus mengaktifkan otomatisasi sebagai pemicu. Starter 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. Haruskah dijalankan secara berurutan atau paralel? Apakah Anda memerlukan beberapa jalur logika?

Saat mendesain, diagram alur otomatisasi, node demi node, dengan logika yang diperlukan di setiap langkah mungkin akan berguna.

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

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

Otomatisasi sederhana

Misalnya, Anda perlu menulis aplikasi yang membuat otomatisasi untuk 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 harus memastikan bahwa pengguna telah menetapkan alamat jalan untuk struktur yang dipilih 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 eksekusi akan terlihat seperti ini:

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

Otomatisasi yang kompleks

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

Salah satu tugas pertama dalam mengimplementasikan aplikasi ini adalah mencari tahu lampu apa saja 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 buat berkedip.

Alur eksekusi:

1. Dengan menggunakan Discovery API, kumpulkan daftar perangkat lampu yang ada di struktur, yang merupakan perangkat dengan jenis perangkat OnOffLightDevice, ColorTemperatureLightDevice, DimmableLightDevice, atau ExtendedColorLightDevice.
2. Sediakan 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 ada di rumahnya.

Otomatisasi mungkin terlebih dahulu meminta pengguna untuk memilih struktur.

Kemudian, otomatisasi dapat menampilkan semua ruangan dalam struktur dalam tampilan garis luar yang dapat diluaskan, dengan meluaskan ruangan akan menampilkan perangkat di dalamnya. Memperluas perangkat 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 merakit otomatisasi.

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

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

Tabel 1: Home API dan informasi yang dapat diberikannya

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