طرحواره صفت ArmDisarm خانه هوشمند

action.devices.traits.ArmDisarm - این ویژگی از تسلیح و خلع سلاح به عنوان مثال در سیستم های امنیتی استفاده می شود.

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

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

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

صفات تایپ کنید توضیحات
availableArmLevels شیء

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

levels آرایه

مورد نیاز.

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

[ item, ... ] شیء

سطح امنیت

level_name رشته

مورد نیاز.

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

level_values آرایه

مورد نیاز.

شامل level_synonym و lang است.

[ item, ... ] شیء

مترادف سطح برای یک زبان معین.

level_synonym آرایه

مورد نیاز.

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

[ item, ... ] رشته

نام مترادف.

lang رشته

مورد نیاز.

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

ordered بولی

مورد نیاز.

اگر روی درست تنظیم شود، گرامر اضافی برای منطق افزایش/کاهش، به ترتیب آرایه سطوح اعمال می شود. برای مثال، «Hey Google، سطح امنیت من را ۱ افزایش بده»، باعث می‌شود که دستیار سطح امنیتی فعلی را تعیین کند و سپس آن سطح امنیتی را یک‌بار افزایش دهد. اگر این مقدار روی 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 intent ها، به اجرای Intent مراجعه کنید.

action.devices.commands.ArmDisarm

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

پارامترها

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

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

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

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

arm بولی

مورد نیاز.

زمانی درست است که فرمان مسلح کردن باشد. کاذب برای خلع سلاح.

cancel بولی

مورد نیاز.

درست زمانی که دستور لغو مقدار arm باشد.

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

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

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

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

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

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