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

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

أخطاء الجهاز

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