סכימה של אמצעי תחבורה לבית חכם

action.devices.traits.TransportControl - התכונה הזו משמשת למכשירים שיכולים לשלוט בהפעלה של מדיה (לדוגמה, המשך המוזיקה בזמן שהיא מושהית).

ATTRIBUTES במכשיר

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

מאפיינים Type תיאור
transportControlSupportedCommands מערך

חובה.

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

[item, ...] String

פקודות נתמכות.

ערכים נתמכים:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

דוגמאות

מכשיר שתומך בפקודות הפעלה

{
  "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 בוליאני

(ברירת מחדל: false)

אם תציינו זאת, הערך 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": {}
}

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים