مخطّط سمة دورة التشغيل في المنزل الذكي

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

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

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

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

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

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

سمات الجهاز

بلا عُري

حالات الجهاز

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

الولايات النوع الوصف
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"
  }
}

أخطاء الجهاز

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