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

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

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

سمات الجهاز

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

السمات	النوع	الوصف
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 intents، اطّلِع على تلبية النية.

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

أمثلة

نظام أمان يُبلغ عن مستوى تفعيل فريد

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

أوامر الجهاز

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

action.devices.commands.ArmDisarm

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

المعلمات

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

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

المعلمات	النوع	الوصف
followUpToken	String	رمز مميّز تقدّمه Google للردّ على المتابعة.
arm	صحيح/خطأ	مطلوبة صحيح عندما يكون الأمر هو تنشيط. False لإيقاف نظام التحكّم في الوصول.
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

أخطاء الجهاز

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