Taman Bermain Google Home

API Home    SDK Local Home    cloud-to-cloud

Google Home Playground adalah aplikasi web yang mensimulasikan project smart home dengan jenis dan fitur 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 tautkan alat ini ke akun Anda terlebih dahulu. Buka Google Home app (GHA) di ponsel Anda, lalu ikuti proses penautan akun yang dijelaskan di Menghubungkan perangkat smart home pihak ketiga di aplikasi Google Home.

1. Cari integrasi yang berjudul Google Home Playground.
2. Pilih integrasi, dan GHA akan mengarahkan Anda ke halaman login. Klik Sign in with Google , lalu pilih akun Anda untuk login.
3. Klik tombol Authorize untuk mengotorisasi penautan akun.

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

Login

Luncurkan Google Home Playground dengan mengklik tombol di bawah:

Luncurkan Playground

Klik Sign in with Google. Pastikan untuk login dengan akun yang sama 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:

• Device list menampilkan semua perangkat virtual Anda. Anda dapat memilih perangkat virtual tertentu 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 panel.
• Log area 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 Device info akan menampilkan informasinya yang dikategorikan ke dalam lima tab:

• Basic information: properti tingkat atas perangkat, termasuk jenis, ID, dan nama perangkat.
• Traits: fitur perangkat yang didukung.
• Attributes: atribut khusus fitur perangkat.
• States: semua status perangkat.
• SUV: konfigurasi Verifikasi Tambahan oleh Pengguna dari perangkat.

Mengedit info perangkat virtual

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

Mengubah fitur yang didukung

1. Pilih tab Traits ; 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 fitur yang didukung untuk perangkat.
3. Setelah selesai memperbarui fitur yang didukung, klik Save, dan fitur yang diperbarui akan diterapkan ke Home Graph.
4. Anda dapat melihat pembaruan fitur ini di Log area.

Mengubah atribut perangkat

1. Pilih tab Attributes, lalu edit atribut untuk fitur 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 Log area.

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 Log area.

Menambahkan verifikasi tambahan oleh pengguna 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 serta perilaku yang sesuai di setiap perangkat.

Mengonfigurasi SUV di perangkat

1. Di panel Device list, pilih perangkat virtual yang ingin Anda konfigurasi.
2. Di panel Device info , pilih tab SUV , lalu konfigurasi hal berikut:
   • Diaktifkan: apakah SUV diaktifkan atau dinonaktifkan (tanpa tantangan) di perangkat.
   • Jenis tantangan: apakah SUV memerlukan konfirmasi eksplisit (ackNeeded) atau nomor pengenal pribadi (pinNeeded).
   • PIN: PIN yang valid.
   • Handling of incorrect PIN: jika PIN salah, apakah akan meminta pengguna lagi dan, jika tidak, error yang akan direspons.

Mengidentifikasi perangkat yang mengaktifkan SUV

Di panel Device list, ikon kunci key akan ditampilkan di samping setiap perangkat yang mengaktifkan SUV.

Daftar fitur berikut memerlukan SUV:

• ArmDisarm
• LockUnlock
• OpenClose
• Reboot
• SoftwareUpdate

Membuat perangkat virtual baru

1. Di panel Device list, klik Add a device.
2. Di panel pop-up, pilih jenis perangkat dan masukkan nama perangkat untuk perangkat baru Anda. Atau, Anda dapat memilih kumpulan perangkat yang telah ditentukan untuk ditambahkan.
3. Setelah Anda menyelesaikan semua langkah, perangkat baru akan ditambahkan ke Home Graph.

Menghapus perangkat virtual

1. Di panel Device list, pilih perangkat yang ingin Anda hapus. Kemudian, di panel Device info , pilih tab Basic Information , lalu Kemudian, di panel Device info , pilih tab Basic Information , lalu klik Remove device di bagian bawah.
2. Konfirmasi penghapusan perangkat di pop-up peringatan.
3. Setelah Anda mengonfirmasi penghapusan perangkat, perangkat 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, lalu klik Save untuk menerapkan perubahan guna melihat cara kerjanya di ekosistem Google Home.

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 mengimpor dan mereplikasi perangkat virtual Anda.

Mengekspor perangkat virtual ke file

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

Mengimpor perangkat virtual dari file

1. Klik upload_file untuk mengimpor perangkat virtual dari 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 memperbarui informasi serta 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 Home Graph API.

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

{
  "uri": string,
  "request": object,
  "response": object
}

Melihat jenis dan fitur perangkat yang didukung

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

Melaporkan masalah

Kami ingin mendengar pendapat Anda. Laporkan masalah yang Anda temui menggunakan ikon tanda seru masukan di kanan atas.