طرحواره ویژگی ArmDisarm خانه هوشمند

action.devices.traits.ArmDisarm - این ویژگی از فعال و غیرفعال کردن دستگاه پشتیبانی می‌کند، همانطور که برای مثال در سیستم‌های امنیتی استفاده می‌شود.

برای دستگاه‌هایی با چندین سطح امنیتی، این سطوح باید با ویژگی availableArmLevels گزارش شوند.

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

دستگاه‌هایی که این ویژگی را دارند، ممکن است ویژگی‌های زیر را به عنوان بخشی از عملیات SYNC گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف SYNC ، به بخش «تحقق اهداف» مراجعه کنید.

ویژگی‌ها نوع توضیحات
availableArmLevels شیء

سطوح امنیتی پشتیبانی‌شده توسط دستگاه را شرح می‌دهد. اگر این ویژگی گزارش نشود، دستگاه فقط از یک سطح پشتیبانی می‌کند.

levels آرایه

الزامی است.

فهرست سطوح امنیتی موجود که توسط دستگاه پشتیبانی می‌شوند.

[ item, ... ] شیء

سطح امنیتی.

level_name رشته

الزامی است.

نام داخلی سطح امنیتی که در دستورات و وضعیت‌ها استفاده می‌شود. این نام می‌تواند کاربرپسند نباشد و در همه زبان‌ها مشترک است.

level_values آرایه

الزامی است.

شامل level_synonym و lang است.

[ item, ... ] شیء

مترادف سطح برای یک زبان معین. حداقل یک مورد با مقدار lang برابر با en برای ارائه جایگزین زبان مورد نیاز است.

level_synonym آرایه

الزامی است.

نام‌های کاربرپسند برای سطح در هر زبان پشتیبانی‌شده. اولین مورد به عنوان نام استاندارد در نظر گرفته می‌شود.

[ item, ... ] رشته

نام مترادف. حداقل یک آیتم با مقدار lang برابر با en برای ارائه جایگزین زبان مورد نیاز است.

lang رشته

الزامی است.

کد زبان برای مترادف‌های سطح. به زبان‌های پشتیبانی‌شده مراجعه کنید.

ordered بولی

الزامی است.

اگر روی true تنظیم شود، دستور زبان اضافی برای منطق افزایش/کاهش، به ترتیب آرایه سطوح، اعمال می‌شود. برای مثال، "سلام گوگل، سطح امنیتی من را ۱ واحد افزایش بده"، منجر به این می‌شود که دستیار سطح امنیتی فعلی را تعیین کند و سپس آن سطح امنیتی را یک واحد افزایش دهد. اگر این مقدار روی false تنظیم شود، دستور زبان اضافی برای منطق افزایش/کاهش پشتیبانی نمی‌شود.

مثال‌ها

سیستم امنیتی با دو سطح بازویی مجزا

{
  "availableArmLevels": {
    "levels": [
      {
        "level_name": "L1",
        "level_values": [
          {
            "level_synonym": [
              "Home and Guarding",
              "SL1"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Zuhause und Bewachen",
              "SL1"
            ],
            "lang": "de"
          }
        ]
      },
      {
        "level_name": "L2",
        "level_values": [
          {
            "level_synonym": [
              "Away and Guarding",
              "SL2"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Weg und Bewachen",
              "SL2"
            ],
            "lang": "de"
          }
        ]
      }
    ],
    "ordered": true
  }
}

وضعیت دستگاه

موجودیت‌هایی با این ویژگی ممکن است حالت‌های زیر را به عنوان بخشی از عملیات QUERY گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف QUERY ، به بخش «تحقق اهداف» مراجعه کنید.

ایالت‌ها نوع توضیحات
isArmed بولی

الزامی است.

نشان می‌دهد که آیا دستگاه در حال حاضر مسلح است یا خیر.

currentArmLevel رشته

الزامی است.

در صورت مشخص شدن ویژگی availableArmLevels الزامی است. اگر چندین سطح امنیتی وجود داشته باشد، نام سطح امنیتی فعلی را نشان می‌دهد.

exitAllowance عدد صحیح

نشان می‌دهد که کاربر چه زمانی (بر حسب ثانیه) باید قبل از اعمال currentArmLevel را ترک کند.

مثال‌ها

سیستم امنیتی که سطح بازوی متمایز را گزارش می‌دهد

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

دستورات دستگاه

دستگاه‌هایی که این ویژگی را دارند، می‌توانند به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف EXECUTE ، به بخش «تحقق اهداف» مراجعه کنید.

action.devices.commands.ArmDisarm

سطح هشدار این دستگاه را تنظیم کنید.

پارامترها

محموله شامل یکی از موارد زیر است:

لغو عملیات مسلح کردن یا خلع سلاح کردن

پارامترها نوع توضیحات
followUpToken رشته

توکن ارائه شده توسط گوگل برای پاسخ‌های بعدی.

arm بولی

الزامی است.

وقتی دستور مسلح کردن باشد، درست است. وقتی دستور خلع سلاح باشد، غلط است.

cancel بولی

الزامی است.

وقتی دستور برای لغو مقدار arm باشد، صحیح است.

دستگاه را با سطح امنیتی اختیاری، مسلح یا غیرفعال کنید.

پارامترها نوع توضیحات
followUpToken رشته

توکن ارائه شده توسط گوگل برای پاسخ‌های بعدی.

arm بولی

الزامی است.

وقتی دستور مسلح کردن باشد، درست است. وقتی دستور خلع سلاح باشد، غلط است.

armLevel رشته

level_name که قرار است به آن مسلح شوید.

مثال‌ها

سیستم را مسلح کنید

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

سیستم را روی سطح بازویی L1 تنظیم کنید

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

عملیات مسلح‌سازی را لغو کنید

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

خطایی در فعال یا غیرفعال کردن دستگاه رخ داده است.

مقادیر پشتیبانی شده:

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

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

لیست کامل خطاها و استثنائات را مشاهده کنید.