สคีมาลักษณะ OpenClose ของสมาร์ทโฮม

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

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

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

Attributes ประเภท คำอธิบาย
discreteOnlyOpenClose บูลีน

(ค่าเริ่มต้น: false)

เมื่อตั้งค่าเป็น "จริง" หมายความว่าอุปกรณ์ต้องเปิดหรือปิดจนสุด (กล่าวคือ ไม่รองรับค่าระหว่าง 0% ถึง 100%)
openDirection อาร์เรย์

รายการทิศทางที่รองรับซึ่งอุปกรณ์สามารถเปิดหรือปิดได้ ระบุแอตทริบิวต์นี้หากอุปกรณ์รองรับการเปิดและการปิดในทิศทางมากกว่า 1 ทิศทาง
[item, ...] String

ทิศทางที่รองรับ

ค่าที่รองรับ

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รองรับการสื่อสารแบบ 1 ทิศทาง (จริง) หรือ 2 ทิศทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ไม่ได้
queryOnlyOpenClose บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์ค้นหาได้เฉพาะข้อมูลสถานะและควบคุมไม่ได้ เซ็นเซอร์ที่รายงานได้เฉพาะสถานะเปิดควรตั้งค่าฟิลด์นี้เป็น "จริง"

ตัวอย่าง

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

{
  "discreteOnlyOpenClose": true
}

อุปกรณ์แบบปิดจากบนลงล่างและล่างขึ้นบน สามารถเปิดได้ในทิศทางใดทิศทางหนึ่ง

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

อุปกรณ์ที่ใช้คำสั่งเท่านั้น

{
  "commandOnlyOpenClose": false
}

สถานะอุปกรณ์

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

เพย์โหลดมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

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

รัฐ ประเภท คำอธิบาย
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"
    }
  ]
}

คำสั่งของอุปกรณ์

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

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 ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้การตอบกลับติดตามผลได้ที่การแจ้งเตือนสําหรับการดำเนินการในบ้านอัจฉริยะ

เพย์โหลดมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

สำเร็จ

ช่อง ประเภท คำอธิบาย
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%

ข้อผิดพลาดของอุปกรณ์

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