Skema Trait Adegan Smart Home

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

Lihat Panduan jenis suasana untuk informasi selengkapnya.

Misalnya, jika perangkat mengizinkan pengguna mengonfigurasi pengelompokan perintah dengan satu sentuhan, seperti menyetel lampu ke warna tertentu, atau mengurutkan berbagai fitur keamanan, atau kombinasi aktivitas lainnya, konfigurasi ini dapat ditampilkan melalui SYNC sebagai scene bernama, dan Asisten akan membuat suasana ini tersedia bagi pengguna melalui tata bahasa aktivasi sederhana:

  • Mulai Mode Pesta.
  • Aktifkan suasana tengah malam.

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

  • Mulai berpesta 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 lagi untuk lampu, mode Aktifkan pesta akan memicu keduanya.

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

Scene harus selalu memiliki nama yang diberikan pengguna, bukan penamaan "BobCo Scene" default. Setiap scene adalah perangkat virtualnya sendiri, dengan namanya sendiri. Nama yang diberikan pengguna mungkin 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: 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 (true).

Contoh

Perangkat yang mendukung scene yang dapat diurungkan.

{
  "sceneReversible": true
}

Perangkat STATES

Tidak ada.

PERINTAH 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 scene jika dapat dibatalkan, false untuk mengaktifkan scene.

Contoh

Aktifkan scene berdasarkan 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.