Cloud-to-cloud Local Home SDK Device SDK
Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.
Penautan akun selesai
Untuk menggunakan Home Playground, sebaiknya tautkan alat tersebut ke akun Anda terlebih dahulu. Buka Google Home app (GHA) on your phone, and go through the account linking process:
- Klik ikon plus (+) di sudut kiri atas.
- Pilih Siapkan perangkat > Kompatibel dengan Google.
- Telusuri Action berjudul Google Home Playground.
- Pilih Tindakan, dan GHA akan mengarahkan Anda ke halaman login. Klik Login dengan Google dan pilih akun Anda untuk login.
- Klik tombol Otorisasi untuk mengizinkan penautan akun.

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

Login
Luncurkan Home Playground dengan mengklik tombol di bawah:
Klik Login dengan Google. Pastikan Anda login dengan akun yang sama yang digunakan di GHA untuk menyelesaikan penautan akun.

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

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 menyajikan 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 Home Playground dan Home Graph. Anda dapat memperluas log untuk memeriksa payload permintaan dan respons untuk memecahkan masalah.
Perangkat virtual
Lihat info perangkat virtual
Di panel Daftar perangkat, pilih perangkat virtual yang ingin Anda lihat. Panel Info perangkat akan menampilkan informasinya yang dikategorikan ke dalam lima tab:
- Informasi dasar: properti tingkat atas perangkat, termasuk jenis perangkat, ID, dan nama.
- Fitur: karakteristik perangkat yang didukung.
- Atribut: atribut khusus fitur perangkat.
- Status: 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 tersimpan di Home Graph melalui panel Info perangkat.
Mengubah karakteristik yang didukung
- Pilih tab Traits; klik tombol Edit.
- Di panel pop-up, Anda dapat melihat fitur perangkat yang saat ini didukung, dan
fitur yang tersedia untuk ditambahkan. Gunakan tombol arrow
(arrow_forward/arrow_back) untuk menambahkan atau menghapus fitur yang didukung untuk perangkat. - Setelah selesai memperbarui karakteristik yang didukung, klik Simpan, dan fitur yang diperbarui akan diterapkan ke Home Graph.
- Anda dapat melihat update fitur ini di area Log.

Mengubah atribut perangkat
- Pilih tab Basic Information/Attributes, lalu edit atribut untuk fitur yang didukung perangkat.
- Setelah selesai mengedit, tekan Enter dan perubahan atribut Anda akan diterapkan ke Home Graph.
- Anda dapat melihat atribut yang diperbarui ini di area Log.
Mengubah status perangkat
- Pilih tab States dan edit status secara langsung. Perubahan status akan diterapkan ke Home Graph.
- Anda dapat melihat perubahan status ini di area Log.
Menambahkan verifikasi pengguna sekunder ke perangkat virtual
Anda dapat menambahkan SUV ke perangkat virtual dan mengonfigurasi jenis tantangannya serta perilaku yang sesuai di setiap perangkat.
Konfigurasikan SUV di perangkat
- Di panel Daftar perangkat, pilih perangkat virtual yang ingin Anda konfigurasi.
- Di panel Info perangkat, pilih tab SUV dan konfigurasikan
hal berikut:
- Diaktifkan: apakah SUV diaktifkan atau dinonaktifkan (tidak ada verifikasi) di perangkat.
- Jenis tantangan: apakah SUV memerlukan konfirmasi eksplisit (ackNeeded) atau nomor identifikasi pribadi (pinNeeded).
- PIN: PIN yang valid.
- Penanganan PIN yang salah: jika PIN salah, apakah akan meminta pengguna lagi dan, jika tidak, error akan merespons.

Identifikasi perangkat yang mengaktifkan SUV
Pada panel Daftar perangkat, ikon kunci kunci akan ditampilkan di samping setiap perangkat yang mengaktifkan SUV.

Daftar karakteristik berikut memerlukan SUV:
Membuat perangkat virtual baru
- Di panel Daftar perangkat, klik Tambahkan perangkat.
- Di panel pop-up, pilih jenis perangkat dan masukkan nama perangkat untuk perangkat baru Anda. Atau, Anda dapat memilih kumpulan perangkat yang telah ditetapkan untuk ditambahkan.
- Setelah menyelesaikan semua langkah, perangkat baru akan ditambahkan ke Home Graph.

Menghapus perangkat virtual
- Di panel Daftar perangkat, pilih perangkat yang ingin dihapus.
Kemudian, di panel Info perangkat, pilih tab Informasi Dasar dan
klik
Hapus perangkat di bagian bawah.
- Konfirmasi penghapusan perangkat di peringatan pop-up.
- Setelah Anda mengonfirmasi penghapusan perangkat, perangkat akan dihapus dari Home Graph.

Mengimpor dan Mengekspor perangkat virtual
Untuk memecahkan masalah atau mereproduksi masalah, Anda dapat mengekspor perangkat virtual dengan statusnya ke file, dan membagikan file tersebut kepada orang lain untuk diimpor dan mereplikasi perangkat virtual Anda.

Mengekspor perangkat virtual ke file
- Klik untuk mengekspor perangkat virtual ke file.
- Masukkan nama file yang ingin Anda ekspor, lalu klik OK.
- Setelah Anda memasukkan nama file, browser akan mendownload file perangkat virtual yang diekspor.
Mengimpor perangkat virtual dari file
- Klik untuk mengimpor perangkat virtual dari file.
- Pilih file yang ingin Anda impor, lalu klik OK.
- Setelah Anda mengonfirmasi file yang akan diimpor, Home Playground akan mengimpor perangkat virtual dengan status dari file, serta memperbarui informasi dan status perangkat yang diimpor di Home Graph.
Memeriksa log interaksi
Saat Anda berinteraksi dengan perangkat virtual, Home Playground otomatis menerapkan perubahan Anda ke Home Graph. Interaksi dengan Home Graph Dicatat ke panel Area log, tempat Anda dapat meluaskan setiap entri untuk memeriksa payload respons dan permintaan API Home Graph.
Setiap entri log adalah array JSON, yang berisi elemen 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 untuk format setiap metode. |
response |
object |
Isi respons panggilan API Home Graph. Lihat dokumentasi referensi untuk format setiap metode. |
Melihat jenis dan karakteristik perangkat yang didukung
Ikon bantuan tanda tanya di kanan atas akan menampilkan jenis perangkat dan daftar fitur yang saat ini didukung oleh Home Playground.

Masukan dan masalah laporan
Kami ingin mendengar pendapat Anda. Beri kami masukan dengan mengklik ikon wajah tersenyum sentiment_happy di kanan atas, atau laporkan masalah menggunakan ikon tanda tanda seru masukan.
