Taman Bermain Google Home

Cloud-to-cloud    Local Home SDK    Home API

Google Home Playground adalah aplikasi web yang menyimulasikan project smart home dengan jenis dan karakteristik perangkat yang dapat dikonfigurasi. Anda dapat membuat perangkat virtual, mengubah atribut dan status perangkat, melihat perangkat ini di Google Home Graph, serta mengimpor atau mengekspor konfigurasi perangkat.

Menyelesaikan penautan akun

Untuk menggunakan Google Home Playground, sebaiknya Anda menautkan alat ini ke akun Anda terlebih dahulu. Buka Google Home app (GHA) di ponsel Anda, dan lakukan proses penautan akun yang diuraikan di Menghubungkan perangkat rumah pintar pihak ketiga di aplikasi Google Home.

  1. Telusuri integrasi berjudul Google Home Playground.
  2. Pilih integrasi, dan GHA akan mengarahkan Anda ke halaman login. Klik Login dengan Google dan pilih akun Anda untuk login.
  3. Klik tombol Otorisasi untuk mengizinkan penautan akun.
Gambar ini menunjukkan alur penautan akun aplikasi Google Home untuk menghubungkan Google Home Playground.

Setelah Anda menyelesaikan penautan akun, serangkaian perangkat virtual default akan ditampilkan di GHA untuk Anda berinteraksi.

Gambar ini menunjukkan daftar perangkat default yang terisi saat pengguna
            berhasil menautkan Google Home Playground ke akunnya.

Login

Luncurkan Google Home Playground dengan mengeklik tombol di bawah ini:

Buka Playground

Klik Sign in With Google. Pastikan Anda login dengan akun yang sama dengan yang Anda gunakan di GHA untuk menyelesaikan penautan akun.

Gambar ini menunjukkan status awal Google Home Playground,
            dan menyoroti tombol login di sudut kanan atas.

Setelah Anda login, Google Home Playground akan menampilkan perangkat virtual yang disimpan di Home Graph.

Gambar ini menunjukkan daftar perangkat, info perangkat, dan area log
            tampilan default Google Home Playground.

UI web terdiri dari tiga panel:

  • Daftar perangkat menampilkan semua perangkat virtual Anda. Anda dapat memilih perangkat virtual tertentu untuk melihat informasinya dan membuat perangkat virtual melalui panel ini.
  • Info perangkat menampilkan informasi perangkat virtual yang dipilih. Anda juga dapat mengedit informasi ini dan menghapus perangkat virtual yang dipilih melalui panel.
  • Area log menampilkan log interaksi antara Google Home Playground dan Home Graph. Anda dapat meluaskan log untuk memeriksa payload permintaan dan respons guna memecahkan masalah.

Perangkat virtual

Melihat info perangkat virtual

Di panel Device list, pilih perangkat virtual yang ingin Anda lihat. Di panel Device list, pilih perangkat virtual yang ingin Anda lihat. Panel Info perangkat akan menampilkan informasinya yang dikategorikan ke dalam lima tab:

  • Informasi dasar: properti tingkat teratas perangkat, termasuk jenis, ID, dan nama perangkat.
  • Trait: trait perangkat yang didukung.
  • Atribut: atribut khusus fitur perangkat.
  • States: semua status perangkat.
  • SUV: Konfigurasi Verifikasi Pengguna Sekunder perangkat.

Edit info perangkat virtual

Selain melihat informasi perangkat virtual, Anda juga dapat langsung mengedit informasinya yang disimpan di Home Graph melalui panel Info perangkat.

Ubah sifat yang didukung

  1. Pilih tab Ciri; klik tombol Edit.
  2. Di panel pop-up, Anda dapat melihat fitur perangkat yang saat ini didukung, dan fitur yang tersedia untuk ditambahkan. Gunakan tombol panah (arrow_forward/arrow_back) untuk menambahkan atau menghapus sifat yang didukung untuk perangkat.
  3. Setelah Anda selesai memperbarui sifat yang didukung, klik Simpan, dan sifat yang diperbarui akan diterapkan ke Home Graph.
  4. Anda dapat melihat pembaruan sifat ini di Area Log.
Gambar ini menunjukkan alat UX untuk menambahkan atau menghapus ciri yang didukung pada perangkat yang dipilih di Google Home Playground.

Ubah atribut perangkat

  1. Pilih tab Atribut, lalu edit atribut untuk ciri-ciri yang didukung oleh perangkat.
  2. Setelah selesai mengedit, tekan Enter dan perubahan atribut Anda akan diterapkan ke Home Graph.
  3. Anda dapat melihat atribut yang diperbarui ini di Area Log.

Ubah status perangkat

  1. Pilih tab Negara Bagian dan edit negara bagian secara langsung. Perubahan status akan diterapkan ke Home Graph.
  2. Anda dapat melihat modifikasi status ini di Area Log.

Menambahkan verifikasi pengguna sekunder ke perangkat virtual

Anda dapat menambahkan SUV ke perangkat virtual dan mengonfigurasi jenis tantangan serta perilaku yang sesuai di setiap perangkat. Anda dapat menambahkan SUV ke perangkat virtual dan mengonfigurasi jenis tantangan dan perilaku terkait pada setiap perangkat.

