مخطط إصدار الإنذار الصادر عن المنزل المزوَّد بأجهزة ذكية

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

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

سمات الجهاز

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

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

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

أمثلة

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

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

حوالات الجهاز

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

action.devices.commands.ArmDisarm

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

المَعلمات

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

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

المَعلمات	Type	الوصف
followUpToken	String	الرمز المميّز الذي تقدمه Google للرد على المتابعة
arm	منطقي	مطلوب: صحيح عند تفعيل الأمر. إِيقَافْ جِهَازِ الْإِنْذَارْ.
cancel	منطقي	مطلوب: صحيح إذا كان الأمر يؤدي إلى إلغاء قيمة arm.

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

المَعلمات	Type	الوصف
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

أخطاء الجهاز

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