סכימת תכונות של תחבורה חכמה לבית

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"
  ]
}

מכשיר STATES

ללא.

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

כדאי לעיין ברשימה המלאה של שגיאות וחריגים.