הסכימה של מאפיין TransportControl לבית חכם
action.devices.traits.TransportControl
– המאפיין הזה משמש למכשירים שיכולים לשלוט בהפעלת מדיה (לדוגמה, להמשיך את המוזיקה כשהיא מושהית).
מאפייני המכשיר
מכשירים עם המאפיין הזה עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC
. למידע נוסף על טיפול בכוונות מסוג SYNC
, ראו ביצוע כוונות.
מאפיינים | סוג | תיאור |
---|---|---|
transportControlSupportedCommands |
מערך |
חובה. רשימה של מחרוזות שמתארות את פקודות בקרת התעבורה הנתמכות במכשיר הזה. |
[item, ...] |
String |
הפקודות הנתמכות. ערכים נתמכים:
|
דוגמאות
מכשירים שתומכים בפקודות הפעלה
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
מצבי המכשיר
ללא.
פקודות למכשיר
מכשירים עם המאפיין הזה עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE
. למידע נוסף על טיפול בכוונות מסוג EXECUTE
, ראו ביצוע כוונות.
action.devices.commands.mediaStop
משהים את ההפעלה של המדיה.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "STOP" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
דילוג לפריט המדיה הבא.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "NEXT" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
דילוג לפריט המדיה הקודם.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
משהים את ההפעלה של המדיה.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "PAUSE" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
ממשיכים את ההפעלה של המדיה.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "RESUME" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
חיפוש מיקום יחסי.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
relativePositionMs |
Integer |
חובה. אלפיות השנייה של ההתקדמות (מספר שלם חיובי) או הנסיגה (מספר שלם שלילי) שרוצים לעבור. |
דוגמאות
דילוג 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" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
absPositionMs |
Integer |
חובה. אלפית השנייה של המיקום המוחלט שאליו רוצים לעבור. |
דוגמאות
דילוג ל-30 שניות
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
הגדרת מצב ההפעלה החוזרת.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
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" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
ללא פרמטרים
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
מפעילים כתוביות.
כדי להשתמש בפקודה הזו, צריך את המאפיינים הבאים:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
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" ] }
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
אין נכסים |
דוגמאות
השבתת הכתוביות
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }