סכימה של תכונות בערוץ הבית החכם
action.devices.traits.Channel
– התכונה הזו שייכת למכשירים שתומכים בערוצי טלוויזיה במכשיר מדיה.
availableChannels
. הרשימה הזו צריכה לכלול את כל הערוצים הפופולריים או הפופולריים שהמשתמש או המכשיר רשומים אליהם. כדי לוודא שזמן האחזור של שאילתה יהיה נמוך, מומלץ להגביל את רשימת הערוצים (עד 30 ערוצים או פחות).
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
availableChannels |
מערך |
חובה. רשימת אובייקטים המתארים ערוצי מדיה זמינים למכשיר מסוים. כל פריט מתאר ערוץ שהמשתמש יכול לבחור במכשיר הזה. |
[item, ...] |
אובייקט |
ערוץ מדיה זמין. |
key |
String |
חובה. מזהה ייחודי לערוץ הזה. לא נחשף למשתמשים. |
names |
מערך |
חובה. רשימת שמות הגלויים למשתמש עבור הערוץ הזה. |
[item, ...] |
String |
שם הערוץ. |
number |
String |
מזהה מספרי אופציונלי לערוץ הזה. |
commandOnlyChannels |
בוליאני |
(ברירת מחדל: מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-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 |
חובה. מזהה ייחודי של הערוץ המבוקש, שתואם לאחד מתוך |
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