Panduan Mode Smart Home
action.devices.types.SCENE - Untuk scene, jenis ini memetakan 1:1 ke fitur, karena scene tidak akan digabungkan dengan karakteristik lain untuk membentuk perangkat gabungan. Scene harus selalu memiliki nama yang disediakan pengguna. Setiap scene adalah perangkat virtualnya sendiri, dengan namanya sendiri.
Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Scene dan beberapa sinonim dan alias yang terkait.
Lihat fitur Scene untuk informasi selengkapnya.
Kemampuan perangkat
Lihat dokumentasi karakteristik yang sesuai untuk detail implementasi, seperti atribut dan status yang harus didukung oleh layanan Anda, serta cara membuat respons EXECUTE dan QUERY.
Sifat yang diperlukan
Sifat dan perintah ini diperlukan, jika berlaku untuk perangkat Anda.
Persyaratan kualitas
- Latensi: harus kurang dari atau sama dengan 3000ms.
- Keandalan: harus lebih dari atau sama dengan 97%.
Contoh perangkat: Adegan sederhana
Bagian ini berisi contoh payload intent yang merepresentasikan "Scene" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus karakteristik dalam implementasi, ubah respons agar sesuai dengan perubahan tersebut.
Contoh respons SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.SCENE",
"traits": [
"action.devices.traits.Scene"
],
"name": {
"name": "Simple scene"
},
"willReportState": true,
"attributes": {
"sceneReversible": true
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Contoh respons QUERY
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true
}
}
}
}
Contoh perintah EXECUTE
AktifkanScene
Untuk detail tambahan tentang parameter perintah, lihat referensi
action.devices.traits.Scene.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.ActivateScene",
"params": {
"deactivate": false
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true
}
}
]
}
}