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

‫action.devices.traits.Channel – המאפיין הזה שייך למכשירים שתומכים בערוצי טלוויזיה במכשיר מדיה.

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

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

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

מאפיינים	סוג	תיאור
availableChannels	מערך	חובה. רשימת אובייקטים שמתארים את ערוצי המדיה שזמינים במכשיר הספציפי הזה. כל פריט מתאר ערוץ שהמשתמש יכול לבחור במכשיר הזה.
[item, ...]	אובייקט	ערוץ מדיה זמין.
key	String	חובה. מזהה ייחודי של הערוץ. לא מוצג למשתמשים.
names	מערך	חובה. רשימה של שמות שגלויים למשתמשים בערוץ הזה.
[item, ...]	String	שם הערוץ.
number	String	מזהה מספרי אופציונלי של הערוץ.
commandOnlyChannels	בוליאני	(ברירת מחדל: false) מציין אם המכשיר תומך בשימוש בתקשורת חד-כיוונית (true) או דו-כיוונית (false). מגדירים את המאפיין הזה כ-True אם המכשיר לא יכול להגיב לאינטנט QUERY או ל-Report State עבור התכונה הזו.

דוגמאות

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

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

מצבי המכשיר

ללא.

פקודות למכשיר

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

action.devices.commands.selectChannel

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

פרמטרים

המטען הייעודי (payload) מכיל את אחד מהערכים הבאים:

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

פרמטרים	סוג	תיאור
channelCode	String	חובה. מזהה ייחודי של הערוץ המבוקש, שזהה לאחד מהמזהים availableChannels.
channelName	String	שם הערוץ המבוקש, שקל להבין.
channelNumber	String	מזהה מספרי של הערוץ המבוקש.

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

פרמטרים	סוג	תיאור
channelNumber	String	חובה. מזהה מספרי של הערוץ המבוקש.

דוגמאות

החלפה ל-KTVU

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

עבור לערוץ שלוש.

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

שגיאות קשורות

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

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

noAvailableChannel

noChannelSubscription

channelSwitchFailed

action.devices.commands.relativeChannel

שינוי הערוץ הנוכחי בסכום יחסי.

פרמטרים

פרמטרים	סוג	תיאור
relativeChannelChange	Integer	חובה. מספר הערוצים להגדלה או להקטנה.

דוגמאות

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

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

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

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

שגיאות קשורות

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

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

channelSwitchFailed

action.devices.commands.returnChannel

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

פרמטרים

פרמטרים	סוג	תיאור
אין נכסים

דוגמאות

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

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

שגיאות קשורות

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

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

channelSwitchFailed

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

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