مخطّط سمة دورة التشغيل في المنزل الذكي
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 |
مطلوبة نتيجة العملية القيم المسموح بها:
|
currentCycleRemainingTime |
عدد صحيح |
مطلوبة الوقت المتبقّي في الدورة الحالية، بالثواني |
1
|
العنصر |
حالة تعذُّر إتمام العملية |
priority |
عدد صحيح |
مطلوبة يمثّل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، ما يشير إلى أنّه يجب قول الإشعار بصوت عالٍ. |
status |
String |
مطلوبة نتيجة العملية القيم المسموح بها:
|
errorCode |
String |
مطلوبة يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، على سبيل المثال |
أمثلة
انتهى وقت تشغيل الجهاز.
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
حدث خطأ أثناء إكمال الدورة الحالية.
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }