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