Mendesain otomatisasi di Android

Sebelum Anda mulai menggunakan API Otomatisasi, Anda harus merancang otomatisasi Anda.

Tentukan parameter berikut untuk setiap otomatisasi:

• Keadaan 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. Pemula dibahas dalam Komponen otomatisasi di Android.
• Kondisi tambahan yang menentukan apakah otomatisasi harus benar-benar berjalan, dan tindakan mana yang harus dilakukan.
• Alur eksekusi untuk otomatisasi. Haruskah dijalankan secara berurutan atau paralel? Apakah Anda memerlukan beberapa jalur logika?

Saat mendesain, mungkin berguna untuk membuat diagram aliran otomatisasi, simpul demi simpul, dengan logika yang diperlukan pada setiap langkah.

Setelah Anda merancang otomatisasi, gunakan Automation DSL untuk membangunnya. 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

Katakanlah Anda perlu menulis aplikasi yang menciptakan otomatisasi yang menaikkan tirai pada pukul 8:00 pagi. Untuk mencapai hal ini, aplikasi memerlukan daftar blind (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 bangunan 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 suatu alamat ditetapkan ke struktur atau tidak.

Jadi alur eksekusinya akan tampak seperti ini:

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

Otomatisasi yang kompleks

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

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

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. Menyediakan cara untuk memilih lampu yang berkedip, mungkin melalui panel Pengaturan khusus.
3. Tentukan otomatisasi:
   1. Mulai otomatisasi setiap kali seseorang pergi 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 dalam pembuatan otomatisasi terbuka, berdasarkan salah satu atau semua perangkat yang mereka miliki di rumah.

Otomatisasi mungkin pertama-tama meminta pengguna untuk memilih suatu struktur.

Kemudian otomatisasi dapat menampilkan semua ruangan dalam struktur tersebut dalam tampilan garis besar yang dapat diperluas, di mana memperluas suatu ruangan akan memperlihatkan perangkat-perangkat yang ada di dalamnya. Memperluas perangkat lebih lanjut akan mencantumkan permulaan, dan perintah yang didukung oleh perangkat tersebut.

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

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

Pada tingkat tinggi, otomatisasi semacam itu perlu mengumpulkan beberapa set data tentang rumah pengguna menggunakan Structure API untuk Android, Device API untuk Android, dan Discovery API.

Tabel 1: API Beranda dan informasi yang dapat diberikannya

API	Informasi
Structure API	Struktur yang tersedia Ruangan apa saja yang ada di dalam bangunan tersebut?
Device API	Perangkat apa yang ada dalam struktur yang dipilih Lokasi perangkat tersebut (ruangan 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