סכימה של מסלול אופניים ביתיים חכמים
action.devices.traits.RunCycle
- תכונה זו מייצגת כל מכשיר עם משך פעולה מתמשך שניתן לשלוח אליו שאילתה.
מכשירים כאלה ידווחו על מספר המחזורים הכוללים שלהם בתחילת הפעולה, וכל מחזור שבו המכשיר פועל באותו רגע. כך המשתמשים יכולים לבצע שאילתות, למשל:
- באילו מחזורים ייבוש המכונה שלי?
- כמה מחזורים מסתיים במדיח הכלים?
- מה מייבש כביסה?
- מתי תתבצע הכביסה?
עבור מכשירים מסוימים, משך הזמן הוא לא מחזורי. בכל מכשיר שפועל למשך פרק זמן מסוים, אפשר לדווח על הזמן שנותר, ללא מחזורים. כך מטפלים גם במקרים שבהם המחזורים לא עקביים (לדוגמה, מדיחים לא תמיד משתמשים בכל המחזורים). לדוגמה, משתמש יכול לשאול HowHow long will my שואב אבק יפעל, שיחזיר את משך הזמן ביחידות יחסית ביחס לזמן שנותר. הדבר נכון גם לגבי המכשירים הרשומים למעלה. כמה זמן הבגדים שלי יהיו יבשים? יוחזר משך הזמן בתוך דקות.
מכשירים יכולים להחזיר את מה שהם יודעים, ותגובת ה-TTS של Assistant תיצור את התשובה הטובה ביותר עם הנתונים הזמינים (לדוגמה, המדיח פועל ותסתיים תוך כ-20 דקות.)
נכון לעכשיו, RunCycle היא תכונה לקריאה בלבד – אין לה פקודות, היא רק מצבה של השאילתה. בעתיד ייתכן שיהיו מנגנונים להפעלה מחדש של מחזורים או דילוג על מחזורים (מתאים לממטרות, ולמכונות כביסה).
ATTRIBUTES במכשיר
ללא.
מצבים של המכשיר
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים
במסגרת הפעולה QUERY
. מידע נוסף על טיפול ב-QUERY
כוונות זמין בקטע מימוש כוונה.
מדינות | Type | תיאור |
---|---|---|
currentRunCycle |
מערך |
חובה. מכיל את המילים הנרדפות למחזור הנוכחי בכל אחת מהשפות הנתמכות. |
[item, ...] |
אובייקט |
שמות מילים נרדפות למחזור. |
currentCycle |
String |
חובה. המחזור הנוכחי מתבצע. |
nextCycle |
String |
אופציונלי. המחזור הבא לביצוע. |
lang |
String |
חובה. קוד השפה של שמות המחזורים שצוינו. שפות נתמכות |
currentTotalRemainingTime |
Integer |
חובה. הזמן שנותר להפעלה, בשניות. |
currentCycleRemainingTime |
Integer |
חובה. הזמן שנותר במחזור הנוכחי, בשניות. |
דוגמאות
המכשיר עובר שטיפה למשך 5 דקות נוספות, והפעולה תתבצע בעוד 20 דקות.
{ "currentRunCycle": [ { "currentCycle": "rinse", "lang": "en" } ], "currentTotalRemainingTime": 1200, "currentCycleRemainingTime": 300 }
המכשיר עובר שטיפה למשך 5 דקות נוספות, לפני המעבר לסיבוב.
{ "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 }
פקודות מכשיר
ללא.
התראות במכשיר
מכשירים עם התכונה הזו עשויים להחזיר את המטען הייעודי (payload) הבא במסגרת שינוי מצב המכשיר. מידע נוסף על הטמעת התראות זמין במאמר התראות על פעולות לבית חכם.
שדות | Type | תיאור |
---|---|---|
RunCycle |
חובה. מטען ייעודי (payload) של התראה. |
|
תמיכה באחת מהאפשרויות הבאות: | ||
0
|
אובייקט |
כרטיס החיפוש עודכן |
priority |
Integer |
חובה. רמת החשיפה. הערך הנתמך כעת הוא 0, דבר שמצביע על כך שיש לומר את ההתראה בקול. |
status |
String |
חובה. התוצאה של הפעולה. ערכים נתמכים:
|
currentCycleRemainingTime |
Integer |
חובה. הזמן שנותר במחזור הנוכחי, בשניות. |
1
|
אובייקט |
כשל |
priority |
Integer |
חובה. רמת החשיפה. הערך הנתמך כעת הוא 0, דבר שמצביע על כך שיש לומר את ההתראה בקול. |
status |
String |
חובה. התוצאה של הפעולה. ערכים נתמכים:
|
errorCode |
String |
חובה. הערך של המאפיין הזה יכול להיות כל קוד שגיאה, למשל |
דוגמאות
המכשיר סיים לפעול.
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
אירעה שגיאה במהלך המחזור הנוכחי.
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }