Taman Bermain Google Home

SDK Perangkat

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

Selesaikan penautan akun

Untuk menggunakan Google Home Playground, sebaiknya tautkan terlebih dahulu ke akun Anda. Buka Google Home app (GHA) di ponsel, dan mulai melalui proses penautan akun:

  1. Klik ikon plus (+) di pojok kiri atas.
  2. Pilih Siapkan perangkat > Kompatibel dengan Google.
  3. Telusuri Action yang berjudul Google Home Playground.
  4. Pilih Action, dan GHA akan mengarahkan Anda ke halaman login Google. Klik Login dengan Google, lalu pilih akun untuk login.
  5. Klik tombol Otorisasi untuk mengizinkan penautan akun.
Gambar ini menunjukkan alur penautan akun aplikasi Google Home untuk
            yang menghubungkan Google Home Playground.

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

Gambar ini menampilkan daftar perangkat default yang terisi saat pengguna
            berhasil menautkan Google Home Playground ke akun mereka.

Login

Luncurkan Google Home Playground dengan mengklik tombol di bawah:

Luncurkan Playground

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

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

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

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

UI web terdiri dari tiga panel:

  • Daftar perangkat menampilkan semua perangkat virtual Anda. Anda dapat memilih perangkat virtual untuk melihat informasinya dan membuat perangkat virtual melalui panel ini.
  • Device info menampilkan informasi perangkat virtual yang dipilih. Anda juga dapat mengedit informasi ini dan menghapus perangkat virtual yang dipilih melalui panelnya.
  • Area log menampilkan log interaksi antara Google Home Playground dan Home Graph. Anda dapat memperluas log untuk memeriksa payload permintaan dan respons bagi pemecahan masalah.

Perangkat virtual

Lihat info perangkat virtual

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

  • Informasi dasar: properti tingkat atas perangkat, termasuk perangkat type, id, dan name.
  • Trait: karakteristik perangkat yang didukung.
  • Atribut: atribut khusus ciri perangkat.
  • Status: semua status perangkat.
  • SUV: Konfigurasi Verifikasi Pengguna Sekunder dari perangkat.

Edit info perangkat virtual

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

Mengubah karakteristik yang didukung

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

Mengubah atribut perangkat

  1. Pilih tab Atribut, dan edit atribut untuk trait 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.

Mengubah status perangkat

  1. Pilih tab States lalu edit status secara langsung. Perubahan status akan diterapkan ke Home Graph.
  2. Anda dapat melihat perubahan status ini di Area log.

Menambahkan verifikasi pengguna sekunder ke perangkat virtual

Anda dapat menambahkan SUV ke perangkat virtual dan mengkonfigurasi jenis tantangan dan perilaku yang sesuai pada setiap perangkat. Anda dapat menambahkan SUV ke perangkat virtual dan mengkonfigurasi jenis tantangan dan perilaku yang sesuai pada setiap perangkat.

Konfigurasi SUV di perangkat

  1. Di panel Daftar perangkat, pilih perangkat virtual yang ingin Anda dikonfigurasikan.
  2. Di panel Device info, pilih tab SUV dan konfigurasikan berikut ini:
    • Diaktifkan: apakah SUV diaktifkan atau dinonaktifkan (tidak ada tantangan) di perangkat.
    • Jenis tantangan: apakah SUV memerlukan konfirmasi eksplisit atau tidak (ackNeeded) atau nomor identitas pribadi (pinNeeded).
    • PIN: PIN yang valid.
    • Penanganan PIN yang salah: jika PIN salah, apakah akan menanyakan pengguna lagi dan, jika tidak, {i>error<i} yang perlu direspons.
Gambar ini menunjukkan alat UX untuk mengaktifkan pengguna sekunder
            fitur verifikasi pada perangkat yang dipilih di Google Home
            Taman Bermain.

Identifikasi perangkat yang mendukung SUV

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

Gambar ini menunjukkan perangkat yang direkomendasikan untuk mengaktifkan fitur sekunder
            verifikasi pengguna.

Daftar karakteristik 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 perangkat baru Anda. Atau, Anda dapat memilih satu set perangkat yang telah ditetapkan untuk tambahkan.
  3. Setelah Anda menyelesaikan semua langkah, perangkat baru akan ditambahkan ke Home Graph.
Gambar ini menunjukkan {i>tool<i} UX untuk menambahkan tipe perangkat baru pada
            Google Home Playground.

Menghapus perangkat virtual

  1. Di panel Daftar perangkat, pilih perangkat yang ingin dihapus. Kemudian, di panel Info perangkat, pilih tab Informasi Dasar dan Kemudian, di panel Info perangkat, pilih tab Informasi Dasar dan klik Ikon sampahHapus perangkat di bagian bawah.
  2. Konfirmasi penghapusan perangkat di notifikasi pop-up.
  3. Setelah Anda mengonfirmasi penghapusan perangkat, perangkat akan dihapus dari Home Graph.
Gambar ini menunjukkan {i>tool<i} UX untuk 
menghapus jenis perangkat virtual di
            Google Home Playground.

Editor Respons Sinkronisasi

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

Gambar ini menampilkan tombol untuk membuka editor respons sinkronisasi.

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

Gambar ini menampilkan jendela untuk mengedit respons sinkronisasi.

Mengimpor dan Mengekspor perangkat virtual

Untuk memecahkan masalah atau mereproduksi masalah, Anda dapat mengekspor perangkat virtual status mereka ke sebuah file, dan membagikan file tersebut kepada orang lain untuk diimpor dan mereplikasi perangkat virtual Anda.

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

Mengekspor perangkat virtual ke file

  1. Klik untuk mengekspor perangkat virtual ke file.
  2. Masukkan nama file yang ingin diekspor, lalu klik OK.
  3. Setelah Anda memasukkan nama {i>file<i}, {i>browser<i} akan mengunduh file perangkat virtual yang diekspor.

Impor perangkat virtual dari file

  1. Klik untuk mengimpor virtual perangkat dari sebuah file.
  2. Pilih file 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 mengupdate file informasi dan status perangkat di Home Graph.

Memeriksa log interaksi

Saat Anda berinteraksi dengan perangkat virtual, Google Home Playground secara otomatis menerapkan perubahan Anda ke Home Graph. Tujuan interaksi dengan Home Graph dicatat ke Area log panel, tempat Anda dapat memperluas setiap entri untuk memeriksa Home Graph payload permintaan dan respons API.

Setiap entri log adalah array JSON, yang berisi elemen dari 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 format setiap metode.
response object Isi respons panggilan API Home Graph. Lihat dokumentasi referensi dokumentasi referensi untuk format setiap metode.

Melihat jenis dan karakteristik perangkat yang didukung

Bantuan tanda tanya di kanan atas akan menampilkan jenis perangkat dan daftar ciri saat ini didukung oleh Google Home Playground.

Gambar ini menunjukkan {i>tool<i} UX untuk menambahkan tipe perangkat baru pada
            Google Home Playground.

Laporkan masalah

Kami ingin mendengar pendapat Anda. Laporkan mengalami masalah saat menggunakan ikon tanda seru masukan terkait kanan atas.

Gambar ini menampilkan ikon untuk memberikan masukan dan pelaporan
       masalah di Google Home Playground.