Mengonfigurasi SUV di perangkat

  1. Di panel Daftar perangkat, pilih perangkat virtual yang ingin Anda konfigurasi.
  2. Di panel Info perangkat, pilih tab SUV dan konfigurasikan hal berikut:
    • Diaktifkan: apakah SUV diaktifkan atau dinonaktifkan (tanpa tantangan) di perangkat.
    • Jenis tantangan: apakah SUV memerlukan konfirmasi eksplisit (ackNeeded) atau nomor identifikasi pribadi (pinNeeded).
    • PIN: PIN yang valid.
    • Penanganan PIN yang salah: saat PIN salah, apakah akan meminta pengguna lagi dan, jika tidak, error yang akan ditampilkan.
Gambar ini menunjukkan alat UX untuk mengaktifkan ciri verifikasi pengguna sekunder di perangkat yang dipilih di Google Home Playground.

Identifikasi perangkat yang mengaktifkan SUV

Di panel Daftar perangkat, ikon kunci kunci ditampilkan di samping setiap perangkat yang mendukung SUV.

Gambar ini menampilkan perangkat yang direkomendasikan untuk mengaktifkan verifikasi pengguna sekunder.

Daftar ciri berikut memerlukan SUV:

Membuat perangkat virtual baru

  1. Di panel Daftar perangkat, klik Tambahkan perangkat.
  2. Pada panel pop-up, pilih jenis perangkat dan masukkan nama perangkat untuk perangkat baru Anda. Alternatifnya, Anda dapat memilih serangkaian perangkat yang telah ditetapkan sebelumnya untuk ditambahkan.
  3. Setelah Anda menyelesaikan semua langkah, perangkat baru akan ditambahkan ke Home Graph.
Gambar ini menunjukkan alat UX untuk menambahkan jenis perangkat baru di
            Google Home Playground.

Hapus perangkat virtual

  1. Di panel Daftar perangkat, pilih perangkat yang ingin Anda hapus. Kemudian, di Info perangkat panel, pilih Informasi Dasar tab dan Kemudian, di Info perangkat panel, pilih Informasi Dasar tab dan klikIkon tempat sampah Hapus perangkat di bagian bawah.
  2. Konfirmasikan penghapusan perangkat pada peringatan pop-up.
  3. Setelah Anda mengonfirmasi penghapusan perangkat, perangkat akan dihapus dari Home Graph.
Gambar ini menunjukkan alat UX untuk menghapus jenis perangkat virtual di Google Home Playground.

Editor Respons Sinkronisasi

Anda dapat memvalidasi atau memperbarui respons sinkronisasi Anda di Google Home Playground. Klik Sync Response Editor untuk membuka IDE tertanam.

Gambar ini menunjukkan tombol untuk membuka editor respons sinkronisasi.

Edit, atau salin dan tempel, respons sinkronisasi Anda dan klik Simpan untuk menerapkan perubahan guna melihat cara kerjanya di ekosistem Google Home.

Gambar ini menunjukkan jendela untuk mengedit respons sinkronisasi.

Impor dan Ekspor perangkat virtual

Untuk mengatasi masalah atau mereproduksi masalah, Anda dapat mengekspor perangkat virtual beserta statusnya ke sebuah berkas, lalu membagikan berkas tersebut kepada orang lain untuk mengimpor dan mereplikasi perangkat virtual Anda.

Gambar ini menunjukkan alat UX untuk mengimpor dan mengekspor perangkat virtual di Google Home Playground.

Ekspor perangkat virtual ke file

  1. Klik untuk mengekspor perangkat virtual ke berkas.
  2. Masukkan nama file yang ingin Anda ekspor, lalu klik OK.
  3. Setelah Anda memasukkan nama file, browser akan mengunduh file perangkat virtual yang diekspor.

Impor perangkat virtual dari file

  1. Klik untuk mengimpor perangkat virtual dari file.
  2. Pilih berkas yang ingin Anda impor, lalu klik OK.
  3. Setelah Anda mengonfirmasi file yang akan diimpor, Google Home Playground akan mengimpor perangkat virtual dengan status dari file, dan memperbarui informasi dan status perangkat yang diimpor di Home Graph.

Memeriksa log interaksi

Saat Anda berinteraksi dengan perangkat virtual, Google Home Playground akan otomatis menerapkan perubahan Anda ke Home Graph. Interaksi dengan Home Graph dicatat ke panel Log area, tempat Anda dapat meluaskan setiap entri untuk memeriksa payload permintaan dan respons API Home Graph.

Setiap entri log adalah array JSON, yang berisi elemen dengan struktur berikut:

{
  "uri": string,
  "request": object,
  "response": object
}
Kolom Jenis Deskripsi
uri string URL panggilan API Home Graph.
request object Isi permintaan panggilan API Home Graph. Lihat dokumentasi referensi dokumentasi referensi untuk mengetahui format setiap metode.
response object Isi respons panggilan API Home Graph. Lihat dokumentasi referensi dokumentasi referensi untuk format setiap metode.

Melihat jenis dan trait perangkat yang didukung

Ikon tanda tanya bantuan di kanan atas akan menampilkan jenis perangkat saat ini dan daftar karakteristik yang didukung oleh Google Home Playground.

Gambar ini menunjukkan alat UX untuk menambahkan jenis perangkat baru di
            Google Home Playground.

Laporkan masalah

Kami ingin mendengar dari Anda! Laporkan masalah yang dialami menggunakan ikon tanda seru masukan di kanan atas.

Gambar ini menunjukkan ikon untuk memberikan masukan dan melaporkan masalah di Google Home Playground.