طرحواره صفت ArmDisarm خانه هوشمند
action.devices.traits.ArmDisarm
- این ویژگی از تسلیح و خلع سلاح به عنوان مثال در سیستم های امنیتی استفاده می شود.
برای دستگاه هایی با سطوح مختلف امنیتی، این سطوح باید با ویژگی availableArmLevels
گزارش شوند.
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC
، به تحقق هدف مراجعه کنید.
ویژگی های | تایپ کنید | شرح |
---|---|---|
availableArmLevels | هدف - شی | سطوح امنیتی پشتیبانی شده دستگاه را شرح می دهد. اگر این ویژگی گزارش نشود، دستگاه فقط یک سطح را پشتیبانی می کند. |
levels | آرایه | ضروری. لیست سطوح امنیتی موجود که توسط دستگاه پشتیبانی می شود. |
[ item, ... ] | هدف - شی | سطح امنیت |
level_name | رشته | ضروری. نام داخلی سطح امنیتی که در دستورات و حالت ها استفاده می شود. این نام میتواند کاربر پسند نباشد و در همه زبانها به اشتراک گذاشته شود. |
level_values | آرایه | ضروری. شامل |
[ 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 | رشته | ضروری. اگر ویژگی |
exitAllowance | عدد صحیح | زمانی را نشان می دهد که کاربر باید قبل از اینکه |
مثال ها
سیستم امنیتی که سطح بازوی متمایز را گزارش می کند
{ "isArmed": true, "currentArmLevel": "L1" }
دستورات دستگاه
دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE
پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE
intent ها، به اجرای Intent مراجعه کنید.
action.devices.commands.ArmDisarm
سطح هشدار این دستگاه را تنظیم کنید.
مولفه های
محموله شامل یکی از موارد زیر است:
عملیات بازو یا خلع سلاح را لغو کنید
مولفه های | تایپ کنید | شرح |
---|---|---|
followUpToken | رشته | توکن ارائه شده توسط گوگل برای پاسخگویی بعدی. |
arm | بولی | ضروری. زمانی درست است که فرمان مسلح کردن باشد. کاذب برای خلع سلاح. |
cancel | بولی | ضروری. درست زمانی که دستور لغو مقدار |
دستگاه را با سطح امنیتی اختیاری مسلح یا خلع سلاح کنید.
مولفه های | تایپ کنید | شرح |
---|---|---|
followUpToken | رشته | توکن ارائه شده توسط گوگل برای پاسخگویی بعدی. |
arm | بولی | ضروری. زمانی درست است که فرمان مسلح کردن باشد. کاذب برای خلع سلاح. |
armLevel | رشته | |
مثال ها
سیستم را مسلح کنید
{ "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