طرحواره ویژگی قفل و باز کردن قفل خانه هوشمند

action.devices.traits.LockUnlock - این trait متعلق به هر دستگاهی است که از قفل کردن و باز کردن قفل و/یا گزارش وضعیت قفل پشتیبانی می‌کند.

ویژگی‌های دستگاه

هیچ کدام.

وضعیت دستگاه

موجودیت‌هایی با این ویژگی ممکن است حالت‌های زیر را به عنوان بخشی از عملیات 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"
    }
  }
}

نمونه گفته‌ها

خطاهای دستگاه