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

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

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

ไม่มี

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

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

ตัวอย่าง

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

{
  "isLocked": true
}

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

{
  "isJammed": true
}

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

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

action.devices.commands.LockUnlock

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

พารามิเตอร์

ตัวอย่าง

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

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

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

สำเร็จ: ล็อกแล้ว

ล้มเหลว

ตัวอย่าง

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

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

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

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