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

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

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

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

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

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

דוגמאות

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

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

מצבי המכשיר

ללא.

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

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

action.devices.commands.selectChannel

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

פרמטרים

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

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

פרמטרים	סוג	תיאור
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

ERRORS במכשיר

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