طرحواره صفت 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 رشته

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

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

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

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