הסכימה של מאפיין TransportControl לבית חכם

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

מאפייני המכשיר

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

מאפיינים סוג תיאור
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"
  ]
}

פרמטרים

פרמטרים סוג תיאור

אין נכסים

דוגמאות

ללא פרמטרים

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

(ברירת המחדל: 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"
  ]
}

פרמטרים

פרמטרים סוג תיאור

אין נכסים

דוגמאות

ללא פרמטרים

{
  "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": {}
}

שגיאות במכשיר

הרשימה המלאה של השגיאות והחריגות