Skema Trait Scene Smart Home
action.devices.traits.Scene
- Trait ini digunakan untuk menerapkan perangkat virtual bersama dengan jenis perangkat SCENE.
Lihat Panduan jenis scene untuk mengetahui informasi selengkapnya.
Misalnya, jika perangkat mengizinkan pengguna mengonfigurasi pengelompokan perintah
dengan sekali sentuh, 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.
- Mengaktifkan suasana tengah malam.
Sebagai objek virtual, suasana dapat ditempatkan di ruangan (jika relevan) untuk disambiguasi:
- Mulai pesta di dapur.
- Aktifkan mode lampu malam di kamar tidur.
Satu perbedaan antara scene dan target fisik adalah Asisten akan otomatis menerapkan efek jamak ke perintah Scene, yang memungkinkan pengguna 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 pihak akan memicu keduanya.
Adegan akan berinteraksi dengan baik dengan Tindakan Pribadi mendatang untuk tata bahasa kustom (misalnya, Aktifkan Mode Pesta -> Ayo mulai pesta!).
Scene harus selalu memiliki nama yang diberikan pengguna versus penamaan "BobCo Scene"
default. Setiap scene adalah perangkat virtualnya sendiri dengan namanya sendiri.
Nama yang diberikan pengguna mungkin berasal dari SYNC
.
ATTRIBUTE Perangkat
Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
Fulfillment intent.
Atribut | Type | 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 dibalik.
{ "sceneReversible": true }
STATUS Perangkat
Tidak ada.
Perangkat COMMAND
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 | Type | Deskripsi |
---|---|---|
deactivate |
Boolean |
Wajib. True untuk membatalkan scene jika dapat dibatalkan, false untuk mengaktifkan scene. |
Contoh
Aktifkan scene berdasarkan nama.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Menonaktifkan scene berdasarkan nama.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }