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

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

חובה.

התוצאה של הפעולה.

ערכים נתמכים:

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 מכשיר

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