סכימה של אמצעי תחבורה לבית חכם
action.devices.traits.TransportControl
- התכונה הזו משמשת למכשירים שיכולים לשלוט בהפעלה של מדיה (לדוגמה, המשך המוזיקה בזמן שהיא מושהית).
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
transportControlSupportedCommands |
מערך |
חובה. רשימת מחרוזות שמתארות פקודות של אמצעי בקרה נתמכים לתחבורה במכשיר הזה. |
[item, ...] |
String |
פקודות נתמכות. ערכים נתמכים:
|
דוגמאות
מכשיר שתומך בפקודות הפעלה
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
מצבים של המכשיר
ללא.
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-EXECUTE
כוונות זמין בקטע מימוש כוונה.
action.devices.commands.mediaStop
השהיית ההפעלה של המדיה.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "STOP" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
דילוג לפריט המדיה הבא.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "NEXT" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
דילוג לפריט המדיה הקודם.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
השהיית ההפעלה של המדיה.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "PAUSE" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
הפעלה מחדש של המדיה.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "RESUME" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
דילוג למיקום יחסי.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
relativePositionMs |
Integer |
חובה. אלפיות שנייה של הסכום המקדים (מספר חיובי) או אחורה (מספר שלילי של Int). |
דוגמאות
דילוג 10 שניות קדימה
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
דילוג 10 שניות אחורה
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
דילוג למיקום מוחלט.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
absPositionMs |
Integer |
חובה. האלפיות השנייה של המיקום המוחלט שיש לחפש. |
דוגמאות
דילוג ל-30 שניות
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
הגדרה של מצב הפעלה חוזרת.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
isOn |
בוליאני |
חובה. הערך הוא True כדי להפעיל את מצב החזרה, או False כדי להשבית את מצב החזרה. |
isSingle |
בוליאני |
(ברירת מחדל: אם תציינו זאת, הערך True מציין הפעלה של מצב החזרה של פריט יחיד, הערך False מציין הפעלה של מצב החזרה הרגיל (לדוגמה, פלייליסט). |
דוגמאות
חזרה ב
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
חזרה כבויות
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
חזרה על טראק אחד
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
השמעה אקראית של הפלייליסט הנוכחי.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "SHUFFLE" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
הפעלת הכתוביות.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
closedCaptioningLanguage |
String |
שפה או שפה לכתוביות. |
userQueryLanguage |
String |
השפה או הלוקאל של שאילתת המשתמש. |
דוגמאות
הפעלת כתוביות באנגלית
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
הפעלת כתוביות בקוריאנית
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
הפעלת כתוביות בקוריאנית עם שאילתת משתמש באנגלית אמריקאית
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR", "userQueryLanguage": "en-US" } }
action.devices.commands.mediaClosedCaptioningOff
כיבוי הכתוביות.
פקודה זו מחייבת את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
השבתת הכתוביות
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }