مخطط سماقة التشغيل الذكي 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"
  }
}

أخطاء الجهاز

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