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

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

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

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

מאפיינים	סוג	תיאור
transportControlSupportedCommands	מערך	חובה. רשימת מחרוזות שמתארות פקודות לבקרת תעבורה נתמכות במכשיר הזה.
[item, ...]	String	פקודות נתמכות. ערכים נתמכים: CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

דוגמאות

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

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

מצבי המכשיר

ללא.

CommandS במכשיר

מכשירים עם התכונה הזו עשויים להגיב לבקשות הבאות פקודות כחלק מהפעולה EXECUTE. למידה מידע נוסף על טיפול בכוונות של EXECUTE: מילוי Intent.

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	חובה. אלפיות השנייה של הסכום קדימה (In-In) או אחורה (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"
  ]
}

פרמטרים

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

ERRORS במכשיר

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