סכימה של מסלול אופניים ביתיים חכמים

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

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

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

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

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

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

ATTRIBUTES במכשיר

ללא.

מצבים של המכשיר

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

מדינות	Type	תיאור
currentRunCycle	מערך	חובה. מכיל את המילים הנרדפות למחזור הנוכחי בכל אחת מהשפות הנתמכות.
[item, ...]	אובייקט	שמות מילים נרדפות למחזור.
currentCycle	מחרוזת	חובה. המחזור הנוכחי מתבצע.
nextCycle	מחרוזת	אופציונלי. המחזור הבא לביצוע.
lang	מחרוזת	חובה. קוד השפה של שמות המחזורים שצוינו. שפות נתמכות
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	מחרוזת	חובה. התוצאה של הפעולה. ערכים נתמכים: SUCCESS
currentCycleRemainingTime	Integer	חובה. הזמן שנותר במחזור הנוכחי, בשניות.
1	אובייקט	כשל
priority	Integer	חובה. רמת החשיפה. הערך הנתמך כעת הוא 0, דבר שמצביע על כך שיש לומר את ההתראה בקול.
status	מחרוזת	חובה. התוצאה של הפעולה. ערכים נתמכים: FAILURE
errorCode	מחרוזת	חובה. הערך של המאפיין הזה יכול להיות כל קוד שגיאה, למשל deviceStuck.

דוגמאות

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

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

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

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

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים