สคีมาลักษณะ LockUnlock สมาร์ทโฮม

action.devices.traits.LockUnlock - ลักษณะนี้ใช้กับอุปกรณ์ที่รองรับการล็อกและการปลดล็อก และ/หรือการรายงานสถานะล็อก

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

ไม่มี

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

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

รัฐ	ประเภท	คำอธิบาย
isLocked	บูลีน	อุปกรณ์ล็อกอยู่หรือไม่
isJammed	บูลีน	อุปกรณ์ถูกรบกวนอยู่หรือไม่ จึงไม่สามารถระบุสถานะการล็อกของอุปกรณ์ได้

ตัวอย่าง

อุปกรณ์ที่ล็อกอยู่

{
  "isLocked": true
}

อุปกรณ์ติดขัด

{
  "isJammed": true
}

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

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

action.devices.commands.LockUnlock

ล็อกหรือปลดล็อกอุปกรณ์

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
lock	บูลีน	ต้องระบุ เป็นจริงเมื่อคำสั่งคือล็อก เป็นเท็จเมื่อปลดล็อก
followUpToken	String	โทเค็นที่ Google มีให้สำหรับการตอบกลับติดตามผล

ตัวอย่าง

ล็อกประตูหน้า

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": true,
    "followUpToken": "123"
  }
}

ปลดล็อกประตูหน้า

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": false,
    "followUpToken": "567"
  }
}

ข้อผิดพลาดที่เกี่ยวข้อง

เกิดข้อผิดพลาดขณะล็อกหรือปลดล็อกอุปกรณ์

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

remoteSetDisabled

deviceJammingDetected

notSupported

alreadyLocked

alreadyUnlocked

การตอบกลับเพื่อติดตามผล

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

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

สำเร็จ: ล็อก

ช่อง	ประเภท	คำอธิบาย
followUpToken	String	ต้องระบุ โทเค็นที่ระบุในคำขอ EXECUTE ต้นฉบับ
status	String	ต้องระบุ ผลลัพธ์ของคำขอ ค่าที่รองรับ SUCCESS
isLocked	บูลีน	ต้องระบุ ระบุว่าอุปกรณ์ล็อกอยู่หรือไม่

ล้มเหลว

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

ตัวอย่าง

ล็อกประตูหน้า (การตอบกลับเพื่อติดตามผลสำหรับกรณีศึกษา)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": true,
      "followUpToken": "1234"
    }
  }
}

ปลดล็อกประตูหน้า (การตอบกลับเพื่อติดตามผลสำหรับกรณีศึกษา)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": false,
      "followUpToken": "1234"
    }
  }
}

ล็อกประตูหน้า (การตอบกลับติดตามผลสำหรับกรณีที่ดำเนินการไม่สำเร็จ)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "deviceJammingDetected",
      "followUpToken": "1234"
    }
  }
}

ตัวอย่างคำพูด

de-DE

• Bitte Eingangstür abschließen
• Bitte schließ die Eingangstür auf

en-US

• lock my doors
• unlock study room

es-ES

• cierra la puerta con llave
• quitar el cerrojo de la puerta de entrad a

fr-FR

• déverrouille la porte d'entrée
• verrouille la porte d'entrée

hi-IN

• फ़्रंट डोर अनलॉक करो
• सामने के दरवाजे को लॉक करो

it-IT

• apri la porta d'ingresso
• puoi chiudere la porta d'ingresso a chiave

ja-JP

• 玄関のドア を施錠して
• 玄関 開錠して

ko-KR

• 도어락 잠가 줘
• 현관 도어락 열어 줄래

nl-NL

• Ontgrendel de voordeur
• doe de voordeur op slot

pt-BR

• Tranca a porta do quarto .
• destranca a porta da cozinha
• destrancar a porta da frente
• trancar a porta da frente

sv-SE

• lås upp ytterdörren
• lås ytterdörren

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

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