مخطّط سمة قفل/فتح قفل المنزل الذكي

‫action.devices.traits.LockUnlock: تنطبق هذه السمة على أي أجهزة تتيح قفل الجهاز وفتح قفله و/أو الإبلاغ عن حالة القفل.

سمات الجهاز

بلا عُري

حالة الجهاز

يمكن أن تُبلغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات عن معالجة أهداف QUERY، يمكنك الاطّلاع على تلبية الأهداف.

أمثلة

الجهاز الذي تم قفله

{
  "isLocked": true
}

الجهاز الذي لا يعمل

{
  "isJammed": true
}

أوامر الجهاز

قد تستجيب الأجهزة التي تحتوي على هذه السمة للأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات حول كيفية التعامل مع نية EXECUTE، يمكنك الاطّلاع على التنفيذ حسب نية العميل.

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. للاطّلاع على مزيد من المعلومات حول تنفيذ الردود للمتابعة، اطّلِع على مقالة الإشعارات لإجراءات المنزل الذكي.

تحتوي الحمولة على أحد العناصر التالية:

تم بنجاح: قفل الباب

تعذّر إتمام العملية

أمثلة

أريد قفل الباب الأمامي. (ردّ متابعة لحالة النجاح)

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

نماذج الطلبات

أخطاء الجهاز