סכימה של תכונות בערוץ הבית החכם

action.devices.traits.Channel – התכונה הזו שייכת למכשירים שתומכים בערוצי טלוויזיה במכשיר מדיה.

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

ATTRIBUTES במכשיר

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

מאפיינים Type תיאור
availableChannels מערך

חובה.

רשימת אובייקטים המתארים ערוצי מדיה זמינים למכשיר מסוים. כל פריט מתאר ערוץ שהמשתמש יכול לבחור במכשיר הזה.

[item, ...] אובייקט

ערוץ מדיה זמין.

key String

חובה.

מזהה ייחודי לערוץ הזה. לא נחשף למשתמשים.

names מערך

חובה.

רשימת שמות הגלויים למשתמש עבור הערוץ הזה.

[item, ...] String

שם הערוץ.

number String

מזהה מספרי אופציונלי לערוץ הזה.

commandOnlyChannels בוליאני

(ברירת מחדל: false)

מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת QUERY או למצב הדוח עבור התכונה הזו.

דוגמאות

מכשיר תומך בשני ערוצים.

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

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

ללא.

פקודות מכשיר

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

action.devices.commands.selectChannel

מגדירים את הערוץ הנוכחי לערך ספציפי.

פרמטרים

המטען הייעודי כולל אחד מהבאים:

בחירת ערוץ לפי מזהה

פרמטרים Type תיאור
channelCode String

חובה.

מזהה ייחודי של הערוץ המבוקש, שתואם לאחד מתוך availableChannels.

channelName String

שם ידידותי של הערוץ המבוקש.

channelNumber String

מזהה מספרי עבור הערוץ המבוקש.

בחירת ערוץ לפי מספר

פרמטרים Type תיאור
channelNumber String

חובה.

מזהה מספרי עבור הערוץ המבוקש.

דוגמאות

שינוי ל-KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

מעבר לערוץ מספר 3

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

אירעה שגיאה בבחירת ערוץ חדש במכשיר.

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

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

יש להתאים את הערוץ הנוכחי לפי סכום יחסי.

פרמטרים

פרמטרים Type תיאור
relativeChannelChange Integer

חובה.

מספר הערוצים להגדלה או להקטנה.

דוגמאות

מעבר לערוץ הבא

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

מעבר לערוץ הקודם

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

אירעה שגיאה בהתאמת הערוץ של המכשיר.

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

channelSwitchFailed

action.devices.commands.returnChannel

חזרה לערוץ האחרון/הקודם שבו המשתמש היה.

פרמטרים

פרמטרים Type תיאור

אין נכסים

דוגמאות

חזרה לערוץ האחרון

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

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

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

channelSwitchFailed

ERRORS מכשיר

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