Selamat datang di Pusat Developer Google Home, tempat baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Taman Bermain Google Home

SDK Perangkat

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 serta status perangkat, melihat perangkat ini di Google Home Graph, dan mengimpor atau mengekspor konfigurasi perangkat.

Penautan akun selesai

Untuk menggunakan Google Home Playground, sebaiknya tautkan alat tersebut ke akun Anda terlebih dahulu. Buka Google Home app (GHA) di ponsel, lalu lakukan proses penautan akun:

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

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

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

Login

Luncurkan Google Home Playground dengan mengklik tombol di bawah ini:

Meluncurkan Playground

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

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

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

Gambar ini menampilkan 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 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 Google Home Playground dan Home Graph. Anda dapat memperluas log untuk memeriksa payload permintaan dan respons untuk pemecahan masalah.

Perangkat virtual

Lihat info perangkat virtual

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

  • Informasi dasar: properti tingkat atas perangkat, termasuk jenis, ID, dan nama perangkat.
  • Fitur: karakteristik perangkat yang didukung.
  • Atribut: atribut khusus karakteristik perangkat.
  • Status: semua status perangkat.
  • SUV: Konfigurasi Verifikasi Pengguna Kedua perangkat.

Edit info perangkat virtual

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

Mengubah karakteristik yang didukung

  1. Pilih tab Traits; klik tombol Edit.
  2. Di panel pop-up, Anda dapat melihat karakteristik perangkat yang saat ini didukung, dan fitur yang tersedia untuk ditambahkan. Gunakan tombol arrow (arrow_forward/arrow_back) untuk menambahkan atau menghapus karakteristik yang didukung untuk perangkat.
  3. Setelah selesai mengupdate karakteristik yang didukung, klik Save, lalu fitur yang diupdate akan diterapkan ke Home Graph.
  4. Anda dapat melihat update fitur ini di Area log.
Gambar ini menunjukkan alat UX untuk menambahkan atau menghapus karakteristik yang didukung pada perangkat yang dipilih di Google Home Playground.

Mengubah atribut perangkat

  1. Pilih tab Attributes, dan edit atribut untuk fitur yang didukung perangkat.
  2. Setelah selesai mengedit, tekan Enter dan perubahan atribut akan diterapkan ke Home Graph.
  3. Anda dapat melihat atribut yang diperbarui ini di area Log.

Mengubah status perangkat

  1. Pilih tab States dan edit status secara langsung. Perubahan status akan diterapkan pada 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 mengonfigurasi jenis tantangannya serta perilaku yang sesuai di setiap perangkat. Anda dapat menambahkan SUV ke perangkat virtual dan mengonfigurasi jenis tantangannya serta perilaku yang sesuai di setiap perangkat.

Konfigurasi 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 (tidak ada tantangan) di perangkat.
    • Jenis tantangan: apakah SUV memerlukan konfirmasi eksplisit (ackPerlued) atau nomor identifikasi pribadi (pinNeeded).
    • PIN: PIN yang valid.
    • Penanganan PIN yang salah: jika PIN salah, apakah akan bertanya kepada pengguna lagi dan, jika tidak, error untuk merespons.
Gambar ini menunjukkan alat UX untuk mengaktifkan karakteristik verifikasi pengguna sekunder pada perangkat yang dipilih di Google Home Playground.

Mengidentifikasi perangkat yang mengaktifkan SUV

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

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

Daftar karakteristik berikut memerlukan SUV:

Membuat perangkat virtual baru

  1. Di panel Daftar perangkat, klik Tambahkan perangkat.
  2. Di panel pop-up, pilih jenis perangkat dan masukkan nama perangkat untuk perangkat baru Anda. Atau, Anda dapat memilih rangkaian perangkat yang telah ditetapkan 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.

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 tempat 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 alat 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 dan klik Simpan untuk menerapkan perubahan untuk melihat cara kerjanya di ekosistem Google Home.

Gambar ini menampilkan jendela untuk mengedit respons sinkronisasi.

Impor dan Ekspor 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 serta mereplikasi perangkat virtual Anda.

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

Mengekspor perangkat virtual ke file

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

Mengimpor perangkat virtual dari file

  1. Klik untuk mengimpor perangkat virtual dari file.
  2. Pilih file yang ingin Anda impor, lalu klik OK.
  3. Setelah Anda mengonfirmasi file untuk 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 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 dari struktur berikut:

{
  "uri": string,
  "request": object,
  "response": object
}
Kolom Type 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.

Melihat jenis dan karakteristik perangkat yang didukung

Ikon bantuan tanda tanya di kanan atas akan menampilkan jenis perangkat dan daftar karakteristik saat ini 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 pendapat Anda. Laporkan masalah menggunakan masukan ikon tanda seru di kanan atas.

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