مخطط سمة 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 قيمة منطقية

مطلوبة

في حال ضبطها على "صحيح"، سيتم تطبيق قواعد نحوية إضافية لمنطق الزيادة/النقصان، وذلك بترتيب مصفوفة المستويات. على سبيل المثال، يؤدي قول "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 قيمة منطقية

مطلوبة

تشير إلى ما إذا كان الجهاز في وضع الاستعداد حاليًا.
currentArmLevel String

مطلوبة

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

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

أمثلة

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

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

أوامر الجهاز

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

action.devices.commands.ArmDisarm

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

المعلمات

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

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

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

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

مطلوبة

صحيح عندما يكون الأمر هو تفعيل جهاز الإنذار. خطأ لإيقاف جهاز الإنذار.
cancel قيمة منطقية

مطلوبة

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

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

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

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

مطلوبة

صحيح عندما يكون الأمر هو تفعيل جهاز الإنذار. خطأ لإيقاف جهاز الإنذار.
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

أخطاء الجهاز

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