Skema Sifat Smart Home Scene
action.devices.traits.Scene
- Sifat ini digunakan untuk menerapkan perangkat virtual bersama dengan jenis perangkat SCENE.
Lihat Panduan jenis tampilan untuk 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
diekspos melalui SYNC
sebagai scene bernama, dan Asisten akan membuat
scene ini tersedia bagi pengguna melalui tata bahasa aktivasi sederhana:
- Mulai Mode Pesta.
- Aktifkan suasana tengah malam.
Sebagai objek virtual, scene dapat ditempatkan dalam ruang (jika relevan) untuk disambiguasi:
- Mulai pesta di dapur.
- Aktifkan mode malam di kamar tidur.
Satu perbedaan antara scene dan target fisik adalah bahwa Asisten akan otomatis menerapkan efek jamak pada perintah Scene, yang memungkinkan pengguna memicu scene di beberapa partner. Misalnya, jika pengguna memiliki tampilan "mode pesta" pada dua partner yang berbeda, satu untuk keamanan dan satu untuk lampu, Aktifkan mode pesta akan memicu keduanya.
Adegan akan berinteraksi dengan Action Pribadi mendatang untuk tata bahasa kustom (misalnya, Aktifkan Mode Pesta -> Mari mulai berpesta!).
Scene harus selalu memiliki nama yang disediakan pengguna dibandingkan dengan nama
"BobCo Scene"
default. Setiap scene 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
fulfillment intent.
Atribut | Jenis | Deskripsi |
---|---|---|
sceneReversible |
Boolean |
(Default: Menunjukkan bahwa scene ini dapat dibatalkan. Atribut ini hanya relevan untuk scene yang mengubah status dan mengingat status sebelumnya. Perangkat mendukung perintah |
Contoh
Perangkat yang mendukung scene yang dapat dibatalkan.
{ "sceneReversible": true }
STATUS Perangkat
Tidak ada.
COMMAND Perangkat
Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
penanganan intent EXECUTE
lebih lanjut, lihat
fulfillment intent.
action.devices.commands.ActivateScene
Mengaktifkan atau menonaktifkan suasana.
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
deactivate |
Boolean |
Wajib. True untuk membatalkan adegan jika dapat dibatalkan, false untuk mengaktifkan scene. |
Contoh
Aktifkan scene berdasarkan nama.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Menonaktifkan adegan menurut nama.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }