Cloud-to-cloud Local Home SDK Device SDK
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 tersebut di Google Home Graph, dan mengimpor atau mengekspor konfigurasi perangkat.
Selesaikan penautan akun
Untuk menggunakan Google Home Playground, sebaiknya tautkan alat ke akun Anda terlebih dahulu. Buka Google Home app (GHA) di ponsel, dan lakukan proses penautan akun:
- Klik ikon plus (+) di pojok kiri atas.
- Pilih Siapkan perangkat > Kompatibel dengan Google.
- Telusuri Action yang berjudul Google Home Playground.
- Pilih Action, dan GHA akan mengarahkan Anda ke halaman login. Klik Sign in with Google dan pilih akun Anda untuk login.
- Klik tombol Otorisasi untuk mengizinkan penautan akun.
Setelah Anda menyelesaikan penautan akun, serangkaian perangkat virtual default akan muncul di GHA untuk berinteraksi dengan Anda.
Login
Luncurkan Google Home Playground dengan mengklik tombol di bawah:
Klik Sign in With Google. Pastikan Anda login dengan akun yang sama dengan yang Anda gunakan di GHA untuk menyelesaikan penautan akun.
Setelah Anda login, Google Home Playground akan menampilkan perangkat virtual yang disimpan di 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 menampilkan informasi perangkat virtual yang dipilih. Anda juga dapat mengedit informasi ini dan menghapus perangkat virtual yang dipilih melalui panel.
- Log area menampilkan log interaksi antara Google Home Playground dan Home Graph. Anda dapat memperluas log untuk memeriksa payload permintaan dan respons guna memecahkan masalah.
Perangkat virtual
Melihat 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 informasinya yang dikategorikan ke dalam lima tab:
- Informasi dasar: properti tingkat atas perangkat, termasuk jenis, ID, dan nama perangkat.
- Traits: karakteristik perangkat yang didukung.
- Atribut: atribut khusus ciri perangkat.
- Status: semua status perangkat.
- SUV: Konfigurasi Verifikasi Sekunder Pengguna perangkat.
Mengedit info perangkat virtual
Selain melihat informasi perangkat virtual, Anda juga dapat langsung mengedit informasinya yang tersimpan di Home Graph melalui panel Info perangkat.
Mengubah Trait yang didukung
- Pilih tab Traits; klik tombol Edit.
- Di panel pop-up, Anda dapat melihat karakteristik perangkat yang saat ini didukung, dan karakteristik yang tersedia untuk ditambahkan. Gunakan tombol panah
(arrow_forward/arrow_back) untuk menambahkan atau menghapus Trait yang didukung untuk perangkat. - Setelah selesai memperbarui karakteristik yang didukung, klik Simpan, dan karakteristik yang diperbarui akan diterapkan ke Home Graph.
- Anda dapat melihat pembaruan karakteristik ini di Log area.
Mengubah atribut perangkat
- Pilih tab Attributes, lalu edit atribut untuk ciri yang didukung oleh 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, lalu edit status secara langsung. Perubahan status akan diterapkan ke Home Graph.
- Anda dapat melihat modifikasi status ini di Area log.
Menambahkan verifikasi sekunder pengguna ke perangkat virtual
Anda dapat menambahkan SUV ke perangkat virtual dan mengonfigurasi jenis tantangannya dan perilaku yang sesuai di setiap perangkat. Anda dapat menambahkan SUV ke perangkat virtual dan mengonfigurasi jenis tantangannya dan perilaku yang sesuai di setiap perangkat.
Konfigurasi SUV di perangkat
- Di panel Device list, pilih perangkat virtual yang ingin Anda konfigurasi.
- Di panel Info perangkat, pilih tab SUV dan konfigurasikan
hal berikut:
- Enabled: 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: jika PIN salah, apakah bertanya lagi kepada pengguna dan, jika tidak, error akan direspons.
Mengidentifikasi perangkat yang mengaktifkan SUV
Di panel Daftar perangkat, tombol ikon akan ditampilkan di samping setiap perangkat yang mendukung SUV.
Daftar ciri berikut yang 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 serangkaian perangkat yang telah ditentukan sebelumnya untuk ditambahkan.
- Setelah Anda 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 Device info, pilih tab Basic Information, lalu di panel Device info, pilih tab Basic Information dan klik Remove device di bagian bawah.
- Konfirmasi penghapusan perangkat di notifikasi pop-up.
- Setelah Anda mengonfirmasi penghapusan perangkat, perangkat tersebut akan dihapus dari Home Graph.
Editor Respons Sinkronisasi
Anda dapat memvalidasi atau memperbarui respons sinkronisasi di Google Home Playground. Klik Sync Response Editor untuk membuka IDE tersemat.
Edit, atau salin dan tempel, respons sinkronisasi Anda dan klik Simpan untuk menerapkan perubahan guna melihat cara kerjanya di ekosistem Google Home.
Mengimpor dan Mengekspor perangkat virtual
Untuk memecahkan atau mereproduksi masalah, Anda dapat mengekspor perangkat virtual beserta statusnya ke suatu file, dan membagikan file tersebut kepada orang lain untuk mengimpor serta mereplikasi perangkat virtual Anda.
Mengekspor perangkat virtual ke file
- Klik untuk mengekspor perangkat virtual ke file.
- Masukkan nama file yang ingin diekspor, lalu klik Oke.
- Setelah Anda memasukkan nama file, browser akan mendownload file perangkat virtual yang diekspor.
Mengimpor perangkat virtual dari file
- Klik untuk mengimpor perangkat virtual dari sebuah file.
- Pilih file yang ingin Anda impor, lalu klik Oke.
- Setelah Anda mengonfirmasi file yang akan diimpor, Google Home Playground akan mengimpor perangkat virtual dengan status dari file tersebut, serta 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 ke Home Graph. Interaksi dengan Home Graph dicatat ke panel Area log, tempat Anda dapat memperluas 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 dokumentasi referensi untuk mengetahui format setiap metode. |
response |
object |
Isi respons panggilan API Home Graph. Lihat dokumentasi referensi dokumentasi referensi untuk mengetahui format setiap metode. |
Lihat jenis dan karakteristik perangkat yang didukung
Ikon bantuan tanda tanya di kanan atas akan menampilkan jenis perangkat dan daftar fitur saat ini yang didukung oleh Google Home Playground.
Laporkan masalah
Kami ingin mendengar pendapat Anda. Laporkan masalah yang ditemukan menggunakan ikon tanda seru masukan di kanan atas.