Ekstensi Google Home untuk VS Code

SDK Perangkat

Google Home Extension for Visual Studio Code dirancang dan dibuat untuk developer Google Home Platform. Ekstensi ini memberi Anda akses ke Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer, dan alat lainnya untuk menyederhanakan proses pengembangan Matter dan smart home Anda.

Ekstensi Google Home untuk VS Code

Fitur Ekstensi Google Home

Simulator Asisten Google

Untuk menguji apakah perangkat smart home Anda berfungsi dengan baik dengan ekosistem Google Home, Anda dapat berinteraksi dengan Assistant Simulator kapan saja tanpa meninggalkan VS Code.

Serupa dengan Simulator yang ada dan disediakan di Konsol Actions, Assistant Simulator memungkinkan Anda mengontrol perangkat dengan mudah dengan mengetik kueri, misalnya, "Turn on the light". Di dalam VS Code, Assistant Simulator akan merespons kembali dengan pesan teks berdasarkan perintah Anda, misalnya, "Baiklah, nyalakan lampu". Lihat Menggunakan Simulator Asisten Google untuk detail selengkapnya.

Penggunaan Batch

Untuk menguji integrasi Google Home seperti otomatisasi, Anda dapat mengirim ucapan batch ke Simulator Asisten Google dengan menjalankan skrip ucapan. Lihat Menjalankan Penggunaan Batch untuk detail selengkapnya.

Alat Logging Matter

Alat Logging Matter dapat mengumpulkan semua log yang terkait dengan proses debug Matter, termasuk log Google Home app (GHA) dan log layanan Google Play (GMS Core). Log tersebut dapat dilihat di VS Code dengan penelusuran filter dan kata kunci. Log dapat didownload dengan informasi debug tambahan seperti Android dan Versi aplikasi serta dikirim ke Google untuk melaporkan masalah.

Logging Masalah Ekstensi Google Home

Cloud Logging

Cloud Logging memberikan informasi proses debug dan metrik utama untuk memberi Anda insight tentang penggunaan Action. Untuk menyederhanakan pengembangan, Google Home Extension menampilkan pesan Google Cloud Logging real-time tepat di samping kode Anda selama pemecahan masalah. Baca artikel Melihat Cloud Logging untuk mengetahui detail selengkapnya.

Penampil Home Graph

Home Graph Viewer sekarang tersedia langsung di Google Home Extension sehingga Anda dapat memverifikasi status perangkat di Home Graph dalam VS Code. Lihat Melihat Home Graph dan Menjalankan Pengujian untuk detail selengkapnya.

Menginstal Ekstensi Google Home untuk VS Code

Untuk menginstal Google Home Extension, ikuti langkah-langkah berikut dari dalam VS Code:

  1. Klik ikon Ekstensi di Panel Aktivitas.
  2. Telusuri google home, lalu klik Instal.

    Marketplace Ekstensi Google Home

Anda juga dapat mendownload Google Home Extension langsung dari VS Code Marketplace.

Download Google Home Extension

Menyiapkan Ekstensi Google Home untuk VS Code

Setelah menginstal Google Home Extension dan memuat ulang VS Code, Anda harus login dan memilih project sebelum dapat menggunakan Assistant Simulator dan melihat Cloud Logging.

Login dengan Google dan pilih project cloud

Anda dapat login ke akun developer dari Google Home Extension, dan memberikan otorisasi kepada VS Code untuk berkomunikasi dengan layanan Google atas nama Anda.

  1. Klik ikon Google Home di Panel Aktivitas untuk membuka Google Home Extension.

    Ikon Ekstensi Google Home
  2. Klik Sign in with Google untuk meluncurkan tampilan login di browser Anda.

    Masuk dengan Google VS Code
  3. Pilih akun yang ditautkan dengan perangkat smart home Anda.

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

  5. Tab browser akan terbuka dan kotak dialog Open Visual Studio Code akan ditampilkan. Klik Open Visual Studio Code untuk melanjutkan.

    Buka kotak dialog VS Code
  6. Anda akan dialihkan ke VS Code, tempat Anda memerlukan izin untuk mengizinkan Ekstensi Google Home membuka URI. Klik Open untuk menyelesaikan proses login.

    Mengizinkan Ekstensi Google Home membuka URI
  7. Setelah login, Google Home Extension akan memuat project Anda. Setelah selesai, klik Select a project.

    Memilih project
  8. Di jendela drop-down Search and select a project yang muncul, pilih project smart home Anda.

Menginstal Alat Android Debug Bridge (ADB)

Untuk melihat log Matter di ponsel Android, Anda harus menginstal ADB:

  1. Instal ADB di komputer Anda.
  2. Aktifkan Opsi Developer dan Proses Debug USB di ponsel Android Anda.

Instal Alat SoC Perangkat Matter

Untuk melihat log debug dari perangkat Matter:

  1. Sebagian besar SoC perangkat akan mengekspor port serial seperti /dev/ttyUSBx di Linux atau /dev/tty.SLAB_USBtoUART atau /dev/tty.usbserial di MacOS. LogViewer dapat membaca log dari perangkat secara langsung.
  2. Beberapa jenis SoC seperti NXP atau Silicon Labs mungkin memerlukan penginstalan alat eksternal (misalnya, JLink). Lihat Perangkat yang didukung untuk mengetahui informasi selengkapnya.

