สคีมาลักษณะ OpenClose ของ Smart Home

action.devices.traits.OpenClose - ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการเปิดและปิด และในบางกรณีอาจเปิดปิดบางส่วนหรืออาจมากกว่า 1 ทิศทางก็ได้

หมายเหตุ: คุณควรใช้การยืนยันผู้ใช้รองสำหรับลักษณะนี้

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่Fulfillment ความตั้งใจ

Attributes	ประเภท	คำอธิบาย
discreteOnlyOpenClose	บูลีน	(ค่าเริ่มต้น: false) เมื่อตั้งค่าเป็น "จริง" จะบ่งชี้ว่าอุปกรณ์ต้องเปิดหรือปิดอย่างสมบูรณ์ (กล่าวคือไม่รองรับค่าระหว่าง 0% ถึง 100%)
openDirection	อาร์เรย์	รายการเส้นทางที่รองรับซึ่งอุปกรณ์จะเปิดหรือปิดได้ ระบุแอตทริบิวต์นี้หากอุปกรณ์รองรับการเปิดและปิดมากกว่า 1 ทิศทาง
[item, ...]	String	ทิศทางที่รองรับ ค่าที่รองรับ UP DOWN LEFT RIGHT IN OUT
commandOnlyOpenClose	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ไม่ได้
queryOnlyOpenClose	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์จะค้นหาได้เฉพาะข้อมูลสถานะและควบคุมอุปกรณ์ไม่ได้หรือไม่ เซ็นเซอร์ที่รายงานสถานะเปิดได้เท่านั้นควรตั้งค่าช่องนี้เป็น "จริง"

ตัวอย่าง

อุปกรณ์แบบเปิดปิดที่เรียบง่าย

{
  "discreteOnlyOpenClose": true
}

อุปกรณ์จากบนลงล่าง เปิดในทิศทางใดก็ได้

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

อุปกรณ์ที่มีเพียงคำสั่งเท่านั้น

{
  "commandOnlyOpenClose": false
}

อุปกรณ์ STATES

เอนทิตีที่มีคุณสมบัตินี้อาจรายงานสถานะต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่Fulfillment ความตั้งใจ

เพย์โหลดประกอบด้วยค่าใดค่าหนึ่งต่อไปนี้

ทิศทางเดียวเปิด-ปิด

รัฐ	ประเภท	คำอธิบาย
openPercent	Number	จำเป็น ระบุเปอร์เซ็นต์ที่อุปกรณ์เปิด โดยเลข 0 คือปิด และ 100 เปิดโดยสมบูรณ์
targetOpenPercent	Number	ระดับซึ่งแสดงเปอร์เซ็นต์แบบเปิดที่จะวางอุปกรณ์หรือกำลังจะเคลื่อนที่ไป ซึ่งเป็นผลมาจากการเปลี่ยนแปลงตำแหน่งที่กำลังดำเนินอยู่

เปิด-ปิดหลายทิศทาง

รัฐ	ประเภท	คำอธิบาย
openState	อาร์เรย์	จำเป็น รายการสถานะสำหรับทิศทางเปิดที่รองรับแต่ละทิศทาง
[item, ...]	ออบเจ็กต์	สถานะปัจจุบันของทิศทางการเปิดที่ระบุ
openPercent	Number	จำเป็น ระบุเปอร์เซ็นต์ที่อุปกรณ์เปิด โดยเลข 0 คือปิด และ 100 เปิดโดยสมบูรณ์
targetOpenPercent	Number	ระดับซึ่งแสดงเปอร์เซ็นต์แบบเปิดที่จะวางอุปกรณ์หรือกำลังจะเคลื่อนที่ไป ซึ่งเป็นผลมาจากการเปลี่ยนแปลงตำแหน่งที่กำลังดำเนินอยู่
openDirection	String	จำเป็น ทิศทางที่อุปกรณ์เปิด ค่าที่รองรับ UP DOWN LEFT RIGHT IN OUT

ตัวอย่าง

อุปกรณ์แบบเปิดปิดที่เรียบง่าย

{
  "openPercent": 100
}

อุปกรณ์ง่ายๆ แบบเปิดปิดที่กำลังเปิดในตำแหน่งใหม่

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

เปิดอุปกรณ์ในทิศทางลง 30% และทางขึ้น 50%

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

เปิดอุปกรณ์ 30% ในทิศทางลงและ 50% ในทิศทางขึ้น โดยปัจจุบันย้ายไปในทิศทางขึ้น 80%

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

COMMANDS ของอุปกรณ์

หมายเหตุ: ลักษณะนี้รองรับการระบุสถานะเพิ่มเติมพร้อมคำตอบสำรองสำหรับการยืนยันผู้ใช้ ดูรายละเอียดเพิ่มเติมได้ในประเภทคำถามที่รองรับ

อุปกรณ์ที่มีคุณสมบัตินี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่Fulfillment ความตั้งใจ

action.devices.commands.OpenClose

ตั้งสถานะเปิดปิดของอุปกรณ์

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
openPercent	Number	จำเป็น ระบุเปอร์เซ็นต์ที่อุปกรณ์เปิด โดยเลข 0 คือปิด และ 100 เปิดโดยสมบูรณ์
openDirection	String	ทิศทางที่จะเปิด ปรากฏเฉพาะเมื่ออุปกรณ์รองรับหลายเส้นทางตามที่ระบุโดยแอตทริบิวต์ openDirection และผู้ใช้ระบุทิศทางแล้ว ค่าที่รองรับ UP DOWN LEFT RIGHT IN OUT
followUpToken	String	โทเค็นที่ 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 ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้คำตอบเพื่อติดตามผลได้ที่การแจ้งเตือนสำหรับการดำเนินการในสมาร์ทโฮม

เพย์โหลดประกอบด้วยค่าใดค่าหนึ่งต่อไปนี้

Success

ช่อง	ประเภท	คำอธิบาย
followUpToken	String	จำเป็น โทเค็นที่ระบุในคำขอ EXECUTE เดิม
status	String	จำเป็น ผลลัพธ์ของคำขอ ค่าที่รองรับ SUCCESS
openPercent	Number	จำเป็น ระบุเปอร์เซ็นต์ที่อุปกรณ์เปิดเมื่อ 0 ปิดอยู่ และ 100 เปิดอยู่เต็ม

ล้มเหลว

ช่อง	ประเภท	คำอธิบาย
followUpToken	String	จำเป็น โทเค็นที่ระบุในคำขอ EXECUTE เดิม
status	String	จำเป็น ผลลัพธ์ของคำขอ ค่าที่รองรับ FAILURE
errorCode	String	จำเป็น ค่าอาจเป็นรหัสข้อผิดพลาดใดก็ได้สำหรับลักษณะนี้ เช่น lockedState

ตัวอย่าง

เปิดประตูโรงรถ (การตอบกลับติดตามผลสำหรับกรณีความสำเร็จ)

{
  "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	String	ทิศทางที่จะเปิด ปรากฏเฉพาะเมื่ออุปกรณ์รองรับหลายเส้นทางตามที่ระบุโดยแอตทริบิวต์ openDirection และผู้ใช้ระบุทิศทางแล้ว ค่าที่รองรับ UP DOWN LEFT RIGHT IN OUT

ตัวอย่าง

เปิดอุปกรณ์เพิ่มอีกเล็กน้อย

{
  "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 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%

ข้อผิดพลาดเกี่ยวกับอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด