Schemat Trait inteligentnego domu Transport Control

action.devices.traits.TransportControl – ta funkcja jest używana w przypadku urządzeń, które mogą sterować odtwarzaniem multimediów (np. wznawianie odtwarzania wstrzymanej muzyki).

ATTRIBUTES urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji 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.

Urządzenie CommandS

W ramach operacji EXECUTE urządzenia z tą cechą mogą reagować na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.mediaStop

Wstrzymaj odtwarzanie multimediów.

To polecenie wymaga tych 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 tych 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 tych 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 tych 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 tych 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 tych atrybutów:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parametry

Parametry	Typ	Opis
relativePositionMs	Liczba całkowita	Wymagane. Milisekundy do przodu (liczba dodatnia) lub wstecz (ujemna liczba całkowita).

Przykłady

Do przodu o 10 s

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

Przejście do tyłu o 10 s

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

action.devices.commands.mediaSeekToPosition

Przejdź na pozycję bezwzględną.

To polecenie wymaga tych atrybutów:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parametry

Parametry	Typ	Opis
absPositionMs	Liczba całkowita	Wymagane. Milisekunda z pozycji bezwzględnej, do której należy przewinąć.

Przykłady

Przechodzenie do 30 sekund

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

action.devices.commands.mediaRepeatMode

Ustaw tryb powtarzania.

To polecenie wymaga tych atrybutów:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parametry

Parametry	Typ	Opis
isOn	Wartość logiczna	Wymagane. Wartość prawda powoduje włączenie trybu powtarzania, a fałsz – jego wyłączenie.
isSingle	Wartość logiczna	(Domyślnie: false) Jeśli zasada ma wartość Prawda, oznacza włączenie trybu powtarzania jednego elementu, a wartość fałsz – włączenie normalnego trybu powtarzania (np. playlisty).

Przykłady

Powtarzaj w dniu

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

Powtarzanie wyłączone

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

Powtórzenie jednej ścieżki audio

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

action.devices.commands.mediaShuffle

Odtwarzanie losowe playlisty.

To polecenie wymaga tych 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 tych atrybutów:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametry

Parametry	Typ	Opis
closedCaptioningLanguage	String	Język lub region dla napisów.
userQueryLanguage	String	Język lub region dla zapytania użytkownika.

Przykłady

Włączanie napisów w języku angielskim

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

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

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

Włączanie napisów w języku koreańskim za pomocą napisów w języku angielskim (Stany Zjednoczone)

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

action.devices.commands.mediaClosedCaptioningOff

Wyłącz napisy.

To polecenie wymaga tych 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.