مخطّط سمة ArmDisarm للمنازل الذكية

‫action.devices.traits.ArmDisarm - تتيح هذه السمة وضع الجهاز في وضع التشغيل أو الإيقاف كما هو مُستخدَم في أنظمة الأمان مثلاً.

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

سمات الجهاز

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

السمات النوع الوصف
availableArmLevels العنصر

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

يجب ملء هذا الحقل.

قائمة بمستويات الأمان المتاحة التي يتوافق معها الجهاز
[item, ...] العنصر

مستوى الأمان.
level_name String

مطلوبة

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

مطلوبة

يتضمّن level_synonym وlang.
[item, ...] كائن

مرادف المستوى بلغة معيّنة.
level_synonym صفيف

مطلوبة

أسماء سهلة الاستخدام للمستوى بكل لغة متوفّرة يتم التعامل مع العنصر الأول على أنه الاسم المتعارف عليه.
[item, ...] String

اسم مرادف.
lang String

مطلوبة

رمز اللغة لمرادفات المستوى. اطّلِع على اللغات المتاحة.
ordered صحيح/خطأ

مطلوبة

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

مطلوبة

صحيح عندما يكون الأمر هو تنشيط. False لإيقاف نظام التحكّم في الوصول.
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

أخطاء الجهاز

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