Skema Sifat Scene Smart Home

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

Lihat Panduan jenis scene untuk mengetahui informasi selengkapnya.

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

  • Mulai Mode Pesta.
  • Aktifkan suasana tengah malam.

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

  • Mulai suasana resepsi di dapur.
  • Aktifkan mode lampu tidur di kamar tidur.

Satu perbedaan antara scene dan target fisik adalah Asisten akan otomatis menerapkan efek jamak ke perintah Scene, sehingga pengguna dapat memicu scene 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.

Scene akan berinteraksi dengan baik dengan Personal Actions mendatang untuk tata bahasa kustom (misalnya, Aktifkan Mode Pesta -> Mari kita mulai pestanya!).

Scene harus selalu memiliki nama yang diberikan pengguna, bukan penamaan "BobCo Scene" default. Setiap tampilan 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 lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
sceneReversible Boolean

(Default: false)

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

Contoh

Perangkat yang mendukung scene yang dapat dibalik.

{
  "sceneReversible": true
}

Status PERANGKAT

Tidak ada.

Perintah Perangkat

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

action.devices.commands.ActivateScene

Mengaktifkan atau menonaktifkan suasana.

Parameter

Parameter Jenis Deskripsi
deactivate Boolean

Wajib.

Benar untuk membatalkan suasana jika dapat dikembalikan, salah untuk mengaktifkan suasana.

Contoh

Mengaktifkan suasana berdasarkan nama.

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

Menonaktifkan suasana berdasarkan nama.

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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.