Schemat funkcji Smart Home TransportControl

action.devices.traits.TransportControl – ta cecha jest używana w przypadku urządzeń, które mogą sterować odtwarzaniem multimediów (np. wznawiać odtwarzanie muzyki po wstrzymaniu odtwarzania).

Urządzenie ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule o realizacji intencji.

Atrybuty	Typ	Opis
transportControlSupportedCommands	Tablica	Wymagane. Lista ciągów tekstowych opisujących obsługiwane polecenia sterowania przesyłaniem 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.

CommandS na urządzeniu

Urządzenia z tą cechą mogą reagować na podane niżej polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule o realizacji 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. Wartość do przewinięcia w milisekundach od wartości do przodu (dodatnia liczba całkowita) lub do tyłu (ujemna liczba całkowita).

Przykłady

Przejście 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

Szukaj pozycji absolutnej.

To polecenie wymaga tych atrybutów:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parametry

Parametry	Typ	Opis
absPositionMs	Liczba całkowita	Wymagane. Milisekunda bezwzględnej pozycji do przewinięcia.

Przykłady

Przejdź do 30 s

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

action.devices.commands.mediaRepeatMode

Ustaw tryb powtarzania odtwarzania.

To polecenie wymaga tych atrybutów:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parametry

Parametry	Typ	Opis
isOn	Wartość logiczna	Wymagane. Prawda, aby włączyć tryb powtarzania, fałsz, aby wyłączyć tryb powtarzania.
isSingle	Wartość logiczna	(Domyślnie: false) Jeśli określisz wartość true, oznacza to 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
  }
}

Powtarzaj wyłączone

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

Powtarzanie pojedynczej ścieżki

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

action.devices.commands.mediaShuffle

Odtwarzaj losowo bieżącą playlistę.

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 napisów.
userQueryLanguage	String	Język lub region 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 z zapytaniem użytkownika w języku angielskim (USA)

{
  "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.