مخطط سمة جهاز إنذار جهاز الإنذار Home Home

action.devices.traits.ArmDisarm - تتيح هذه السمة تفعيل جهاز الإنذار وإيقافه كما هو الحال في أنظمة الأمان.

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

سمات الجهاز

قد تُبلِغ الأجهزة التي تستخدم هذه السمة عن السمات التالية كجزء من عملية 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
  }
}

حالات الجهاز

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

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

أمثلة

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

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

أوامر الجهاز

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

action.devices.commands.ArmDisarm

اضبُط مستوى صوت هذا الجهاز.

المَعلمات

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

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

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

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

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

أخطاء الجهاز

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