مخطط سماقة التشغيل الذكي Home RunCycle

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

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

• ما هي دورة تشغيل المجفّف؟
• كم عدد الدورات المتبقية في غسّالة الصحون؟
• ما هي وظيفة المجفّف؟
• متى ستتم عملية الغسيل؟

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

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

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

سمات الجهاز

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

حالات الجهاز

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

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

حوالات الجهاز

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

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

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

الحقول	Type	الوصف
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"
  }
}

أخطاء الجهاز

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