סכימת תכונות RunCycle לבית חכם

action.devices.traits.RunCycle – התכונה הזו מייצגת כל מכשיר שמשך הפעולה שלו הוא מתמשך, וניתן לשלוח שאילתות לגביו.

מכשירים כאלה ידווחו על מספר המחזורים הכולל שלהם בתחילת הפעולה, וכל מחזור שבו המכשיר נמצא כרגע בזמן שהוא פועל. כך המשתמש יכול לשלוח שאילתות, למשל:

• באיזה מחזור פועל המייבש שלי?
• כמה מחזורים נותרו למדיח הכלים?
• מה המייבש?
• מתי הכביסה תסתיים?

במכשירים מסוימים יש משך זמן בפורמט לא מחזורי. כל מכשיר פועל במשך פרק זמן מסוים יכול לדווח על הזמן שנותר, מבלי למחזורים שונים. כך תוכלו גם לטפל במקרים שבהם המחזורים לא עקביים (לדוגמה, יכול להיות שמדיחי הכלים לא יפעלו בכל המחזורים. למשל, משתמש יכול לשאול, איך ושואב האבק שלי יפעל למשך זמן ארוך יותר? דבר שיחזיר את משך הזמן ביחידות ביחס לזמן שנותר. ההגדרה הזו חלה גם על המכשירים שמופיעים למעלה; כמה זמן הבגדים שלי יתייבו? הפונקציה תחזיר את משך הזמן בדקות.

מכשירים יכולים להחזיר את מה שהם יודעים, ותגובת Assistant TTS תיצור התשובה הטובה ביותר עם הנתונים הזמינים (לדוגמה, מדיח הכלים פועל תושלם בעוד כ-20 דקות.)

RunCycle הוא תכונה לקריאה בלבד - אין לה פקודות, אלא רק מצבים שאילתה. בעתיד, ייתכן שיהיו מנגנונים להפעלה מחדש של מחזורים או לדילוג על שלב מחזורים (טוב לממטרים, לא טוב למכונות כביסה).

מאפייני המכשיר

ללא.

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה QUERY. למידה מידע נוסף על טיפול בכוונות של QUERY: מילוי Intent.

מדינות	סוג	תיאור
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
}

CommandS במכשיר

ללא.

התראות במכשיר

מכשירים עם התכונה הזו עשויים להחזיר את הפריטים הבאים מטען ייעודי (payload) של התראות כחלק משינוי מצב במכשיר. למידה מידע נוסף על הטמעת התראות זמין במאמר התראות על פעולות בבית חכם.

שדות	סוג	תיאור
RunCycle		חובה. מטען ייעודי (payload) של התראות.
תמיכה באחד מהקריטריונים הבאים:
0	מפגע	הפעולה הצליחה
priority	Integer	חובה. מייצג את רמת ההתראה. הערך הנתמך כרגע הוא 0, שמציין שצריך לומר את ההתראה בקול.
status	String	חובה. תוצאת הפעולה. ערכים נתמכים: SUCCESS
currentCycleRemainingTime	Integer	חובה. הזמן שנותר במחזור הנוכחי, בשניות.
1	מפגע	כשל
priority	Integer	חובה. מייצג את רמת ההתראה. הערך הנתמך כרגע הוא 0, שמציין שצריך לומר את ההתראה בקול.
status	String	חובה. תוצאת הפעולה. ערכים נתמכים: FAILURE
errorCode	String	חובה. הערך יכול להיות כל קוד שגיאה של התכונה הזו, לדוגמה deviceStuck.

דוגמאות

המכשיר סיים לפעול.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

אירעה שגיאה בהשלמת המחזור הנוכחי.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

ERRORS במכשיר

ראה את הרשימה המלאה של שגיאות וחריגים.