Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator , Cloud Logging, and other tools to simplify your smart home development process.
Pemberitahuan keamanan
Untuk mencegah Android Studio menyimpan rahasia dan sandi, selesaikan langkah-langkah berikut:
- Klik File, lalu Settings....
- Di bagian Tampilan & Perilaku, luaskan Setelan Sistem, lalu klik Sandi.
- Pilih Jangan simpan, lupakan sandi setelah dimulai 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 Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light."
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 akan menampilkan pesan Cloud Logging real-time di samping kode Anda selama pemecahan masalah.
Anda dapat menampilkan log real-time atau memilih rentang tanggal.
Ucapan Massal
Respons Assistant Simulator untuk satu ucapan tidak bersifat 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.
Penampil Grafik Rumah
Home Graph Viewer memungkinkan Anda menampilkan status perangkat dan meluncurkan Google Home Test Suite di browser.
Menginstal
Untuk menginstal Google Home Plugin di Android Studio, ikuti langkah-langkah berikut:
- Download atau update Android Studio. Download Android Studio
- Buka File > Setelan ( Android Studio > Preferensi di MacOS).
- Di bagian Plugin, buka Marketplace lalu telusuri
google home. - Instal alat dan mulai ulang Android Studio.
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 Anda dari panel Google Home, yang memberi otorisasi 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 untuk meluncurkan browser.
Pilih akun yang terhubung dengan perangkat smart home Anda.
Di halaman otorisasi Login dengan Google, klik Izinkan.
Tutup jendela browser, lalu kembali ke Android Studio.
Sekarang Anda dapat login, dengan opsi untuk Logout.
Pilih project Cloud
Setelah login, pilih Project dari menu 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 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 mengirim kueri ke Assistant Simulator. Selanjutnya, kita akan membahas setiap opsi.
Ketik kueri dan kumpulkan respons
Untuk berinteraksi dengan Assistant Simulator, ketik kueri, lalu tekan Enter.
Anda dapat mengirim ulang kueri dengan mengklik ikon kirim ulang di akhir kueri.
Setelah mengirimkan satu atau beberapa kueri, klik Putar ulang untuk menjalankan kembali kueri dan periksa respons Anda. Panel Utterances melacak kueri dan respons Anda dalam cache yang disimpan. Replay hanya menambahkan respons baru ke cache internal ini, dan tidak akan menduplikasi kueri Anda setiap kali Anda mengklik tombol.
Klik Save untuk menyimpan kueri dan respons yang Anda masukkan di panel Utterances. Interaksi Anda dikonversi ke JSON dalam format berikut:
ask: Kueri Anda.answers: Array kemungkinan Assistant Simulator respons.
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."
]
}
]
}
Kumpulkan respons batch
Dari panel
Google Home Plugin, klik Utterances File untuk membuka file JSON tersimpan di tab baru. Untuk Select Path, Anda dapat memilih file atau folder. Jika Anda memilih folder, Collect 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 (jika berlaku),
titik kuning atau hijau untuk menunjukkan apakah file telah dikumpulkan, dan
jalur file .json ucapan.
ah Anda 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, Status Bar 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 lebih awal, jalur .json tidak akan ditandai sebagai dikumpulkan.
Menguji ucapan batch
Setelah mengumpulkan respons, klik Test untuk memutar ulang kueri dan memeriksa respons serta log Anda. Saat Anda menguji ucapan batch, Assistant Simulator mengharapkan respons yang disimpan ke file JSON Anda. Jika pengujian menampilkan respons yang belum dikumpulkan, Anda akan menerima notifikasi yang mirip dengan respons berikut:
Expected one of: "Got it, turning on
2 lights."
Skenario ini menunjukkan pengujian yang gagal. Jika tidak, Assistant Simulator akan menjalankan setiap kueri 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.
Persyaratan kueri
Untuk project yang dipilih, Anda juga dapat memfilter log menggunakan kolom Query.
Misalnya, untuk memfilter log kata kunci light:
Pilih Use 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
Setelah dan Sebelum. Anda dapat mengetik format tanggal dan waktu di kolom
teks yang disediakan, misalnya 5/11/22, 12:37 PM, atau 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 Sebelum, lalu klik ikon tanggal . - Untuk memilih tanggal antara
5/1/22dan6/30/22, pilih Sebelum dan Setelah, lalu pilih tanggal dari ikon tanggal .
Pilih Real-Time untuk mengambil log project live. Klik Stop untuk mengakhiri feed real-time.
Tingkat keseriusan
Anda juga dapat memilih Tingkat Keseriusan Minimal dari menu dropdown.
Hasil kueri
Klik Fetch untuk mengirimkan parameter kueri Anda.
Setelah log dimuat, klik data untuk memperluas payload JSON lengkap. Klik lagi untuk menampilkan pesan lengkap.
Secara opsional, Anda dapat mengetik kata kunci di kotak Filter untuk mempersempit hasil log. Klik x untuk menghapus filter dan kembali ke hasil pengambilan awal.
Melihat Grafik di Rumah dan Menjalankan Pengujian
Untuk mencantumkan perangkat Anda, pilih Home Graph dari panel Google Home Plugin.
Klik Refresh untuk menampilkan Nama perangkat, ID Perangkat, dan Jenis perangkat untuk perangkat Anda yang terkait dengan project yang dipilih. Anda dapat memiliki beberapa Google Home Graph panels open for separate projects.
Setelah perangkat dimuat, klik data untuk memperluas payload JSON lengkap.
Anda juga dapat menggunakan Expand dan Ciutkan untuk menampilkan dan menyembunyikan payload JSON untuk perangkat Anda.
Untuk meluncurkan Test Suite untuk perangkat tertentu, klik Test. Tindakan ini akan meluncurkan Test Suite di browser dengan perangkat yang dipilih dan siap diuji. Klik Start dan tunggu hasil pengujiannya.
Anda dapat memeriksa detail pengujian dan melihat log setelah pengujian selesai.
Referensi dan masukan
Klik Referensi untuk melihat daftar alat dan referensi developer.
Untuk menyampaikan pendapat atau masukan Anda tentang cara meningkatkan pengalaman pengembangan dengan Google Home Plugin, klik Masukan.
