Plugin Google Home untuk Android Studio

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

Notifikasi keamanan

Untuk mencegah Android Studio menyimpan rahasia dan sandi, selesaikan langkah-langkah berikut:

1. Klik File, lalu Settings....
2. Di Appearance & Behavior, luaskan System Settings, lalu klik Passwords.
3. Pilih Do not save, forget passwords after restart.

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.

Assistant Simulator memungkinkan Anda mengontrol perangkat dengan mudah dengan mengetik kueri, misalnya, "Turn on the light." Di dalam Android Studio, Assistant Simulator akan merespons kembali dengan pesan teks berdasarkan perintah Anda, misalnya, "Alright, turning on the light."

Melihat Cloud Logging

Google Cloud Logging menyediakan informasi proses debug dan metrik utama untuk memberi Anda insight 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 deterministik. Misalnya, respons dapat berupa salah satu frasa berikut:

• Got it, turning on 2 lights.
• Sure, turning on 2 lights.
• Got it, turning 2 lights on.
• Alright, turning 2 lights on.

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.

Home Graph Viewer

Home Graph Viewer memungkinkan Anda menampilkan status perangkat dan meluncurkan Google Home Test Suite di browser.

Android Debug Bridge (adb) Log Viewer

Adb Log Viewer 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:

1. Download atau update Android Studio. Download Android Studio
2. Buka File > Settings (Android Studio > Preferences di MacOS).
3. Di bagian Plugins , buka Marketplace , lalu telusuri google home.
4. Instal alat tersebut lalu 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
• Pilih project cloud

Login dengan Google

Anda dapat login ke akun developer dari panel Google Home, yang mengotorisasi Android Studio untuk berkomunikasi dengan layanan Google atas nama Anda.

1. Klik tab Google Home di kolom tab vertikal di sisi kiri jendela Android Studio.

2. Untuk Sign in with, klik Google untuk meluncurkan browser.

   

3. Pilih akun yang ditautkan dengan perangkat smart home Anda.

4. Di halaman otorisasi Sign in with Google, klik Allow.

5. Tutup jendela browser, lalu kembali ke Android Studio.

Sekarang Anda seharusnya sudah login, dengan opsi untuk Sign Out.

Memilih project Cloud

Setelah login, pilih Project dari menu dropdown. Untuk memfilter daftar project, ketik ekspresi Filter, misalnya matter, lalu tekan Enter.

Menu 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.

Mengetik kueri dan mengumpulkan respons

Untuk berinteraksi dengan Assistant Simulator, ketik kueri Anda dan tekan Enter.

Anda dapat mengirim ulang kueri dengan mengklik ikon kirim ulang cached di akhir kueri.

Setelah mengirim satu atau beberapa kueri, klik cached Replay untuk menjalankan kembali kueri dan memeriksa 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 Save untuk menyimpan kueri dan respons yang telah Anda masukkan di panel Utterances. Interaksi Anda akan dikonversi ke JSON dalam format berikut:

• ask: Kueri Anda.
• answers: Array respons yang mungkin.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 disimpan di tab baru. Untuk Select Path, Anda dapat memilih file atau folder. Jika Anda memilih folder, Collect dan Test akan berfungsi pada semua file ucapan .json di 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 Anda mengklik tocCollect, the Assistant Simulator menjalankan kueri Anda. Anda akan menerima notifikasi saat respons baru dikumpulkan, dan Status Bar akan menampilkan penghitung saat kueri Anda sedang diproses.

Saat Collect 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 Stop pengumpulan lebih awal, jalur .json Anda tidak akan ditandai sebagai dikumpulkan.

Menguji ucapan batch

Setelah mengumpulkan respons, klik switch_left Test untuk memutar ulang kueri dan memeriksa respons serta log Anda. Saat Anda menguji ucapan batch, Assistant Simulator akan mengharapkan respons yang disimpan ke file JSON Anda. Jika pengujian menampilkan respons yang belum dikumpulkan, Anda akan menerima notifikasi yang mirip dengan respons berikut:

error Expected one of: "Got it, turning on 2 lights."

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

Melihat Cloud Logging

Untuk membuka tab project di jendela alat Log Cloud, klik Log Cloud dari panel Google Home Plugin. Anda dapat membuka tab Log Cloud 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 Use QL untuk menggunakan bahasa kueri Logging.

Berikut 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 mengetik format tanggal dan waktu di kolom teks yang disediakan, misalnya 5/11/22, 12:37 PM, atau Anda dapat menggunakan pemilih tanggal calendar_month untuk memilih tanggal, lalu memasukkan waktu di kolom teks.

• Untuk memilih tanggal setelah 5/1/22, pilih After dan klik ikon tanggal calendar_month.
• Untuk memilih tanggal sebelum 5/1/22, pilih Before dan klik ikon tanggal calendar_month.
• Untuk memilih tanggal antara 5/1/22 dan 6/30/22, pilih Before dan After , lalu pilih tanggal dari ikon tanggal calendar_month.

Pilih Real time untuk mengambil log project live. Klik Stop untuk mengakhiri feed real-time.

Tingkat keparahan

Anda juga dapat memilih Minimal Severity dari menu dropdown.

Hasil kueri

Klik cached Fetch untuk mengirim parameter kueri.

Setelah log dimuat, klik catatan mana pun chevron_right untuk meluaskan payload JSON lengkap. Klik lagi chevron_left 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 asli.

Melihat Home Graph dan Menjalankan Pengujian

Untuk mencantumkan perangkat, pilih Home Graph dari Google Home Plugin panel.

Klik cached Refresh yang di-cache untuk menampilkan Device name, Device id, dan Device type untuk perangkat yang terkait dengan project yang dipilih. Anda dapat membuka beberapa Google Home Graph panel untuk project terpisah.

Setelah perangkat dimuat, klik catatan mana pun chevron_right untuk meluaskan payload JSON lengkap.

Anda juga dapat menggunakan Expand dan Collapse untuk menampilkan dan menyembunyikan payload JSON untuk perangkat.

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

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

Android Debug Bridge (adb) Log Viewer

Untuk membuka tab project di jendela alat Log Adb, klik perintah Adb Log di toolbar plugin Google Home (di sebelah kiri). Anda dapat membuka tab Log Adb terpisah untuk setiap file log. Untuk menghapus tab, klik ikon clear tersebut.

Gunakan kolom Select untuk memilih komponen logging tertentu yang akan dilihat dan menu dropdown 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 Case-sensitive atau Regex opsional.

Selain itu, Anda dapat:

• Menemukan entri tertentu menggunakan kolom Find dan perintah Find Next (ikon arrow_downward) dan Find Previous (ikon arrow_upward).
• Menggunakan pengubah Case-sensitive atau Regex opsional.
• Jump to line untuk melompat ke baris tertentu (berdasarkan nomor) dalam log.

Pilih Numbered untuk melihat baris log dengan nomor baris yang ditambahkan. Pilih Raw untuk melihat entri log mentah.

Referensi dan masukan

Klik Resources untuk melihat daftar alat dan referensi developer.

Untuk mengirimkan pendapat atau masukan tentang cara kami dapat meningkatkan pengalaman pengembangan dengan Google Home Plugin, klik Feedback.