הסכימה של מאפיין 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": {}
}