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

مخطط سمة جهاز إنذار جهاز الإنذار 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

أخطاء الجهاز

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