Schemat cechy systemu Smart Home TransportControl

action.devices.traits.TransportControl – ta cecha dotyczy urządzeń, które mogą sterować odtwarzaniem multimediów (np. wznawiać wstrzymane odtwarzanie muzyki).

Urządzenia – ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać te problemy jako część operacji SYNC. Aby się uczyć więcej informacji o obsłudze intencji SYNC znajdziesz tutaj Realizacja intencji.

Atrybuty Typ Opis
transportControlSupportedCommands Tablica

Wymagane.

Lista ciągów opisujących obsługiwane polecenia sterowania transportem na tym urządzeniu.

[item, ...] String

Obsługiwane polecenia.

Obsługiwane wartości:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Przykłady

Urządzenie obsługujące polecenia odtwarzania

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

Urządzenie STATES

Brak.

Polecenia na urządzeniu

Urządzenia z tą cechą mogą reagować na: w ramach operacji EXECUTE. Aby się uczyć więcej informacji o obsłudze intencji EXECUTE znajdziesz tutaj Realizacja intencji.

action.devices.commands.mediaStop

Wstrzymaj odtwarzanie multimediów.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

{
  "command": "action.devices.commands.mediaStop",
  "params": {}
}

action.devices.commands.mediaNext

Przejdź do następnego elementu multimedialnego.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

{
  "command": "action.devices.commands.mediaNext",
  "params": {}
}

action.devices.commands.mediaPrevious

Przejdź do poprzedniego elementu multimedialnego.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

{
  "command": "action.devices.commands.mediaPrevious",
  "params": {}
}

action.devices.commands.mediaPause

Wstrzymaj odtwarzanie multimediów.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

{
  "command": "action.devices.commands.mediaPause",
  "params": {}
}

action.devices.commands.mediaResume

Wznów odtwarzanie multimediów.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

{
  "command": "action.devices.commands.mediaResume",
  "params": {}
}

action.devices.commands.mediaSeekRelative

Przewiń do pozycji względnej.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parametry

Parametry Typ Opis
relativePositionMs Liczba całkowita

Wymagane.

Milisekundy przesunięcia do przodu (dodatnia int) lub wstecz (ujemnej int) do przewijania.

Przykłady

Przeskocz o 10 s do przodu

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

Przewijanie o 10 s do tyłu

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

Dąż do bezwzględnej pozycji.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parametry

Parametry Typ Opis
absPositionMs Liczba całkowita

Wymagane.

Milisekunda bezwzględnej pozycji przewijania.

Przykłady

Przewiń do 30 s

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

Ustaw tryb powtarzania.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parametry

Parametry Typ Opis
isOn Wartość logiczna

Wymagane.

True: włącza tryb powtarzania, fałsz – wyłącza tryb powtarzania.

isSingle Wartość logiczna

(Domyślnie: false)

Jeśli jest określona, wartość true oznacza włączenie trybu powtarzania pojedynczego elementu, a fałsz – włączenie normalnego trybu powtarzania (np. playlisty).

Przykłady

Powtarzaj w

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

Powtarzanie wyłączone

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": false
  }
}

Powtarzanie jednej ścieżki

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true,
    "isSingle": true
  }
}

action.devices.commands.mediaShuffle

Odtwarzam losowo bieżącą playlistę.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Brak parametrów

{
  "command": "action.devices.commands.mediaShuffle",
  "params": {}
}

action.devices.commands.mediaClosedCaptioningOn

Włącz napisy.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametry

Parametry Typ Opis
closedCaptioningLanguage String

Język lub region napisów.

userQueryLanguage String

Język lub region zapytania użytkownika.

Przykłady

Włączanie wyświetlania napisów w języku angielskim

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Włączanie wyświetlania napisów w języku koreańskim

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

Włączanie wyświetlania napisów w języku koreańskim z zapytaniami użytkownika w języku angielskim (amerykańskim)

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

Wyłącz napisy.

To polecenie wymaga następujących atrybutów:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Wyłączanie napisów

{
  "command": "action.devices.commands.mediaClosedCaptioningOff",
  "params": {}
}

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.