مخطّط سمات السلاح الناري في المنزل المزوّد بأجهزة ذكية

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

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

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
availableArmLevels	العنصر	لوصف مستويات الأمان المعتمدة للجهاز. إذا لم يتم الإبلاغ عن هذه السمة، سيدعم الجهاز مستوى واحدًا فقط.
levels	المصفوفة	مطلوبة. قائمة بمستويات الأمان المتاحة على الجهاز.
[item, ...]	العنصر	مستوى الأمان.
level_name	سلسلة	مطلوبة. الاسم الداخلي لمستوى الأمان المستخدم في الأوامر والحالات. يمكن أن يكون هذا الاسم غير سهل الاستخدام وتتم مشاركته عبر جميع اللغات.
level_values	المصفوفة	مطلوبة. يحتوي على level_synonym وlang.
[item, ...]	العنصر	مرادف مستوى للغة معينة.
level_synonym	المصفوفة	مطلوبة. أسماء سهلة الاستخدام للمستوى في كل لغة معتمدة. ويتم التعامل مع العنصر الأول على أنه الاسم الأساسي.
[item, ...]	سلسلة	اسم المرادفات.
lang	سلسلة	مطلوبة. رمز اللغة لمرادفات المستويات. راجع اللغات المعتمدة.
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
  }
}

حالة الجهاز STATES

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

الولايات	النوع	الوصف
isArmed	منطقي	مطلوبة. يشير إلى ما إذا كان الجهاز مُزوّدًا بالطاقة حاليًا.
currentArmLevel	سلسلة	مطلوبة. مطلوبة إذا تم تحديد السمة availableArmLevels. في حال وجود عدة مستويات أمان، يشير ذلك إلى اسم مستوى الأمان الحالي.
exitAllowance	عدد صحيح	يشير هذا المقياس إلى الوقت بالثواني الذي يجب أن يكون لدى المستخدم المغادرة قبل تفعيل currentArmLevel.

أمثلة

نظام الأمان الذي يبلّغ عن مستوى ذراع مختلف

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

مفاتيح COMMAND

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

action.devices.commands.ArmDisarm

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

المعلَمات

تحتوي الحمولة على واحد مما يلي:

إلغاء عملية تفعيل جهاز الإنذار أو إيقاف جهاز الإنذار

المعلَمات	النوع	الوصف
followUpToken	سلسلة	رمز مميز تقدمه Google للرد على المتابعة.
arm	منطقي	مطلوبة. True عندما يكون الأمر هو تفعيل جهاز الإنذار. خطأ في إيقاف جهاز الإنذار.
cancel	منطقي	مطلوبة. True عندما يكون الأمر هو إلغاء القيمة arm.

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

المعلَمات	النوع	الوصف
followUpToken	سلسلة	رمز مميز تقدمه Google للرد على المتابعة.
arm	منطقي	مطلوبة. True عندما يكون الأمر هو تفعيل جهاز الإنذار. خطأ في إيقاف جهاز الإنذار.
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

أخطاء الجهاز

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