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

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"
  }
}

أخطاء الجهاز

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