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