مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطّط سمات السلاح الناري في المنزل المزوّد بأجهزة ذكية

action.devices.traits.ArmDisarm: تتيح هذه السمة تفعيل جهاز الإنذار وتعطيله كما هو مستخدم في أنظمة الأمان مثلاً.

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

الجهاز ATTRIBUTES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية 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
  }
}

حالة الجهاز STATES

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

الولايات النوع الوصف
isArmed منطقي

مطلوبة.

يشير إلى ما إذا كان الجهاز مُزوّدًا بالطاقة حاليًا.

currentArmLevel سلسلة

مطلوبة.

مطلوبة إذا تم تحديد السمة availableArmLevels. في حال وجود عدة مستويات أمان، يشير ذلك إلى اسم مستوى الأمان الحالي.

exitAllowance عدد صحيح

يشير هذا المقياس إلى الوقت بالثواني الذي يجب أن يكون لدى المستخدم المغادرة قبل تفعيل currentArmLevel.

أمثلة

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

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

مفاتيح COMMAND

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

action.devices.commands.ArmDisarm

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

المَعلمات

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

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

المَعلمات النوع الوصف
followUpToken سلسلة

رمز مميز تقدمه Google للرد على المتابعة.

arm منطقي

مطلوبة.

True عندما يكون الأمر هو تفعيل جهاز الإنذار. خطأ في إيقاف جهاز الإنذار.

cancel منطقي

مطلوبة.

True عندما يكون الأمر هو إلغاء القيمة arm.

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

المَعلمات النوع الوصف
followUpToken سلسلة

رمز مميز تقدمه Google للرد على المتابعة.

arm منطقي

مطلوبة.

True عندما يكون الأمر هو تفعيل جهاز الإنذار. خطأ في إيقاف جهاز الإنذار.

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

أخطاء الجهاز

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