Google Home Plugin for Android Studio dirancang dan dibuat untuk Google Developer Home Platform. Plugin ini memberi Anda akses ke Google Assistant Simulator, Cloud Logging, dan alat lainnya untuk menyederhanakan proses pengembangan smart home.
Pemberitahuan keamanan
Untuk mencegah Android Studio menyimpan secret dan {i>password<i}, selesaikan langkah-langkah berikut:
- Klik File, lalu Settings....
- Di Tampilan & Behavior, luaskan System Settings, lalu klik Sandi.
- Pilih Jangan simpan, lupakan sandi setelah mulai ulang.
Fitur
Simulator Asisten
Untuk menguji apakah perangkat smart home Anda berfungsi dengan baik dengan Google Home ekosistem, Anda dapat berinteraksi dengan Assistant Simulator kapan saja tanpa meninggalkan Android Studio.
Mirip dengan Asisten yang sudah ada Simulator disediakan di Konsol Actions on Google Console, Assistant Simulator memungkinkan Anda untuk mengontrol perangkat dengan mudah dengan mengetikkan kueri, misalnya, "Nyalakan lampu". Di dalam Android Studio, Assistant Simulator akan membalas dengan pesan teks berdasarkan perintah, misalnya, "Oke, menyalakan lampu".
Lihat Cloud Logging
Google Cloud Logging memberikan informasi proses debug dan metrik utama untuk memberikan analisis tentang Penggunaan Action. 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.
Ucapan Batch
Assistant Simulator respons terhadap satu ucapan tidak determenistik. Misalnya, respons dapat berupa salah satu frasa berikut:
- Oke, nyalakan 2 lampu.
- Oke, menyalakan 2 lampu.
- Oke, nyalakan 2 lampu.
- Oke, menyalakan 2 lampu.
Untuk menjalankan pengujian otomatis dan memverifikasi cara kerja integrasi Google Anda dengan ke berbagai respons ini, Anda bisa mengirimkan kumpulan ucapan ke Assistant Simulator dengan menjalankan skrip ucapan. Setelah skrip disimpan, Anda dapat mengumpulkan respons dan menjalankan beberapa pengujian terhadap kueri.
Penampil Home Graph
Penampil Grafik Beranda memungkinkan Anda menampilkan status perangkat Anda dan meluncurkan Google Home Test Suite di browser Anda.
Penampil Log Android Debug Bridge (adb)
{i>Adb Log Viewer<i} adalah alat untuk melihat dan menganalisis file log, misalnya Matter file log perangkat, log Google Home, dan Android log.
Instal
Untuk menginstal Google Home Plugin di Android Studio, ikuti langkah-langkah berikut:
- Download atau update Android Studio. Mendownload Android Studio
- Buka File > Setelan (Android Studio > Preferences di MacOS).
- Di bagian Plugin, buka Marketplace dan telusuri
google home. - Instal alat dan mulai ulang Android Studio.
Anda juga dapat mengunduh plugin langsung dari JetBrains Marketplace.
Penyiapan
Setelah menginstal plugin, Anda harus selesaikan langkah-langkah berikut sebelum Anda dapat menggunakan Assistant Simulator dan lihat Cloud Logging:
Login dengan Google
Anda bisa login ke akun developer dari panel Google Home, memberikan otorisasi kepada Android Studio untuk berkomunikasi dengan Google layanan tambahan atas nama Anda.
Klik tab Google Home di kolom tab vertikal di sebelah kiri sisi jendela Android Studio.
Untuk Login dengan, klik Google untuk meluncurkan browser.
Pilih akun yang ditautkan dengan 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 menu dropdown. Untuk memfilter
daftar project, ketik ekspresi Filter, misalnya matter, lalu tekan
Enter.
Dropdown Project memuat 100 project pertama berdasarkan Filter. Pilihan Anda disimpan saat Anda keluar Android Studio.
Untuk mendapatkan bantuan terkait filter project, lihat Parameter kueri dalam Referensi Google Cloud.
Gunakan 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. Berikutnya kita akan membahas setiap opsi.
Ketik kueri dan kumpulkan respons
Untuk berinteraksi dengan Assistant Simulator, ketik kueri Anda, lalu tekan Enter.
Anda dapat mengirim ulang kueri dengan mengklik Ikon kirim ulang di akhir kueri Anda.
Setelah mengirimkan satu atau beberapa kueri, klik Putar ulang untuk menjalankan ulang kueri dan memeriksa respons Anda. Panel Utterances melacak kueri dan respons dalam cache yang disimpan. Replay hanya menambahkan respons baru ke {i>cache<i} internal ini, dan tidak akan menduplikasi kueri Anda setiap kali Anda mengeklik tombol.
Klik Simpan untuk menyimpan kueri dan respons yang dimasukkan dalam Panel Utterances. Interaksi Anda dikonversi ke JSON di berikut ini format:
ask: Kueri Anda.answers: Array 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."
]
}
]
}
Kumpulkan respons massal
Dari panel Google Home Plugin, klik Utterances File untuk membuka
file JSON yang Anda simpan di tab baru. Untuk Select Path, Anda dapat memilih
file atau folder. Jika Anda memilih folder, Kumpulkan dan Uji akan
mengerjakan semua ucapan .json dalam folder tersebut.
Anda dapat membuka beberapa tab untuk file yang sama atau file yang berbeda, misalnya
lights, lights(1), dan plug.
Panel Status menampilkan hasil pengujian terakhir (jika ada),
titik kuning atau hijau untuk menunjukkan
apakah file telah dikumpulkan, dan
jalur file ucapan .json. Setelah Anda mengklik
Kumpulkan,
Assistant Simulator akan menjalankan kueri Anda.
Anda akan diberi tahu saat respons baru dikumpulkan, dan Bar Status
menampilkan penghitung saat kueri Anda sedang diproses.
Setelah Kumpulkan selesai, Bar Status akan diperbarui dengan tanda centang hijau
di depan jalur .json, dan file ucapan Anda diisi dengan
kemungkinan responsnya.
{
"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 Anda tidak akan ditandai sebagai
kumpulkan.
Menguji ucapan batch
Setelah mengumpulkan respons, klik Uji untuk memutar ulang kueri Anda serta memeriksa respons dan log Anda. Saat Anda menguji ucapan batch, Assistant Simulator mengharapkan respons yang disimpan ke JSON Anda . Jika pengujian menampilkan respons yang belum dikumpulkan, Anda akan menerima notifikasi yang serupa 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 Anda dan menampilkan respons. Pemeriksaan ditampilkan di Panel Status 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 proyek.
Persyaratan kueri
Untuk project yang dipilih, Anda juga dapat memfilter log menggunakan kolom Kueri.
Misalnya, untuk memfilter log untuk kata kunci light:
Pilih Gunakan QL untuk digunakan 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 menurut tanggal juga bersifat opsional, dan dapat diaktifkan dengan mengklik
Setelah dan Sebelum. Anda dapat mengetik format tanggal dan waktu di teks
disediakan, misalnya 5/11/22, 12:37 PM, atau Anda dapat menggunakan pemilih tanggal
untuk memilih tanggal, lalu masukkan 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 tanggal ikon . - Untuk memilih tanggal antara
5/1/22dan6/30/22, pilih Sebelum dan Setelah dan 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 Keparahan Minimal dari menu dropdown.
Hasil kueri
Klik Ambil untuk mengirim parameter kueri Anda.
Setelah log dimuat, klik data mana pun untuk meluaskan payload JSON. Klik lagi untuk menampilkan pesan lengkap.
Atau, Anda dapat mengetik kata kunci di kotak Filter untuk mempersempit log Anda
hasil pengujian tersebut. Klik x untuk menghapus filter dan kembali ke aslinya
mengambil hasil.
Melihat Home Graph dan Menjalankan Pengujian
Untuk menampilkan daftar perangkat Anda, pilih Home Graph dari Panel Google Home Plugin.
Klik Muat ulang untuk menampilkan Nama perangkat, ID perangkat, dan Jenis perangkat untuk perangkat Anda yang terkait dengan proyek yang dipilih. Anda dapat memiliki beberapa Google Home Graph panel terbuka untuk project terpisah.
Setelah perangkat dimuat, klik data mana pun untuk meluaskan payload JSON.
Anda juga dapat menggunakan Luaskan dan Ciutkan untuk menampilkan dan menyembunyikan JSON payload untuk perangkat Anda.
Untuk meluncurkan Test Suite pada perangkat tertentu, klik Uji. Tindakan ini akan meluncurkan Test Suite di browser dengan perangkat dipilih dan siap diuji. Klik Start dan tunggu pengujian hasil pengujian tersebut.
Anda dapat memeriksa detail pengujian dan melihat log setelah pengujian selesai.
Penampil 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 Log Adb terpisah tab untuk setiap file log Anda. Untuk menghapus tab, klik Ikon .
Gunakan kolom Select untuk memilih komponen logging tertentu yang akan ditampilkan dan Severity untuk hanya menampilkan entri dengan tingkat keparahan log yang cocok.
Untuk log adb yang dipilih, Anda dapat memfilter entri log menggunakan Filter kolom dengan pengubah Peka huruf besar/kecil atau Regex opsional.
Selain itu, Anda dapat:
- Temukan entri tertentu menggunakan kolom Temukan dan perintah Temukan Berikutnya (ikon ) dan Temukan Sebelumnya (ikon ).
- Gunakan pengubah Peka huruf besar/kecil atau Regex opsional.
- Lompat ke baris untuk melompat ke baris tertentu (menurut 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 Referensi untuk melihat daftar alat dan referensi developer.
Untuk mengirimkan pendapat atau masukan Anda agar kami dapat meningkatkan kualitas pengembangan ini dengan Google Home Plugin, klik Feedback.
