1. Pengantar
Yang akan Anda pelajari
- Cara mendesain dan menulis template otomatisasi.
- Cara menguji template otomatisasi menggunakan Konsol Play Google Home.
Yang Anda butuhkan
- Ponsel Android atau iOS yang menjalankan aplikasi Google Home.
- Lampu smart yang terpasang di rumah Anda, atau perangkat simulasi di Google Home Playground.
Prasyarat
Anda seharusnya sudah memahami cara menulis otomatisasi Google Home. Jika Anda belum pernah menulis otomatisasi, pertimbangkan untuk melakukan codelab Membuat otomatisasi dengan skrip sebelum melanjutkan dengan yang ini.
2. Template dan instance otomatisasi
Developer membuat template otomatisasi menggunakan editor template otomatisasi di Konsol Google Home. Template otomatisasi berisi esensi logika skrip, merujuk pada jenis perangkat, tetapi bukan perangkat tertentu.
Dengan menggunakan editor skrip otomatisasi Google Home untuk web, pengguna akhir mengambil template otomatisasi dan membuat instance yang dipersonalisasi yang berfungsi di perangkat tertentu di rumah mereka sendiri. Setelah disimpan, instance akan muncul di bagian Rutinitas Anggota Keluarga di aplikasi Google Home (GHA).
3. Merencanakan template otomatisasi
Saat membuat otomatisasi, seseorang memulainya dengan memikirkan masalah yang coba dipecahkan, dan apa yang akan dilakukan otomatisasi untuk menyelesaikan masalah tersebut. Pertimbangan ini mencakup:
- Perangkat yang ingin Anda otomatiskan.
- Pemicu (atau peristiwa) yang akan memicu eksekusi otomatisasi.
- Kondisi tambahan apa, jika ada, mengontrol apakah otomatisasi berjalan atau tidak setelah dipicu.
- Tindakan yang akan dilakukan.
Untuk tujuan codelab ini, otomatisasi Anda akan melakukan dua hal:
- Menyalakan lampu pada waktu tertentu.
- Matikan lampu yang sama pada waktu tertentu.
Dengan mengingat hal ini, Anda siap untuk membuka editor template dan menulis otomatisasi.
4. Menulis template otomatisasi
Otomatisasi ditulis secara deklaratif menggunakan bahasa serialisasi data YAML.
Template otomatisasi memiliki tiga bagian utama:
- Metadata - Nama otomatisasi, deskripsi tentang fungsinya, dan secara opsional, beberapa tag yang digunakan untuk mengklasifikasikan otomatisasi. Kata kuncinya adalah:
- Pencahayaan DAN Konektor
- IKLIM DAN ENERGI
- KEAMANAN DAN KESADARAN
- HIBURAN
- PERALATAN DAN LAINNYA
- Input - Menentukan jenis perangkat yang ingin dikontrol otomatisasi. Mesin otomatisasi menggunakan informasi ini untuk mengetahui jenis tindakan yang valid untuk perangkat yang dimaksud.
- Aturan otomatisasi — Menentukan logika inisiasi dan perilaku otomatisasi.
Ini adalah template otomatisasi yang akan Anda gunakan:
metadata:
name:
en: Scheduled light
description:
en: Turn the light on and off at specific times
tags:
- LIGHTING AND PLUGS
input:
the_light:
metadata:
name:
en: The light
description:
en: The light to be controlled
selector:
type: device
multiSelect: true
supportedTypes:
- LIGHT
time_on:
metadata:
name:
en: Time to turn on the light.
description:
en: The time of day to turn on the selected light.
selector:
type: time
default: sunset+30min
time_off:
metadata:
name:
en: Time to turn off the light.
description:
en: The time of day to turn off the selected light.
selector:
type: time
default: 10:00 pm
automations:
- name: Turn on the light
starters:
- type: time.schedule
at: $time_on
actions:
- type: device.command.OnOff
devices: $the_light
on: true
- name: Turn off the light
starters:
- type: time.schedule
at: $time_off
actions:
- type: device.command.OnOff
devices: $the_light
on: false
Baca template dan perhatikan hal-hal berikut:
- Bagian
metadata
berisi nama dan deskripsi otomatisasi ini. - Bagian
input
menentukan variabel bernamathe_light
yang menentukan perangkat jenisLIGHT
. Artinya, template ini hanya dapat digunakan untuk lampu, bukan untuk jenis perangkat lainnya. Dengan kata lain, saat pengguna, yang menyiapkan otomatisasi Anda di rumah, diminta memilih perangkat untuk$the_light
, pilihan perangkatnya dibatasi untuk perangkat dengan jenis yang Anda tentukan. - Selain itu, ditentukan di bagian
input
adalah dua variabel bernamatime_on
dantime_off
. Template ini memungkinkan pengguna menentukan kapan harus memulai otomatisasi.time_on
menunjukkan waktu saat lampu dinyalakan, dantime_off
menunjukkan waktu saat lampu dimatikan. Jika pengguna tidak menetapkan nilaitime_on
atautime_off
, nilai default akan digunakan. - Bagian
automations
dari otomatisasi berisi dua aturan otomatisasi. Setiap aturan memiliki satu pemicutime.schedule
yang memberi tahu otomatisasi jam berapa harus memulai otomatisasi tersebut.
Editor template
Editor template otomatisasi adalah alat yang Anda gunakan untuk menulis template otomatisasi.
- Buka Konsol Developer Google Home.
- Login dengan akun yang sama dengan yang digunakan untuk menyiapkan perangkat Anda di aplikasi Google Home.
- Buat atau pilih project yang sudah ada.
- Di bagian Automations, klik Develop.
- Klik Create a template.
- Salin "Cahaya terjadwal" template otomatisasi.
- Tempel "Lampu terjadwal" template otomatisasi ke editor template.
- Klik Validasi. Selesaikan error apa pun yang mungkin muncul dan terus validasi dan perbaiki sampai tidak ada error yang muncul.
- Klik Save untuk menyimpan template.
5. Menguji template
Sekarang Anda dapat menguji template di Console.
- Pastikan lampu dicolokkan dan terlihat di aplikasi Google Home.
- Jika lampu menyala, matikan.
- Buka Konsol Developer Google Home.
- Buka project tempat Anda membuat template.
- Pilih Otomatisasi, lalu pilih tab Pengujian.
- Klik Buka di samping "Lampu terjadwal" template otomatisasi.
- Pilih struktur tempat Anda ingin menguji template, lalu klik Next.
- Di editor InputValue, tentukan nama lampu Anda. Contohnya, jika lampu Anda bernama "Lampu meja - Kantor", pilih
Desk light - Office
dari menu drop-down yang muncul saat Anda mengklik di sebelah kananlights
. Atau Anda dapat mengetikkan nama perangkat. - Juga di editor InputValue, tentukan waktu
time_on
ke waktu, lima menit setelahnya, dan ubah waktutime_off
menjadi waktu tepat setelahtime_on
. - Setelah selesai, editor InputValue akan terlihat seperti ini:
inputValue: #add value the_light: Desk light - Office #add value time_off: 11:45 am #add value time_on: 11:40 am
- Klik Aktifkan pengujian.
- Tunggu hingga dua waktu pemicu selesai. Lampu akan menyala lalu mati pada waktu yang ditentukan.
Setelah berhasil menguji template, Anda akan tahu bahwa otomatisasi Anda berfungsi dengan baik.
6. Selamat!
Anda telah berhasil membuat template otomatisasi. Keren!
Dalam codelab ini, Anda telah mempelajari cara:
- Cara mendesain dan menulis template otomatisasi.
- Cara mengujinya di Konsol Google Home.
Langkah berikutnya
Dalam codelab ini, Anda telah membuat otomatisasi yang sangat sederhana. Otomatisasi dapat melakukan lebih banyak hal dari sekadar menjadwalkan pengaktifan lampu. Setelah memahami dasar-dasar pembuatan dan pengujian template otomatisasi, Anda dapat mencoba membuat template otomatisasi untuk jenis perangkat lain, menggunakan pemicu, kondisi, dan tindakan yang berbeda.
Bacaan lebih lanjut
Untuk mempelajari otomatisasi Google Home lebih lanjut, baca dokumentasi referensi Otomatisasi: