Ekstensi Google Home untuk VS Code

Matter    Cloud-to-cloud    Local Home SDK

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, Pelihat Grafik Rumah, 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 keluar dari VS Code.

Assistant Simulator memungkinkan Anda mengontrol perangkat dengan mudah dengan mengetikkan pertanyaan Anda, misalnya, "Nyalakan lampu." Di dalam VS Code, Assistant Simulator akan merespons kembali dengan pesan teks berdasarkan perintah Anda, misalnya, "Oke, nyalakan lampu." Lihat Menggunakan Simulator Asisten Google untuk mengetahui detail selengkapnya.

Batch Ucapan

Untuk menguji integrasi Google Home seperti automaton, Anda dapat mengirimkan kumpulan ucapan ke Simulator Asisten Google dengan menjalankan skrip ucapan. Lihat Menjalankan Batch Ucapan untuk mengetahui detail selengkapnya.

Alat Logging Matter

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

Pencatatan Matter Ekstensi Google Home

Cloud Logging

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

Home Graph Viewer

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

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

    Google Home Extension Marketplace

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

Download Google Home Extension

Menyiapkan Ekstensi Google Home untuk VS Code

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

Masuk dengan Google dan pilih proyek cloud

Anda dapat login ke akun developer dari Google Home Extension, mengizinkan VS Code berkomunikasi dengan layanan Google atas nama Anda.

  1. Klik ikon Google Home pada Bilah Aktivitas untuk membuka Google Home Extension.

    Ikon Ekstensi Google Home
  2. Klik Masuk dengan Google untuk meluncurkan tampilan masuk di browser Anda.

    Login dengan Google di VS Code
  3. Pilih akun yang terhubung dengan perangkat rumah pintar Anda.

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

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

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

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

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

Instal 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 Pengembang dan USB Debugging 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 langsung dari perangkat.
  2. Beberapa jenis SoC seperti NXP atau Silicon Labs mungkin memerlukan alat eksternal (misalnya, JLink) untuk diinstal. Lihat Perangkat yang didukung untuk informasi selengkapnya.

Gunakan Ekstensi Google Home untuk VS Code

Lihat Sumber Daya Pengembang

Di bagian BANTUAN DAN MASUKAN, klik Mulai & Sumber Daya untuk membuka halaman Sumber Daya, tempat Anda dapat menemukan informasi bermanfaat untuk pengembangan dengan ekosistem Google Home.

Referensi untuk Ekosistem Google Home

Gunakan Simulator Asisten Google

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

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

Gunakan Simulator Asisten Google

Menjalankan Ucapan Batch

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

  • Klik untuk membuka skrip ucapan yang ada.

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

    Ikon Menu Batch Ucapan

Untuk mulai mengirimkan ucapan batch, pilih salah satu opsi berikut:

  • Klik untuk memilih skrip ucapan dari jendela drop-down.
  • Buka file *.utterance secara langsung dan klik .

    Ikon Jalankan Ucapan Batch

Melihat Cloud Logging

Di bawah AKSES CEPAT, klik Log Cloud untuk membuka halaman Log Cloud, tempat Anda dapat menemukan log milik proyek yang Anda pilih.

Gunakan 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 bawah, lalu klik Lainnya untuk melihat lebih banyak log.

Melihat log lainnya

Lihat Grafik Beranda dan Jalankan 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 mengeklik Jalankan Pengujian untuk menjalankan pengujian pada perangkat.

Penampil Grafik Rumah

Ini akan meluncurkan rangkaian pengujian di peramban Anda dengan perangkat Anda dipilih dan siap untuk diuji. Klik Mulai dan tunggu hasil pengujian.

Google Home Test Suite

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 ALAT PENCATATAN MATTER, klik Log Android untuk membuka halaman Log Android, pilih ponsel Android yang ingin Anda hubungkan dan mulai menampilkan log.

Pencatatan Android

Setelah ponsel Android terhubung, Anda dapat melihat log baris demi baris. Perhatikan bahwa log difilter, yang berarti hanya log yang terkait dengan GHA dan Google Play services Matter module yang ditampilkan. Anda juga dapat menyetel Severity untuk memfilter log atau Search kata kunci dalam log.

Android Logging yang Difilter

Logging Perangkat Matter

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

Logging perangkat Matter

Selanjutnya, pilih Perangkat Matter:

Logging perangkat Matter memilih perangkat

Kemudian, Anda bisa mendapatkan semua log perangkat dari perangkat dan menggunakan filter seperti Severity dan Search untuk menemukan informasi yang Anda minati.

Pencatatan perangkat materi yang difilter

Mendownload semua Log Masalah

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

Mendownload Log Matter

Pilih folder untuk mendownload log, lalu klik Simpan:

Log Materi Simpan

Kemudian log akan disimpan ke folder tujuan:

Folder Tujuan Log Masalah

Ekstrak file zip yang disimpan, yang akan menampilkan info perangkat dan file log.

File Zip Log Masalah

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

Debug Log Matter

Kirim masukan

Untuk menyampaikan pemikiran atau masukan Anda tentang bagaimana kami dapat meningkatkan pengalaman pengembangan dengan Google Home Extension, pilih dari opsi berikut:

  • Di panel BANTUAN DAN MASUKAN, klik Berikan Masukan untuk memberi kami saran.
  • Pada panel BANTUAN DAN MASUKAN, klik Laporkan Masalah untuk melaporkan masalah apa pun yang Anda temukan dengan Google Home Extension
Ikon Kirim Masukan
  • Kami juga menyediakan ikon umpan balik di halaman Sumber Daya.