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

action.devices.traits.RunCycle: تمثّل هذه السمة أي جهاز له مدة تشغيل مستمرة يمكن الاستعلام عنها.

ستحدّد هذه الأجهزة إجمالي عدد دوراتها في بداية التشغيل، وعدد كل دورة يجريها الجهاز حاليًا. ويتيح ذلك للمستخدم إجراء طلبات بحث، مثل ما يلي:

  • ما هي دورة التشغيل الحالية لآلة التجفيف؟
  • كم عدد دورات غسل الأطباق المتبقية؟
  • ما هي حالة المجفف؟
  • متى سيتم الانتهاء من عملية الغسيل؟

تتضمّن بعض الأجهزة مدة بتنسيق غير دوري. يمكن لأي جهاز يعمل لفترة زمنية محددة الإبلاغ عن الوقت المتبقّي بدون دورات. ويعالج هذا الإجراء أيضًا الحالات التي قد لا تكون فيها الدورات متسقة (على سبيل المثال، قد لا تستخدم غسالات الأطباق جميع الدورات). على سبيل المثال، يمكن للمستخدم أن يسأل، كم ساعة أخرى سيستمر تشغيل المكنسة الكهربائية؟ وسيعرض ذلك الوقت بالوحدات المتناسبة مع الوقت المتبقّي. ينطبق ذلك أيضًا على الأجهزة المُدرَجة أعلاه، وسيعرض السؤال كم من الوقت سيستغرق تجفيف ملابسي؟ المدة بالدقائق.

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

تُعد RunCycle حاليًا سمة للقراءة فقط - لا تحتوي على أوامر، ولكنها تحتوي فقط على حالات للاستعلام. في المستقبل، قد تتوفّر آليات لإعادة تنفيذ الدورات أو تخطّي دورات (يُفضّل ذلك في رشاشات المياه، ولكن ليس في الغسالات).

سمات الجهاز

بلا عُري

حالات الجهاز

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

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

مطلوبة

يحتوي على المرادفات للدورة الحالية بكل لغة معتمَدة.

[item, ...] كائن

أسماء المرادفات للدورة

currentCycle String

مطلوبة

يتم تنفيذ الدورة الحالية.

nextCycle String

اختياريّ. الدورة التالية التي سيتم تنفيذها.

lang String

مطلوبة

رمز اللغة لأسماء الدورات المحددة. راجِع اللغات المتاحة.

currentTotalRemainingTime عدد صحيح

مطلوبة

الوقت المتبقّي للعملية، بالثواني

currentCycleRemainingTime عدد صحيح

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

الوقت المتبقّي في الدورة الحالية، بالثواني

أمثلة

يجري الجهاز عملية شطف لمدة 5 دقائق أخرى، وسيتم الانتهاء منها بعد 20 دقيقة.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

يستمر الجهاز في دورة الشطف لمدة 5 دقائق أخرى قبل الانتقال إلى دورة العصر.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

أوامر الجهاز

بلا عُري

إشعارات الجهاز

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

الحقول النوع الوصف
RunCycle

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

الحمولة في الإشعار

توفُّر أحد الخيارَين التاليَين:
0 العنصر

تم الإجراء بنجاح

priority عدد صحيح

مطلوبة

يمثّل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، ما يشير إلى أنّه يجب قول الإشعار بصوت عالٍ.

status String

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

نتيجة العملية.

القيم المسموح بها:

SUCCESS
currentCycleRemainingTime عدد صحيح

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

الوقت المتبقّي في الدورة الحالية، بالثواني

1 العنصر

تعذّر إتمام العملية

priority عدد صحيح

مطلوبة

يمثّل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، ما يشير إلى أنّه يجب قول الإشعار بصوت عالٍ.

status String

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

نتيجة العملية.

القيم المسموح بها:

FAILURE
errorCode String

مطلوبة

يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، على سبيل المثال deviceStuck.

أمثلة

انتهى وقت تشغيل الجهاز.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

حدث خطأ أثناء إكمال الدورة الحالية.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

أخطاء الجهاز

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