สคีมาแบบปิดของบ้านอัจฉริยะ
action.devices.traits.OpenClose
- ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการเปิดและปิด และในบางกรณีก็อาจทําให้เปิดและปิดได้บางส่วนหรืออาจมีมากกว่า 1 ทิศทาง
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
discreteOnlyOpenClose |
บูลีน |
(ค่าเริ่มต้น: เมื่อตั้งค่าเป็น "จริง" ข้อมูลนี้บ่งชี้ว่าอุปกรณ์ต้องเปิดหรือปิดทั้งหมด (กล่าวคือ ไม่รองรับค่าระหว่าง 0% ถึง 100%) |
openDirection |
อาร์เรย์ |
รายการเส้นทางที่รองรับซึ่งอุปกรณ์เปิดหรือปิดได้ รวมแอตทริบิวต์นี้หากอุปกรณ์รองรับการเปิดหรือปิดในทิศทางมากกว่า 1 ทิศทาง |
[item, ...] |
สตริง |
ทิศทางที่รองรับ ค่าที่รองรับมีดังต่อไปนี้
|
commandOnlyOpenClose |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้ |
queryOnlyOpenClose |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าค้นหาอุปกรณ์ได้เฉพาะข้อมูลสถานะเท่านั้นและควบคุมไม่ได้ เซ็นเซอร์ที่รายงานได้เฉพาะสถานะเปิดควรตั้งค่าช่องนี้เป็น "จริง" |
ตัวอย่าง
อุปกรณ์เปิดได้ง่าย
{ "discreteOnlyOpenClose": true }
อุปกรณ์แบบเลื่อนลงจากบนลงล่าง เปิดได้ตลอดทิศทาง
{ "openDirection": [ "UP", "DOWN" ] }
อุปกรณ์คําสั่งเท่านั้น
{ "commandOnlyOpenClose": false }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
เพย์โหลดมีองค์ประกอบอย่างใดอย่างหนึ่งต่อไปนี้
การเปิดทางเดียวแบบปิด
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
openPercent |
Number |
ต้องระบุ ระบุเปอร์เซ็นต์ที่มีการเปิดอุปกรณ์โดยที่ 0 ปิดและ 100 เปิดอยู่โดยสมบูรณ์ |
เปิดหรือปิดหลายทิศทาง
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
openState |
อาร์เรย์ |
ต้องระบุ รายชื่อรัฐสําหรับแต่ละทิศทางแบบเปิดที่รองรับ |
[item, ...] |
วัตถุ |
สถานะปัจจุบันของเส้นทางแบบเปิด |
openPercent |
Number |
ต้องระบุ ระบุเปอร์เซ็นต์ที่มีการเปิดอุปกรณ์โดยที่ 0 ปิดและ 100 เปิดอยู่โดยสมบูรณ์ |
openDirection |
สตริง |
ต้องระบุ ทิศทางที่อุปกรณ์เปิด ค่าที่รองรับมีดังต่อไปนี้
|
ตัวอย่าง
อุปกรณ์เปิดได้ง่าย
{ "openPercent": 100 }
เปิดอุปกรณ์ 30% ในทิศทางลง และ 50% อยู่ในทิศทางขึ้น
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
คําสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
ได้ที่การดําเนินการตามความตั้งใจ
action.devices.commands.OpenClose
ตั้งค่าสถานะการเปิดของอุปกรณ์
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
openPercent |
Number |
ต้องระบุ ระบุเปอร์เซ็นต์ที่มีการเปิดอุปกรณ์โดยที่ 0 ปิดและ 100 เปิดอยู่โดยสมบูรณ์ |
openDirection |
สตริง |
ทิศทางที่จะเปิด แสดงเมื่ออุปกรณ์รองรับหลายเส้นทางเท่านั้น ตามที่แอตทริบิวต์ ค่าที่รองรับมีดังต่อไปนี้
|
followUpToken |
สตริง |
โทเค็นที่ Google มีให้สําหรับการตอบกลับติดตามผล |
ตัวอย่าง
เปิดอุปกรณ์
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
เปิดอุปกรณ์ลง 50 เปอร์เซ็นต์
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดขณะตั้งสถานะแบบเปิดของอุปกรณ์
ค่าที่รองรับมีดังต่อไปนี้
lockedState
deviceJammingDetected
การตอบกลับติดตามผล
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจแสดงผลเพย์โหลดการตอบกลับติดตามผลต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานการตอบกลับติดตามผลได้ที่การแจ้งเตือนสําหรับการดําเนินการในบ้านอัจฉริยะ
เพย์โหลดมีองค์ประกอบอย่างใดอย่างหนึ่งต่อไปนี้
สำเร็จ
ช่อง | ประเภท | คำอธิบาย |
---|---|---|
followUpToken |
สตริง |
ต้องระบุ โทเค็นที่ระบุในคําขอ EXECUTE เดิม |
status |
สตริง |
ต้องระบุ ผลลัพธ์ของคําขอ ค่าที่รองรับมีดังต่อไปนี้
|
openPercent |
Number |
ต้องระบุ ระบุเปอร์เซ็นต์ของอุปกรณ์ที่เปิดว่า 0 คือปิดแล้ว และ 100 เปิดอยู่เต็ม |
ล้มเหลว
ช่อง | ประเภท | คำอธิบาย |
---|---|---|
followUpToken |
สตริง |
ต้องระบุ โทเค็นที่ระบุในคําขอ EXECUTE เดิม |
status |
สตริง |
ต้องระบุ ผลลัพธ์ของคําขอ ค่าที่รองรับมีดังต่อไปนี้
|
errorCode |
สตริง |
ต้องระบุ ค่านี้อาจเป็นรหัสข้อผิดพลาดสําหรับลักษณะนี้ เช่น |
ตัวอย่าง
เปิดประตูโรงรถ (การตอบกลับติดตามผลสําหรับกรณีที่สําเร็จ)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
เปิดประตูโรงรถ (การตอบกลับติดตามผลสําหรับกรณีความล้มเหลว)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
ปรับสถานะปิดของอุปกรณ์ที่สัมพันธ์กับสถานะปัจจุบัน คําสั่งนี้จะใช้ได้เฉพาะเมื่อตั้งค่า commandOnlyOpenClose
เป็น false
เท่านั้น
{ "commandOnlyOpenClose": false }
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
openRelativePercent |
Number |
ต้องระบุ เปอร์เซ็นต์ที่แน่นอนเพื่อเปลี่ยนสถานะแบบเปิด ระบบจะแปลงคําสั่งสัมพัทธ์ขนาดใหญ่เป็นพารามิเตอร์เปอร์เซ็นต์ที่แน่นอน (เช่น "เปิดมู่ลี่อีกเล็กน้อย" เทียบกับ "เปิดมู่ลี่ 5%") |
openDirection |
สตริง |
ทิศทางที่จะเปิด แสดงเมื่ออุปกรณ์รองรับหลายเส้นทางเท่านั้น ตามที่แอตทริบิวต์ ค่าที่รองรับมีดังต่อไปนี้
|
ตัวอย่าง
เปิดอุปกรณ์อีกเล็กน้อย
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
ปิดอุปกรณ์อีก 10%
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
เปิดอุปกรณ์ลง 50% ลง
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
ข้อผิดพลาดที่เกี่ยวข้อง
เกิดข้อผิดพลาดขณะตั้งสถานะแบบเปิดของอุปกรณ์
ค่าที่รองรับมีดังต่อไปนี้
lockedState
deviceJammingDetected
ตัวอย่างเสียงพูด
de-DE
-
Bitte öffne
die Jalousien auf30% -
Fensterläden um25 % schliessen -
Ist
die Jalousie zu? -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Are
the blinds in the kitchen open -
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 -
está abierta
la puerta -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
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 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% -
è 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 voor25% dicht -
doe
het raam ietsje meer dicht -
is
de voordeur open -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% 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 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 -
är
ytterdörren öppen? -
öppna
persiennerna med25%