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

action.devices.traits.StatusReport: تشير هذه السمة إلى الحالة الحالية لجهاز محدد أو مجموعة من الأجهزة المتصلة.

يمكن لجهاز معيّن الإبلاغ عن حالته الحالية بالإضافة إلى حالة أي أجهزة ذات صلة في مجموعة. على سبيل المثال، قد يكون الجهاز المستهدف نظام أمان يضم الأجهزة ذات الصلة التي تمثل أجهزة استشعار فردية. يعمل تقرير الحالة كتجميع للإبلاغ عن الحالة المجمَّعة، ولكنه لا يحل محل العناوين الفردية. يجب الإبلاغ عن أي جهاز يمكن لتطبيق "مساعد Google" الوصول إليه كجهاز منفصل في استجابة SYNC.

سمات الجهاز

غير مسموح بأي رسائل

حالات الجهاز

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

الولايات النوع الوصف
currentStatusReport صفيف

يجب ملء هذا الحقل.

حالات الخطأ أو الاستثناء الحالية للجهاز وأي أرقام تعريف أجهزة ذات صلة

[item, ...] كائن

الحالة الآن

blocking منطقية

صحيح إذا كان الخطأ أو الحالة الحالية تمنع تنفيذ المزيد من الأوامر.

deviceTarget String

رقم تعريف الجهاز المستهدَف

priority عدد صحيح

يحدّد أولوية هذه الحالة. وكلما انخفضت القيمة، ارتفعت الأولوية، بحيث تكون الأولوية القصوى 0. تبلغ Google عن الخطأ أو حالة الاستثناء من الأولوية القصوى إلى الأدنى. استنادًا إلى الاستثناءات، قد لا تُبلغ Google سوى عن الأخطاء ذات الأولوية العالية أو الاستثناءات.

statusCode String

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

أمثلة

هل نظام الأمان على ما يرام؟

{
  "currentStatusReport": [
    {
      "blocking": false,
      "deviceTarget": "alarm_1",
      "priority": 0,
      "statusCode": "lowBattery"
    },
    {
      "blocking": false,
      "deviceTarget": "front_window_1",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": false,
      "deviceTarget": "back_window_2",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": true,
      "deviceTarget": "alarm_2",
      "priority": 0,
      "statusCode": "needsSoftwareUpdate"
    }
  ]
}

مفاتيح الجهاز

غير مسموح بأي رسائل

أخطاء الجهاز

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