Ekstensi Google Home untuk VS Code

SDK Perangkat

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

Ekstensi Google Home untuk VS Code

Fitur Ekstensi Google Home

Simulator Asisten Google

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

Serupa dengan yang sudah ada Simulator disediakan di Konsol Actions, Assistant Simulator memungkinkan Anda kontrol perangkat Anda dengan mengetik kueri Anda, misalnya, "Nyalakan lampu". Di dalam VS Code, Assistant Simulator akan membalas dengan pesan teks berdasarkan perintah Anda, misalnya, "Oke, menyalakan lampu". Lihat Gunakan Simulator Asisten Google untuk mengetahui info selengkapnya spesifikasi pendukung.

Ucapan Batch

Untuk menguji integrasi Google Home seperti otomatisasi, Anda dapat mengirim batch ucapan ke Simulator Asisten Google dengan menjalankan skrip ucapan. Lihat Menjalankan Pesan Batch untuk mengetahui 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). Tujuan log dapat dilihat di VS Code dengan filter dan pencarian kata kunci. Catatan dapat didownload dengan informasi debug tambahan seperti Android dan Versi aplikasi serta dikirim ke Google untuk pelaporan masalah performa.

Pencatatan Log Masalah Ekstensi Google Home

Cloud Logging

Cloud Logging memberikan informasi proses debug dan metrik utama untuk memberikan analisis 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 Melihat Cloud Logging untuk mengetahui detail selengkapnya.

Penampil Home Graph

Penampil Grafik Beranda sekarang tersedia langsung di Google Home Extension agar Anda dapat memverifikasi status perangkat di {i>Home Graph <i}Anda di dalam VS Code. Lihat Lihat Grafik Beranda dan Menjalankan Pengujian untuk mengetahui informasi selengkapnya spesifikasi pendukung.

Instal Ekstensi Google Home untuk VS Code

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

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

    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 akan harus login dan memilih project sebelum Anda dapat menggunakannya Assistant Simulator dan lihat Cloud Logging.

Login dengan Google dan pilih project cloud

Anda dapat login ke akun developer dari Google Home Extension, memberi otorisasi 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.

    VS Code Login dengan Google
  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 muncul ditampilkan. Klik Open Visual Studio Code untuk melanjutkan.

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

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

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

Menginstal Alat Android Debug Bridge (ADB)

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

  1. Instal ADB di komputer Anda.
  2. Mengaktifkan Opsi Developer dan USB Proses debug di ponsel Android Anda.

Instal Alat SoC Perangkat Matter

Untuk melihat log debug dari Matter perangkat:

  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 akses eksternal (misalnya, JLink) yang akan diinstal. Lihat Perangkat yang didukung untuk mengetahui info selengkapnya tidak akurat atau tidak sesuai.

Menggunakan Ekstensi Google Home untuk VS Code

Lihat Referensi Developer

Di bagian BANTUAN DAN MASUKAN, klik Mulai & Referensi yang akan dibuka halaman Referensi, tempat Anda dapat menemukan informasi bermanfaat untuk pengembangan web 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. Dalam kotak Message, ketik kueri Anda dan tekan Enter.

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

Gunakan Simulator Asisten Google

Menjalankan Perintah Batch

Arahkan mouse 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 Ucapan Batch

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

  • Klik untuk memilih skrip ucapan dari jendela {i>drop-down<i}.
  • Langsung buka file *.utterance lalu klik .

    Ikon Batch Utterances Run

Lihat Cloud Logging

Di bagian AKSES CEPAT, klik Cloud Logs untuk membuka Cloud Logs. tempat Anda dapat menemukan log milik 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 Lainnya untuk melihat log lainnya.

Lihat log lainnya

Melihat Home Graph dan Menjalankan Pengujian

Di bagian AKSES CEPAT klik Penampil Grafik Beranda untuk membuka Beranda Panel Penampil Grafik, tempat Anda dapat menemukan perangkat yang termasuk ke dalam proyek. Anda juga dapat mengklik Run Test untuk menjalankan pengujian perangkat.

Penampil Home Graph

Ini akan meluncurkan rangkaian tes di {i>browser<i} Anda dengan memilih perangkat dan siap diuji. Klik Start dan tunggu hasil pengujiannya.

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 FITUR LOGGING MASALAH, klik Android Logs untuk buka halaman Android Logs, pilih Android ponsel yang ingin Anda hubungkan dan mulai ditampilkan log.

Logging Android

Setelah ponsel Android terhubung, Anda akan dapat melihat log baris demi baris. Perhatikan bahwa log difilter, yang berarti hanya log yang terkait dengan GHA dan Modul Google Play services Matter yang ditampilkan. Anda juga dapat menetapkan Severity untuk memfilter log atau memilih opsi Telusuri kata kunci di log.

Logging Android yang Difilter

Pencatatan Log Perangkat Matter

Di bagian ALAT LOG MATERI, klik Log Perangkat untuk membuka halaman Resource, 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 Telusuri untuk menemukan informasi yang Anda minati.

Logging yang difilter perangkat Matter

Download semua Log Matter

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

Download Log Matter

Pilih folder untuk mendownload log, lalu klik Simpan:

Penyimpanan Log Matter

Kemudian, log akan disimpan ke folder tujuan:

Folder Tujuan Log Masalah

Ekstrak file ZIP yang tersimpan. Info perangkat dan file log akan ditampilkan.

Zipfile Log Masalah

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

Debug Log Matter

Kirim masukan

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

  • Di panel BANTUAN DAN MASUKAN, klik Berikan Masukan untuk memberi kami ejaan atau mendapatkan saran gaya.
  • Di panel BANTUAN DAN MASUKAN, klik Laporkan Masalah untuk melaporkan masalah yang Anda temukan pada Google Home Extension
Ikon Kirim Masukan
  • Kami juga telah menyediakan ikon masukan di halaman Referensi.