Skema Properti OpenClose Smart Home
action.devices.traits.OpenClose
- Sifat ini termasuk perangkat yang mendukung aktivitas membuka dan menutup, serta dalam kasus tertentu membuka dan menutup sebagian atau berpotensi di lebih dari satu arah.
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 |
---|---|---|
discreteOnlyOpenClose |
Boolean |
(Default: Jika disetel ke benar (true), ini akan menunjukkan bahwa perangkat harus terbuka sepenuhnya atau tertutup sepenuhnya (artinya, tidak mendukung nilai antara 0% dan 100%). |
openDirection |
Array |
Daftar rute yang didukung yang dapat dibuka atau ditutup oleh perangkat. Sertakan atribut ini jika perangkat mendukung pembukaan dan penutupan di lebih dari satu arah. |
[item, ...] |
String |
Arah yang didukung. Nilai yang didukung:
|
commandOnlyOpenClose |
Boolean |
(Default: Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk fitur ini. |
queryOnlyOpenClose |
Boolean |
(Default: Menunjukkan apakah perangkat hanya dapat dikueri untuk informasi status dan tidak dapat dikontrol. Sensor yang hanya dapat melaporkan status terbuka harus menetapkan kolom ini ke true (benar). |
Contoh
Perangkat buka-tutup yang sederhana.
{ "discreteOnlyOpenClose": true }
Perangkat dari atas ke bawah. Dapat dibuka di kedua arah.
{ "openDirection": [ "UP", "DOWN" ] }
Perangkat khusus perintah.
{ "commandOnlyOpenClose": true }
STATUS Perangkat
Perangkat dengan karakteristik ini dapat melaporkan status berikut
sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
fulfillment intent.
Payload berisi salah satu dari hal berikut:
Menutup satu arah
Negara bagian | Jenis | Deskripsi |
---|---|---|
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka penuh. |
Buka di beberapa arah
Negara bagian | Jenis | Deskripsi |
---|---|---|
openState |
Array |
Wajib. Daftar status untuk setiap arah terbuka yang didukung. |
[item, ...] |
Objek |
Status saat ini untuk arah terbuka yang diberikan. |
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka penuh. |
openDirection |
String |
Wajib. Arah perangkat dibuka. Nilai yang didukung:
|
Contoh
Perangkat buka-tutup yang sederhana.
{ "openPercent": 100 }
Buka perangkat sebesar 30% ke arah bawah, dan sebesar 50% ke atas.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
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.OpenClose
Menetapkan status buka-tutup perangkat.
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka penuh. |
openDirection |
String |
Arah pembukaan. Hanya muncul jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut Nilai yang didukung:
|
followUpToken |
String |
Token yang disediakan Google untuk respons tindak lanjut. |
Contoh
Buka perangkat.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
Buka perangkat dengan diskon 50 persen.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Error terkait
Terjadi error saat menyetel status buka-tutup perangkat.
Nilai yang didukung:
lockedState
deviceJammingDetected
Respons tindak lanjut
Perangkat dengan karakteristik ini dapat menampilkan payload respons tindak lanjut berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
cara menerapkan respons tindak lanjut lebih lanjut, lihat
Notifikasi untuk Action smart home.
Payload berisi salah satu dari hal berikut:
Berhasil
Kolom | Jenis | Deskripsi |
---|---|---|
followUpToken |
String |
Wajib. Token disediakan dalam permintaan EXECUTE asli. |
status |
String |
Wajib. Hasil permintaan. Nilai yang didukung:
|
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat dibuka saat 0 tertutup dan 100 terbuka penuh. |
Kegagalan
Kolom | Jenis | Deskripsi |
---|---|---|
followUpToken |
String |
Wajib. Token disediakan dalam permintaan EXECUTE asli. |
status |
String |
Wajib. Hasil permintaan. Nilai yang didukung:
|
errorCode |
String |
Wajib. Nilainya dapat berupa kode error untuk sifat ini, misalnya, |
Contoh
Buka pintu garasi. (tindak lanjut untuk kasus yang berhasil)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Buka pintu garasi. (tindak lanjut untuk kasus kegagalan)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Menyesuaikan status buka-tutup perangkat relatif terhadap status saat ini. Perintah ini hanya tersedia jika commandOnlyOpenClose
ditetapkan ke true
.
{ "commandOnlyOpenClose": true }
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
openRelativePercent |
Number |
Wajib. Persentase yang tepat untuk mengubah status buka-tutup. Perintah relatif yang besar akan dikonversi ke parameter persentase yang tepat (misalnya, "Buka tirai lebih banyak" vs "Buka tirai sebesar 5%"). |
openDirection |
String |
Arah pembukaan. Hanya muncul jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut Nilai yang didukung:
|
Contoh
Buka perangkat sedikit lebih banyak
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Tutup perangkat 10% lebih banyak
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Buka perangkat 50% lebih banyak, ke bawah.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Error terkait
Terjadi error saat menyetel status buka-tutup perangkat.
Nilai yang didukung:
lockedState
deviceJammingDetected
Contoh ucapan
de-DE
-
Bitte öffne
die Jalousien auf30% -
Fensterläden um25 % schliessen -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
ferme
les stores -
ferme
un peu les stores -
ouvre
les stores -
ouvre
les stores de la chambre de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25%
ja-JP
-
25% にブラインド を開けて -
25% ブラインド を閉めてください -
25% ブラインド 開けて -
ブラインド 閉めて -
ブラインド 開けて -
少し ブラインド を閉じて
ko-KR
-
문 살짝만 닫아 줘 -
블라인드 25% 열어 줘 -
블라인드 25% 까지 열어 줘 -
블라인드 30프로 닫아 -
블라인드 닫아 줘 -
블라인드 열어 줘
nl-NL
-
doe
de gordijnen 25% open -
doe
de jaloezieën voor25% dicht -
doe
het raam ietsje meer dicht -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% open
pt-BR
-
Abrir
janela 50% -
Fecha
a persiana toda -
Fechar
a janela 10% -
abra
a persiana até30% -
abre
as cortinas -
abre
as cortinas a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
öppna
persiennerna med25%