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

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

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

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

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

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

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

الجهاز ATTRIBUTES

بلا عري

حالة الجهاز STATES

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

الولايات	النوع	الوصف
currentRunCycle	المصفوفة	مطلوبة. يحتوي على مرادفات للدورة الحالية في كل لغة مدعومة.
[item, ...]	العنصر	أسماء مرادفات الدورة
currentCycle	سلسلة	مطلوبة. جارٍ تنفيذ الدورة الحالية.
nextCycle	سلسلة	اختياريّ. دورة التشغيل التالية.
lang	سلسلة	مطلوبة. رمز اللغة لأسماء الدورات المحددة. راجع اللغات المعتمدة.
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
}

مفاتيح COMMAND

بلا عري

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

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

الحقول	النوع	الوصف
RunCycle		مطلوبة. البيانات الأساسية للإشعارات
يتيح أحد الخيارات التالية:
0	العنصر	تم الإجراء بنجاح
priority	عدد صحيح	مطلوبة. يمثل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، مما يعني أنه يجب قول الإشعار بصوت عالٍ.
status	سلسلة	مطلوبة. نتيجة العملية. القيم المسموح بها: SUCCESS
currentCycleRemainingTime	عدد صحيح	مطلوبة. الوقت المتبقي في الدورة الحالية، بالثواني.
1	العنصر	تعذّر الإجراء
priority	عدد صحيح	مطلوبة. يمثل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، مما يعني أنه يجب قول الإشعار بصوت عالٍ.
status	سلسلة	مطلوبة. نتيجة العملية. القيم المسموح بها: FAILURE
errorCode	سلسلة	مطلوبة. يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل deviceStuck.

أمثلة

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

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

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

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

أخطاء الجهاز

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