Google Home Plugin for Android Studio dirancang dan dibuat untuk developer Platform Google Home. Plugin ini memberi Anda akses ke Google Assistant Simulator, Cloud Logging, dan alat lainnya untuk menyederhanakan proses pengembangan smart home Anda.

Notifikasi keamanan
Untuk mencegah Android Studio menyimpan rahasia dan sandi, selesaikan langkah-langkah berikut:
- Klik File, lalu Settings....
- Pada Appearance & Behavior, luaskan System Settings, lalu klik Passwords.
- Pilih Jangan simpan, lupakan sandi setelah memulai ulang.

Fitur
Simulator Asisten
Untuk menguji apakah perangkat smart home Anda berfungsi dengan baik dengan ekosistem Google Home, Anda dapat berinteraksi dengan Assistant Simulator kapan saja tanpa keluar dari Android Studio.
Serupa dengan Simulator Asisten yang ada di Konsol Actions on Google Console, Assistant Simulator memungkinkan Anda mengontrol perangkat secara mudah dengan mengetik kueri, misalnya, "Nyalakan lampu". Di dalam Android Studio, Assistant Simulator akan merespons kembali dengan pesan teks berdasarkan perintah Anda, misalnya, "Baiklah, nyalakan lampu".

Lihat Cloud Logging
Google Cloud Logging menyediakan informasi proses debug dan metrik utama untuk memberikan insight tentang penggunaan Action Anda. Untuk menyederhanakan pengembangan, Google Home Plugin menampilkan pesan Cloud Logging real-time tepat di samping kode Anda selama pemecahan masalah.
Anda dapat menampilkan log real-time atau memilih rentang tanggal.

Penggunaan Batch
Respons Assistant Simulator untuk satu ucapan tidak deterministik. Misalnya, respons dapat berupa salah satu frasa berikut:
- Oke, menyalakan 2 lampu.
- Oke, menyalakan 2 lampu.
- Oke, menyalakan 2 lampu.
- Oke, menyalakan 2 lampu.
Untuk menjalankan pengujian otomatis dan memverifikasi cara kerja integrasi Google dengan berbagai respons ini, Anda dapat mengirim ucapan batch ke Assistant Simulator dengan menjalankan skrip ucapan. Setelah skrip disimpan, Anda dapat mengumpulkan respons dan menjalankan beberapa pengujian terhadap kueri Anda.
Penampil Home Graph
Home Graph Viewer memungkinkan Anda menampilkan status perangkat dan meluncurkan Google Home Test Suite di browser.
Viewer Log Android Debug Bridge (adb)
Adb Log Viewer adalah alat untuk melihat dan menganalisis file log, misalnya file log perangkat Matter, log Google Home, dan log Android.
Menginstal
Untuk menginstal Google Home Plugin di Android Studio, ikuti langkah-langkah berikut:
- Download atau update Android Studio. Mendownload Android Studio
- Buka File > Settings (Android Studio > Preferences di MacOS).
- Di bagian Plugin, buka Marketplace dan telusuri
google home
. - Instal alat dan mulai ulang Android Studio.
Anda juga dapat mendownload plugin langsung dari JetBrains Marketplace.
Penyiapan
Setelah menginstal plugin, Anda harus menyelesaikan langkah-langkah berikut sebelum dapat menggunakan Assistant Simulator dan melihat Cloud Logging:
Login dengan Google
Anda dapat login ke akun developer dari panel Google Home, yang mengizinkan Android Studio untuk berkomunikasi dengan layanan Google atas nama Anda.
Klik tab Google Home di kolom tab vertikal di sisi kiri jendela Android Studio.
Untuk Sign in with, klik Google guna meluncurkan browser Anda.
Pilih akun yang ditautkan ke perangkat smart home Anda.
Di halaman otorisasi Sign in with Google, klik Allow.
Tutup jendela browser, dan kembali ke Android Studio.
Sekarang Anda seharusnya sudah login, dengan opsi Logout.
Pilih project Cloud
Setelah login, pilih Project dari dropdown. Untuk memfilter daftar project, ketik ekspresi Filter, misalnya matter
, lalu tekan Enter
.
Dropdown Project memuat 100 project pertama berdasarkan Filter Anda. Pilihan Anda akan dipertahankan saat Anda keluar dari Android Studio.