Menggunakan Ekstensi Google Home untuk VS Code

Lihat Referensi Developer

Di bagian BANTUAN DAN MASUKAN, klik Mulai & Referensi untuk membuka halaman Referensi, tempat Anda dapat menemukan informasi yang berguna untuk pengembangan Anda dengan ekosistem Google Home.

Referensi untuk Ekosistem Google Home

Menggunakan Simulator Asisten Google

Untuk membuka Assistant Simulator di VS Code, klik SIMULATOR GOOGLE ASSISTANT di Side Bar. Di kotak Message, ketik kueri dan tekan Enter.

Anda dapat melihat respons Assistant Simulator, lalu mengklik tombol setelah kueri untuk Mengirim ulang kueri.

Menggunakan Simulator Asisten Google

Menjalankan Penggunaan Batch

Arahkan kursor ke panel menu GOOGLE ASSISTANT SIMULATOR, dan pilih dari opsi berikut untuk menyiapkan skrip:

  • Klik untuk membuka skrip ucapan yang ada.

  • Klik untuk menyimpan histori ke dalam skrip *.utterance.

    Ikon Menu Penggunaan Batch

Untuk mulai mengirim ucapan dalam batch, pilih dari opsi berikut:

  • Klik untuk memilih skrip ucapan dari jendela drop-down.
  • Langsung buka file *.utterance, lalu klik .

    Ikon Batch Utterances Run

Lihat Cloud Logging

Di bagian AKSES CEPAT, klik Cloud Logs untuk membuka halaman Cloud Logs, tempat Anda dapat menemukan log yang termasuk dalam project yang Anda pilih.

Menggunakan Cloud Logging

Pengguna dapat memfilter log berdasarkan tingkat keparahan dan rentang waktu.

Memfilter log menurut tingkat keparahan dan waktu

Secara default, log dibatasi hingga 50 baris. Jika pengguna ingin melihat lebih banyak log, scroll ke bagian bawah, lalu klik More untuk melihat log lainnya.

Lihat log lainnya

Melihat Home Graph dan Menjalankan Pengujian

Di bagian QUICK ACCESS, klik Home Graph Viewer untuk membuka panel Home Graph Viewer, tempat Anda dapat menemukan perangkat yang termasuk dalam project yang dipilih. Anda juga dapat mengklik Run Test untuk menjalankan pengujian bagi perangkat.

Penampil Home Graph

Tindakan ini akan meluncurkan rangkaian pengujian di browser Anda dengan memilih perangkat dan siap diuji. Klik Start dan tunggu hasil pengujian.

Test Suite Google Home

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

Hasil tes

Menggunakan Ekstensi Google Home untuk Proses Debug Matter

Logging Android

Di bagian MATER LOGGING TOOLS, klik Android Logs untuk membuka halaman Android Logs, pilih ponsel Android yang ingin Anda hubungkan dan mulai menampilkan log.

Logging Android

Setelah ponsel Android terhubung, Anda dapat melihat log baris demi baris. Perhatikan bahwa log difilter, sehingga hanya log yang terkait dengan GHA dan modul Matter Google Play services yang ditampilkan. Anda juga dapat menetapkan Tingkat Keparahan untuk memfilter log atau menerapkan Search sebagai kata kunci di log.

Logging Android Difilter

Logging Perangkat Matter

Di bagian MATERI LOGGING TOOLS, klik Device Logs untuk membuka halaman Resources, pilih SoC Type terlebih dahulu:

Logging perangkat Matter

Berikutnya, pilih Matter Device:

Perangkat tertentu logging perangkat Matter

Kemudian, Anda bisa mendapatkan semua log perangkat dari perangkat dan menggunakan filter seperti Tingkat Keparahan dan Penelusuran untuk menemukan informasi yang diinginkan.

Logging yang difilter perangkat Matter

Download semua Log Masalah

Di bagian AKSES SINGKAT, klik Download Log untuk membuka dialog Download Log, pilih log yang akan didownload, lalu tekan Oke.

Download Log Masalah

Pilih folder untuk mendownload log, lalu klik Save:

Penyimpanan Log Masalah

Kemudian, log akan disimpan ke folder tujuan:

Folder Tujuan Log Masalah

Ekstrak file ZIP yang disimpan, tindakan ini akan menampilkan info perangkat dan file log.

Zipfile Log Masalah

File info perangkat akan menyertakan semua informasi versi yang diperlukan untuk melakukan debug masalah.

Debug Log Masalah

Kirim masukan

Untuk mengirimkan pendapat atau masukan Anda tentang cara kami dapat meningkatkan pengalaman pengembangan dengan Google Home Extension, pilih dari opsi berikut:

  • Di panel BANTUAN DAN MASUKAN, klik Beri Masukan untuk memberi kami saran.
  • Pada panel BANTUAN DAN MASUKAN, klik Laporkan Masalah untuk melaporkan masalah yang ditemukan di Google Home Extension
Ikon Kirim Masukan
  • Kami juga telah menyediakan ikon masukan di halaman Referensi.