Skema Trait OpenClose Smart Home
action.devices.traits.OpenClose
- Sifat ini milik perangkat yang mendukung tindakan membuka dan menutup, dan dalam beberapa kasus, membuka dan menutup sebagian atau berpotensi dengan lebih dari satu arah.
ATTRIBUTES Perangkat
Perangkat dengan karakteristik ini mungkin melaporkan hal berikut
sebagai bagian dari operasi SYNC
. Untuk mempelajari
selengkapnya tentang menangani intent SYNC
, lihat
Pemenuhan intent.
Atribut | Jenis | Deskripsi |
---|---|---|
discreteOnlyOpenClose |
Boolean |
(Default: Jika disetel ke benar (true), berarti perangkat harus terbuka sepenuhnya atau tertutup sepenuhnya (artinya, perangkat tidak mendukung nilai antara 0% dan 100%). |
openDirection |
Array |
Daftar rute yang didukung yang dapat digunakan perangkat untuk membuka atau menutup. 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 karakteristik ini. |
queryOnlyOpenClose |
Boolean |
(Default: Menunjukkan apakah perangkat hanya bisa dikueri informasi status dan tidak dapat dikontrol. Sensor yang hanya dapat melaporkan status terbuka harus menetapkan kolom ini ke true. |
Contoh
Perangkat sederhana yang dapat ditutup.
{ "discreteOnlyOpenClose": true }
Perangkat vertikal dari bawah ke atas. Dapat dibuka di kedua arah.
{ "openDirection": [ "UP", "DOWN" ] }
Perangkat khusus perintah.
{ "commandOnlyOpenClose": false }
NEGARA Perangkat
Entitas dengan karakteristik ini dapat melaporkan hal berikut
status sebagai bagian dari operasi QUERY
. Untuk mempelajari
selengkapnya tentang menangani intent QUERY
, lihat
Pemenuhan intent.
Payload berisi salah satu hal berikut:
Buka-tutup satu arah
Negara bagian | Jenis | Deskripsi |
---|---|---|
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat yang dibuka, yang mana 0 ditutup dan 100 adalah sepenuhnya terbuka. |
targetOpenPercent |
Number |
Level yang menunjukkan persentase terbuka tempat perangkat akan pergi atau berpindah sebagai akibat dari perubahan posisi yang sedang berlangsung. |
Buka-tutup 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 ditentukan. |
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat yang dibuka, yang mana 0 ditutup dan 100 adalah sepenuhnya terbuka. |
targetOpenPercent |
Number |
Level yang menunjukkan persentase terbuka tempat perangkat akan pergi atau berpindah sebagai akibat dari perubahan posisi yang sedang berlangsung. |
openDirection |
String |
Wajib. Arah perangkat dibuka. Nilai yang didukung:
|
Contoh
Perangkat sederhana yang dapat ditutup.
{ "openPercent": 100 }
Perangkat sederhana dengan sistem buka-tutup, saat ini membuka ke posisi baru.
{ "openPercent": 50, "targetOpenPercent": 100 }
Buka perangkat sebesar 30% ke arah bawah, dan 50% ke arah atas.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
Buka perangkat sebesar 30% ke arah bawah, dan 50% ke arah atas, saat ini bergerak ke 80% ke arah atas.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "targetOpenPercent": 80, "openDirection": "UP" } ] }
Perangkat COMMANDS
Perangkat dengan karakteristik ini dapat merespons hal berikut
sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
selengkapnya tentang menangani intent EXECUTE
, lihat
Pemenuhan intent.
action.devices.commands.OpenClose
Menyetel status buka-tutup perangkat.
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat yang dibuka, yang mana 0 ditutup dan 100 adalah sepenuhnya terbuka. |
openDirection |
String |
Arah yang akan dibuka. Hanya ada 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 50 persen ke bawah.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Error terkait
Terjadi error saat menetapkan status buka-tutup perangkat.
Nilai yang didukung:
lockedState
deviceJammingDetected
Respons selanjutnya
Perangkat dengan karakteristik ini dapat menampilkan hal berikut
payload respons tindak lanjut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
selengkapnya tentang menerapkan tanggapan tindak lanjut, lihat
Notifikasi untuk Action smart home.
Payload berisi salah satu hal berikut:
Berhasil
Kolom | Jenis | Deskripsi |
---|---|---|
followUpToken |
String |
Wajib. Token yang diberikan dalam permintaan EXECUTE asli. |
status |
String |
Wajib. Hasil permintaan. Nilai yang didukung:
|
openPercent |
Number |
Wajib. Menunjukkan persentase perangkat dibuka dalam kondisi 0 ditutup dan 100 terbuka sepenuhnya. |
Gagal
Kolom | Jenis | Deskripsi |
---|---|---|
followUpToken |
String |
Wajib. Token yang diberikan dalam permintaan EXECUTE asli. |
status |
String |
Wajib. Hasil permintaan. Nilai yang didukung:
|
errorCode |
String |
Wajib. Nilainya dapat berupa kode error untuk fitur ini, misalnya, |
Contoh
Buka pintu garasi. (respons tindak lanjut untuk kasus berhasil)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Buka pintu garasi. (respons 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
disetel ke false
.
{ "commandOnlyOpenClose": false }
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
openRelativePercent |
Number |
Wajib. Persentase persis untuk mengubah status buka tertutup. Perintah relatif yang ambigu akan dikonversi menjadi parameter persentase yang tepat (misalnya, "Buka tirai lebih banyak lagi" vs "Buka tirai sebesar 5%"). |
openDirection |
String |
Arah yang akan dibuka. Hanya ada jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut Nilai yang didukung:
|
Contoh
Buka perangkat lebih lama
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Menutup 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 menetapkan status buka-tutup perangkat.
Nilai yang didukung:
lockedState
deviceJammingDetected
Contoh ucapan
de-DE
- Bitte öffne die Jalousien auf 30%
- Fensterläden um 25 % schliessen
- Ist die Jalousie zu?
- Mach den Rollladen zu
- Mach die Rollos auf
- schließe die Rollläden ein bisschen mehr
- Öffne die Jalousien um 25%
en-US
- Are the blinds in the kitchen open
- Close the blinds 25% in my room
- Close the door more
- Just close the front door
- open the blinds in my room
- open the blinds to 25%
- open the door by 25%
es-ES
- abre la ventana del salón
- cerrar persianas del dormitorio un 20%
- cierra la cortina del salón
- cierra mucho más la ventana
- está abierta la puerta
- quiero que subas la persiana al 25%
- sube un 20% las persianas
fr-FR
- baisse les stores de 10%
- est-ce que la porte d'entrée est ouverte
- ferme les stores
- ferme un peu les stores
- ouvre les stores
- ouvre les stores de la chambre de 25%
- ouvre les stores à 25%
hi-IN
- कृपया 25% पर्दे को खुला रखो
- क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
- पर्दे को 25% बंद करोगे
- पर्दे खोलो
- ब्लाइंड 25% खुले पर सेट कर दीजिए
- ब्लाइंड को थोड़ा और बंद कर दिजिए
- ब्लाइंड बंद करें
it-IT
- abbassa un po' di più le tapparelle
- apri la serranda
- apri la tapparella al 30%
- apri le serrande del 30%
- chiudi le serrande
- chiudi le tende del 25%
- è aperta la porta d'ingresso
ja-JP
- 25% に ブラインド を開けて
- 25% ブラインド を閉めてください
- 25% ブラインド 開けて
- ブラインド 閉めて
- ブラインド 開けて
- 少し ブラインド を閉じて
- 玄関のドア は開いてますか
ko-KR
- 문 살짝만 닫아 줘
- 블라인드 25% 열어 줘
- 블라인드 25% 까지 열어 줘
- 블라인드 30프로 닫아
- 블라인드 닫아 줘
- 블라인드 열어 줘
- 안방 문 열렸어
nl-NL
- doe de gordijnen 25% open
- doe de jaloezieën voor 25% dicht
- doe het raam ietsje meer dicht
- is de voordeur open
- open de gordijnen
- sluit het gordijn
- zet de luxaflex voor 50% open
pt-BR
- Abrir janela 50%
- As cortinas estão abertas?
- Fecha a persiana toda
- Fechar a janela 10%
- a cortina do quarto está aberta?
- abra a persiana até 30%
- abre as cortinas
- abre as cortinas a 50%
- abrir as cortinas
- abrir as cortinas na sala em 30%
- fecha a persiana por favor
- fecha um bocado a janela
- fechar as cortinas em 25%
- fechar um pouco mais as cortinas
sv-SE
- Dra upp persiennerna
- Dra upp persiennerna till 25%
- stäng persiennen i mitt rum 25%
- stäng persiennerna
- är ytterdörren öppen?
- öppna persiennerna med 25%