مخطط سمة Smart Home ArmDisarm
action.devices.traits.ArmDisarm
: تتيح هذه السمة تفعيل نظام الأمان وإيقافه، كما هو مستخدَم في أنظمة الأمان مثلاً.
بالنسبة إلى الأجهزة التي تتضمّن مستويات أمان متعدّدة، يجب الإبلاغ عن هذه المستويات باستخدام السمة availableArmLevels
.
سمات الجهاز
قد تعرض الأجهزة التي تتضمّن هذه السمة السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع طلبات SYNC
، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.
السمات | النوع | الوصف |
---|---|---|
availableArmLevels |
الكائن |
توضّح هذه السمة مستويات الأمان المتوافقة مع الجهاز. في حال عدم الإبلاغ عن هذه السمة، يعني ذلك أنّ الجهاز يتيح مستوى واحدًا فقط. |
levels |
المصفوفة |
مطلوبة قائمة بمستويات الأمان المتاحة التي يتيحها الجهاز. |
[item, ...] |
الكائن |
مستوى الأمان |
level_name |
String |
مطلوبة الاسم الداخلي لمستوى الأمان المستخدَم في الأوامر والحالات يمكن أن يكون هذا الاسم غير مناسب للمستخدمين، ويتم مشاركته بجميع اللغات. |
level_values |
المصفوفة |
مطلوبة يتضمّن |
[item, ...] |
الكائن |
مرادف المستوى للغة معيّنة يجب توفير عنصر واحد على الأقل بقيمة |
level_synonym |
المصفوفة |
مطلوبة أسماء سهلة الاستخدام للمستوى في كل لغة معتمَدة يتم التعامل مع العنصر الأول على أنّه الاسم الأساسي. |
[item, ...] |
String |
اسم المرادف يجب توفير عنصر واحد على الأقل بقيمة |
lang |
String |
مطلوبة رمز اللغة لمرادفات المستوى اللغات المتاحة |
ordered |
Boolean |
مطلوبة في حال ضبطها على "صحيح"، سيتم تطبيق قواعد نحوية إضافية لمنطق الزيادة/النقصان، وذلك بترتيب مصفوفة المستويات. على سبيل المثال، يؤدي قول "Ok Google، ارفع مستوى الأمان بمقدار 1" إلى أن يحدّد "مساعد Google" مستوى الأمان الحالي ثم يرفعه بمقدار واحد. في حال ضبط هذه القيمة على "خطأ"، لن تكون قواعد نحوية إضافية لمنطق الزيادة/النقصان متاحة. |
أمثلة
نظام أمان بمستويَين مختلفَين من التفعيل
{ "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 |
Boolean |
مطلوبة تشير هذه السمة إلى ما إذا كان الجهاز في وضع الاستعداد حاليًا. |
currentArmLevel |
String |
مطلوبة مطلوبة في حال تحديد السمة |
exitAllowance |
عدد صحيح |
تشير إلى الوقت الذي يجب أن يغادره المستخدم بالثواني قبل أن يصبح |
أمثلة
نظام أمان يعرض مستوى ذراع مميزًا
{ "isArmed": true, "currentArmLevel": "L1" }
أوامر الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع طلبات EXECUTE
، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.
action.devices.commands.ArmDisarm
اضبط مستوى التنبيه لهذا الجهاز.
المعلمات
تحتوي الحمولة على أحد العناصر التالية:
إلغاء عملية التفعيل أو الإيقاف
المعلمات | النوع | الوصف |
---|---|---|
followUpToken |
String |
رمز مميز مقدَّم من Google للردّ على المتابعة. |
arm |
Boolean |
مطلوبة تكون القيمة صحيحة عندما يكون الأمر هو التفعيل. يجب ضبط القيمة على "خطأ" لإيقاف التنبيه. |
cancel |
Boolean |
مطلوبة تكون القيمة صحيحة عندما يكون الأمر هو إلغاء القيمة |
تفعيل الجهاز أو إيقافه، مع مستوى أمان اختياري
المعلمات | النوع | الوصف |
---|---|---|
followUpToken |
String |
رمز مميز مقدَّم من Google للردّ على المتابعة. |
arm |
Boolean |
مطلوبة تكون القيمة صحيحة عندما يكون الأمر هو التفعيل. يجب ضبط القيمة على "خطأ" لإيقاف التنبيه. |
armLevel |
String |
|
أمثلة
تفعيل النظام
{ "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