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

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

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