Untuk mendapatkan bantuan terkait filter project, lihat Parameter kueri di Referensi Google Cloud.
Menggunakan Simulator Asisten
Untuk membuka Assistant Simulator di Android Studio, klik Utterances Panel dari panel Google Home Plugin.

Ada beberapa cara untuk mengirimkan kueri ke Assistant Simulator. Selanjutnya, kita akan membahas setiap opsi.
Ketik kueri dan kumpulkan respons
Untuk berinteraksi dengan Assistant Simulator, ketik kueri Anda dan tekan Enter.
Anda dapat mengirim ulang kueri dengan mengklik ikon kirim ulang
di akhir kueri.Setelah mengirimkan satu atau beberapa kueri, klik
Replay untuk menjalankan kembali kueri dan memeriksa respons Anda. Panel Utterances melacak kueri dan respons Anda dalam cache yang tersimpan. Replay hanya menambahkan respons baru ke cache internal ini, dan tidak akan menduplikasi kueri setiap kali Anda mengklik tombol.
Klik
Save untuk menyimpan kueri dan respons yang telah Anda masukkan di panel Utterances. Interaksi Anda dikonversi ke JSON dalam format berikut:ask
: Kueri Anda.answers
: Array dari kemungkinan respons Assistant Simulator.
Anda dapat mengedit file JSON ini di Android Studio.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Mengumpulkan respons batch
Dari panel Google Home Plugin, klik Utterances File untuk membuka
file JSON yang tersimpan di tab baru. Untuk Select Path, Anda dapat memilih
file atau folder. Jika Anda memilih folder, Kumpulkan dan Uji akan
berfungsi pada semua file .json
ucapan dalam folder tersebut.
Anda dapat membuka beberapa tab untuk file yang sama atau file yang berbeda, misalnya
lights
, lights(1)
, dan plug
.
Status Bar menampilkan hasil pengujian terakhir Anda (jika ada),
titik kuning atau hijau untuk menunjukkan apakah file telah dikumpulkan, dan
jalur file ucapan .json
. Setelah mengklik
Kumpulkan,
Assistant Simulator akan menjalankan kueri Anda.
Anda akan diberi tahu saat respons baru dikumpulkan, dan Status Bar akan menampilkan penghitung saat kueri Anda sedang diproses.

Setelah Kumpulkan selesai, Panel Status akan diperbarui dengan tanda centang hijau di
depan jalur .json
, dan file ucapan Anda akan diisi dengan
kemungkinan respons.

