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

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

سمات الجهاز

بلا عُري

حالات الجهاز

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

أمثلة

الجهاز المُقفَل

{
  "isLocked": true
}

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

{
  "isJammed": true
}

أوامر الجهاز

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

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

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

أخطاء الجهاز