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

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

ATTRIBUTES ของอุปกรณ์

ไม่ต้องแจ้งเตือนเลย

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

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

รัฐ ประเภท คำอธิบาย
isLocked บูลีน

ระบุว่าอุปกรณ์ล็อกอยู่หรือไม่

isJammed บูลีน

สถานะอุปกรณ์ติดอยู่จึงไม่สามารถระบุสถานะการล็อกของอุปกรณ์ได้หรือไม่

ตัวอย่าง

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

{
  "isLocked": true
}

อุปกรณ์ที่ติดอยู่

{
  "isJammed": true
}

COMMANDS ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่Fulfillment 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

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

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