{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
Jika Anda Menghentikan pengumpulan data lebih awal, jalur .json
Anda tidak akan ditandai sebagai
dikumpulkan.
Menguji ucapan batch
Setelah mengumpulkan respons, klik Assistant Simulator mengharapkan respons yang disimpan ke file JSON Anda. Jika pengujian menampilkan respons yang belum dikumpulkan, Anda akan menerima notifikasi yang serupa dengan respons berikut:
Test untuk memutar ulang kueri serta memeriksa respons dan log Anda. Saat Anda menguji ucapan batch,Expected one of: "Got it, turning on
2 lights."

Skenario ini menunjukkan pengujian yang gagal. Jika tidak, Assistant Simulator akan menjalankan setiap kueri Anda dan menampilkan respons. Pemeriksaan akan ditampilkan di Status Bar jika pengujian berhasil.

Lihat Cloud Logging
Untuk membuka tab project di jendela alat Cloud Logs, klik Cloud Logs dari panel Google Home Plugin. Anda dapat membuka tab Cloud Log terpisah untuk setiap project.

Istilah kueri
Untuk project yang dipilih, Anda juga dapat memfilter log menggunakan kolom Query.
Misalnya, untuk memfilter log untuk kata kunci light
:

Pilih Gunakan QL untuk menggunakan Bahasa kueri logging.

Berikut adalah beberapa contoh kueri QL untuk membantu Anda memulai:
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
Kueri tanggal dan waktu
Membuat kueri log berdasarkan tanggal juga bersifat opsional, dan dapat diaktifkan dengan mengklik After dan Before. Anda dapat mengetikkan format tanggal dan waktu di kolom teks
yang disediakan, misalnya 5/11/22, 12:37 PM
, atau Anda dapat menggunakan pemilih tanggal
untuk memilih tanggal, lalu memasukkan waktu di kolom teks.
- Untuk memilih tanggal setelah
5/1/22
, pilih Setelah, lalu klik ikon tanggal . - Untuk memilih tanggal sebelum
5/1/22
, pilih Before, lalu klik ikon tanggal . - Untuk memilih tanggal antara
5/1/22
dan6/30/22
, pilih Sebelum dan Sesudah lalu pilih tanggal dari ikon tanggal .
Pilih Real time untuk mengambil log project live. Klik Stop untuk mengakhiri feed real-time.
Tingkat keparahan
Anda juga dapat memilih Tingkat Keparahan Minimal dari menu dropdown.
Hasil kueri
Klik
Ambil untuk mengirimkan parameter kueri Anda.Setelah log dimuat, klik data mana pun
untuk meluaskan payload JSON lengkap. Klik lagi untuk menampilkan pesan lengkap.Anda juga dapat mengetik kata kunci di kotak Filter untuk mempersempit hasil log. Klik x
untuk menghapus filter dan kembali ke hasil pengambilan awal.

Melihat Home Graph dan Menjalankan Pengujian
Untuk menampilkan daftar perangkat, pilih Home Graph dari panel Google Home Plugin.
Klik Google Home Graph untuk project terpisah.
Refresh untuk menampilkan Device name, Device id, dan Device type untuk perangkat yang terkait dengan project yang dipilih. Anda dapat membuka beberapa panelSetelah perangkat dimuat, klik data mana pun
untuk meluaskan payload JSON lengkap.
Anda juga dapat menggunakan Luaskan dan Ciutkan untuk menampilkan dan menyembunyikan payload JSON untuk perangkat Anda.

Untuk meluncurkan Test Suite bagi perangkat tertentu, klik Test. Tindakan ini akan meluncurkan Test Suite di browser dengan memilih perangkat dan siap diuji. Klik Start dan tunggu hasil pengujian.

Anda dapat memeriksa detail pengujian dan melihat log setelah pengujian selesai.

Viewer Log Android Debug Bridge (adb)
Untuk membuka tab project di jendela alat Adb Log, klik perintah Adb Log di toolbar plugin Google Home (di sebelah kiri). Anda dapat membuka tab {i> Adb Log<i} terpisah untuk setiap file log. Untuk menghapus tab, klik ikon
.Gunakan kolom Select untuk memilih komponen logging tertentu yang akan dilihat, dan drop-down Severity untuk hanya menampilkan entri dengan tingkat keparahan log yang cocok.
Untuk log adb yang dipilih, Anda dapat memfilter entri log menggunakan kolom Filter dengan pengubah Peka huruf besar/kecil atau Regex opsional.
Selain itu, Anda dapat:
- Menemukan entri tertentu menggunakan kolom Find dan perintah Find Next (ikon ) serta perintah Find Sebelumnya (ikon ).
- Gunakan pengubah Peka huruf besar/kecil atau Ekspresi reguler.
- Lompat ke baris untuk melompat ke baris tertentu (berdasarkan angka) dalam log.
Pilih Bernomor untuk melihat baris log dengan nomor baris yang ditambahkan. Pilih Raw untuk melihat entri log mentah.

Referensi dan masukan
Klik Aset untuk melihat daftar alat dan sumber daya developer.
Untuk mengirimkan pendapat atau masukan Anda tentang cara meningkatkan pengalaman pengembangan dengan Google Home Plugin, klik Masukan.
