Perhatian! Program Pratinjau Developer yang baru akan segera diluncurkan. Daftar di sini dan jadilah salah satu developer pertama yang mencoba alat baru serta berikan masukan.

Plugin Google Home untuk Android Studio

Google Home Plugin for Android Studio dirancang 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.

Plugin Google Home untuk Android Studio

Pemberitahuan 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 Jangan simpan, lupakan sandi setelah mulai ulang.
Plugin Google Home untuk Android Studio

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 sudah ada yang disediakan di Konsol Actions on Google Console, Assistant Simulator memungkinkan Anda mengontrol perangkat dengan mudah dengan mengetik kueri, misalnya, "Nyalakan lampu". Di dalam Android Studio, Assistant Simulator merespons kembali dengan pesan teks berdasarkan perintah Anda, misalnya, "Baiklah, menyalakan lampu".

Menguji dengan Simulator Asisten

Lihat Cloud Logging

Google Cloud Logging memberikan 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 di samping kode Anda selama pemecahan masalah.

Anda dapat menampilkan log real-time atau memilih rentang tanggal.

Tampilan Cloud Logging

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

Penampil Grafik Rumah

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

Penampil 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:

  1. Download atau update Android Studio. Download Android Studio
  2. Buka File > Setelan (Android Studio > Preferensi di MacOS).
  3. Di bagian Plugin, buka Marketplace lalu telusuri google home.
  4. Instal alat dan mulai ulang Android Studio.

Anda juga dapat mendownload plugin langsung dari JetBrains Marketplace.

Penyiapan

Setelah menginstal plugin tersebut, Anda harus menyelesaikan langkah-langkah berikut agar 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 kepada 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 Login dengan, klik Google untuk meluncurkan browser.

    Login dengan Android Studio di Google
  3. Pilih akun yang ditautkan dengan perangkat smart home Anda.

  4. Di halaman otorisasi Login dengan Google, klik Izinkan.

  5. Tutup jendela browser dan kembali ke Android Studio.

Sekarang Anda akan 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.

Drop-down Project akan memuat 100 project pertama berdasarkan Filter Anda. Pilihan Anda akan dipertahankan saat Anda keluar Android Studio.

Pilih Project

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.

Buka Panel Utterances

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 Anda, 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 Anda dan memeriksa respons Anda. Panel Utterances melacak kueri dan respons Anda di cache yang disimpan. Replay hanya menambahkan respons baru ke cache internal ini, dan tidak akan menduplikasi kueri Anda setiap kali Anda mengklik tombol.

Putar Ulang Ucapan dengan Simulator Asisten

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."
      ]
    }
  ]
}

Mengumpulkan respons batch

Dari panel Google Home Plugin, klik Utterances File untuk membuka file JSON tersimpan Anda di tab baru. Untuk Select Path, Anda dapat memilih file atau folder. Jika Anda memilih folder, Collect dan Test akan berfungsi pada semua file .json ucapan dalam folder tersebut.

Anda dapat membuka beberapa tab untuk file yang sama, atau file lain misalnya lights, lights(1), dan plug.

Status Bar menampilkan hasil pengujian terakhir Anda (jika berlaku), titik kuning atau hijau untuk menunjukkan apakah file telah dikumpulkan, dan jalur file .json ucapan. Setelah Anda mengklik Collect, Assistant Simulator akan menjalankan kueri. Anda akan diberi tahu saat respons baru dikumpulkan, dan Status Bar akan menampilkan penghitung saat kueri Anda sedang diproses.

Kumpulkan Ucapan dengan Simulator Asisten

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

Kumpulkan Ucapan dengan Simulator Asisten
{
  "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 koleksi lebih awal, jalur .json tidak akan ditandai sebagai dikumpulkan.

Menguji ucapan batch

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

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

Menjalankan Utterance dengan Simulator Asisten

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.

Menjalankan Utterance dengan Simulator Asisten

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.

Tab Cloud Logging

Istilah kueri

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

Kueri Cloud Logging

Pilih Use QL untuk menggunakan Logging query language.

Bahasa Kueri Cloud 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

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 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/22 dan 6/30/22, pilih Sebelum dan Setelah, lalu pilih tanggal dari ikon tanggal .

Pilih Real-Time untuk mengambil log project yang aktif. Klik Stop untuk mengakhiri feed real-time.

Tingkat Keparahan

Anda juga dapat memilih Tingkat Keseriusan Minimal dari menu dropdown.

Hasil kueri

Klik Fetch untuk mengirimkan parameter kueri Anda.

Setelah log dimuat, klik data apa pun untuk memperluas 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 asal.

Lihat Cloud Logging

Melihat Grafik Beranda dan Menjalankan Pengujian

Untuk menampilkan perangkat Anda, pilih Home Graph dari panel Google Home Plugin.

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

Setelah perangkat Anda dimuat, klik data apa pun untuk memperluas payload JSON lengkap.

Payload JSON Grafik Rumah

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

Luaskan dan Ciutkan JSON Beranda

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

Pengujian Run Grafik Rumah

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

Pengujian Akhir Grafik Rumah

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 tab Log Adb 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 agar 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:

  • Temukan entri tertentu menggunakan kolom Find dan perintah Find Next (ikon ) dan Find previous ().
  • Gunakan pengubah Peka huruf besar/kecil atau Ekspresi reguler opsional.
  • Lompat ke baris untuk beralih ke baris yang ditentukan (menurut nomor) di log.

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

Penampil Log Adb

Referensi dan masukan

Klik Sumber daya untuk daftar alat dan sumber daya developer.

Untuk menyampaikan pendapat atau masukan Anda tentang cara kami dapat meningkatkan pengalaman pengembangan dengan Google Home Plugin, klik Masukan.

Kirim Masukan