Selamat datang di Pusat Developer Google Home, tempat baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Skema Atribut Layar Smart Home

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

Lihat panduan Jenis scene untuk informasi selengkapnya.

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

  • Mulai Mode Pesta.
  • Aktifkan scene 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.

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

Adegan akan berinteraksi dengan baik dengan Tindakan Pribadi yang akan datang 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 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 Type Deskripsi
sceneReversible Boolean

(Default: false)

Menunjukkan bahwa tampilan 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 reversibel.

{
  "sceneReversible": true
}

STATE 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 fulfillment intent.

action.devices.commands.ActivateScene

Mengaktifkan atau menonaktifkan suasana.

Parameter

Parameter Type Deskripsi
deactivate Boolean

Wajib.

Benar untuk membatalkan scene jika dapat dibalik, false untuk mengaktifkan scene.

Contoh

Aktifkan scene dengan nama.

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

Menonaktifkan adegan berdasarkan nama.

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

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.