ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาของ Smart Home Lock Unlock Trait

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

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

ไม่มี

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

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

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

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

isJammed บูลีน

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

ตัวอย่าง

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

{
  "isLocked": true
}

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

{
  "isJammed": true
}

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

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

action.devices.commands.LockUnlock

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
lock บูลีน

ต้องระบุ

จริงเมื่อคําสั่งล็อก, เท็จ: ปลดล็อก

followUpToken สตริง

โทเค็นที่ 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 สตริง

ต้องระบุ

โทเค็นที่ระบุในคําขอ EXECUTE เดิม

status สตริง

ต้องระบุ

ผลลัพธ์ของคําขอ

ค่าที่รองรับมีดังต่อไปนี้

SUCCESS
isLocked บูลีน

ต้องระบุ

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

ล้มเหลว

ช่อง ประเภท คำอธิบาย
followUpToken สตริง

ต้องระบุ

โทเค็นที่ระบุในคําขอ EXECUTE เดิม

status สตริง

ต้องระบุ

ผลลัพธ์ของคําขอ

ค่าที่รองรับมีดังต่อไปนี้

FAILURE
errorCode สตริง

ต้องระบุ

ค่านี้อาจเป็นรหัสข้อผิดพลาดสําหรับลักษณะนี้ เช่น 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

  • บิท Eingangstür abschlieสั่งen
  • Bitte schlieğ die Eingangstür auf

en-US

  • ล็อก ประตูของฉัน
  • ปลดล็อก ห้องอ่านหนังสือ

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

อุปกรณ์ ERRORS

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