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

مخطط سمات تقرير حالة المنزل الذكي

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

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

الجهاز ATTRIBUTES

بلا عري

حالة الجهاز STATES

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

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

مطلوبة.

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

[item, ...] العنصر

الحالة الحالية.

blocking منطقي

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

deviceTarget سلسلة

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

priority عدد صحيح

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

statusCode سلسلة

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

أمثلة

هل نظام الأمان سليم؟

{
  "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"
    }
  ]
}

مفاتيح COMMAND

بلا عري

أخطاء الجهاز

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