مخطط سمة Smart Home ArmDisarm

action.devices.traits.ArmDisarm: تتيح هذه السمة تفعيل نظام الأمان وإيقافه، كما هو مستخدَم في أنظمة الأمان مثلاً.

بالنسبة إلى الأجهزة التي تتضمّن مستويات أمان متعدّدة، يجب الإبلاغ عن هذه المستويات باستخدام السمة availableArmLevels.

سمات الجهاز

قد تعرض الأجهزة التي تتضمّن هذه السمة السمات التالية كجزء من عملية SYNC. لمزيد من المعلومات حول التعامل مع طلبات SYNC، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.

السمات النوع الوصف
availableArmLevels الكائن

توضّح هذه السمة مستويات الأمان المتوافقة مع الجهاز. في حال عدم الإبلاغ عن هذه السمة، يعني ذلك أنّ الجهاز يتيح مستوى واحدًا فقط.

levels المصفوفة

مطلوبة

قائمة بمستويات الأمان المتاحة التي يتيحها الجهاز.

[item, ...] الكائن

مستوى الأمان

level_name String

مطلوبة

الاسم الداخلي لمستوى الأمان المستخدَم في الأوامر والحالات يمكن أن يكون هذا الاسم غير مناسب للمستخدمين، ويتم مشاركته بجميع اللغات.

level_values المصفوفة

مطلوبة

يتضمّن level_synonym وlang.

[item, ...] الكائن

مرادف المستوى للغة معيّنة يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en من أجل توفير لغة احتياطية.

level_synonym المصفوفة

مطلوبة

أسماء سهلة الاستخدام للمستوى في كل لغة معتمَدة يتم التعامل مع العنصر الأول على أنّه الاسم الأساسي.

[item, ...] String

اسم المرادف يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en من أجل توفير لغة احتياطية.

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

مطلوبة

مطلوبة في حال تحديد السمة availableArmLevels. في حال توفّر مستويات أمان متعددة، يشير هذا الحقل إلى اسم مستوى الأمان الحالي.

exitAllowance عدد صحيح

تشير إلى الوقت الذي يجب أن يغادره المستخدم بالثواني قبل أن يصبح currentArmLevel ساريًا.

أمثلة

نظام أمان يعرض مستوى ذراع مميزًا

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

أوامر الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات حول التعامل مع طلبات EXECUTE، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.

action.devices.commands.ArmDisarm

اضبط مستوى التنبيه لهذا الجهاز.

المعلمات

تحتوي الحمولة على أحد العناصر التالية:

إلغاء عملية التفعيل أو الإيقاف

المعلمات النوع الوصف
followUpToken String

رمز مميز مقدَّم من Google للردّ على المتابعة.

arm Boolean

مطلوبة

تكون القيمة صحيحة عندما يكون الأمر هو التفعيل. يجب ضبط القيمة على "خطأ" لإيقاف التنبيه.

cancel Boolean

مطلوبة

تكون القيمة صحيحة عندما يكون الأمر هو إلغاء القيمة arm.

تفعيل الجهاز أو إيقافه، مع مستوى أمان اختياري

المعلمات النوع الوصف
followUpToken String

رمز مميز مقدَّم من Google للردّ على المتابعة.

arm Boolean

مطلوبة

تكون القيمة صحيحة عندما يكون الأمر هو التفعيل. يجب ضبط القيمة على "خطأ" لإيقاف التنبيه.

armLevel String

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

أخطاء الجهاز

اطّلِع على القائمة الكاملة للأخطاء والاستثناءات.