Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Atribut Scene Smart Home

action.devices.traits.Scene - Sifat ini digunakan untuk mengimplementasikan perangkat virtual bersama dengan jenis perangkat SCENE.

Lihat Panduan jenis tampilan untuk informasi selengkapnya.

Misalnya, jika perangkat memungkinkan pengguna mengonfigurasi pengelompokan perintah dengan satu sentuhan — menyetel lampu ke warna tertentu, atau mengurutkan berbagai fitur keamanan, atau kombinasi aktivitas lainnya — konfigurasi ini dapat diekspos melalui SYNC sebagai adegan bernama, dan Asisten akan menyediakan layar ini kepada pengguna melalui tata bahasa aktivasi sederhana:

  • Mulai Mode Pesta.
  • Aktifkan suasana tengah malam.

Sebagai objek virtual, scene dapat ditempatkan di ruang (jika relevan) untuk disambiguasi:

  • Mulai pesta di dapur.
  • Aktifkan mode cahaya malam di kamar tidur.

Satu perbedaan antara scene dan target fisik adalah bahwa Asisten akan otomatis menerapkan efek jamak ke perintah Scene, yang memungkinkan pengguna memicu adegan di beberapa partner. Misalnya, jika pengguna memiliki scene "mode pesta" di dua partner yang berbeda, satu untuk keamanan dan satu untuk lampu, Aktifkan mode pesta akan memicu keduanya.

Adegan akan berinteraksi dengan Tindakan Pribadi mendatang untuk tata bahasa kustom (misalnya, Aktifkan Mode Pesta -> Ayo mulai berpesta!).

Scene harus selalu memiliki nama yang diberikan pengguna versus penamaan "BobCo Scene" default. Setiap adegan adalah perangkat virtualnya sendiri, dengan namanya sendiri. Nama yang diberikan pengguna dapat berasal dari SYNC.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat Penjelasan intent.

Atribut Jenis Deskripsi
sceneReversible Boolean

(Default: false)

Menunjukkan bahwa scene ini dapat dibatalkan. Atribut ini hanya relevan untuk adegan yang mengubah status dan mengingat status sebelumnya. Perangkat mendukung perintah ActivateScene dengan parameter deactivate ke true.

Contoh

Perangkat yang mendukung scene reversibel.

{
  "sceneReversible": true
}

STATUS Perangkat

Tidak ada.

PERMINTAAN Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat Penjelasan intent.

action.devices.commands.ActivateScene

Mengaktifkan atau menonaktifkan adegan.

Parameter

Parameter Jenis Deskripsi
deactivate Boolean

Wajib.

Benar untuk membatalkan adegan jika dapat dibalik, salah untuk mengaktifkan adegan.

Contoh

Aktifkan scene menurut nama.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Menonaktifkan scene menurut nama.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.