Schemat cechy TransportControl w inteligentnym domu
action.devices.traits.TransportControl
– ta cecha jest używana na urządzeniach, które umożliwiają sterowanie odtwarzaniem multimediów (np. wznawianie odtwarzania muzyki, gdy jest ona wstrzymana).
ATRYBUTY URZĄDZENIA
Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC
. Więcej informacji o obsługiwaniu intencji SYNC
znajdziesz w artykule Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
transportControlSupportedCommands |
Tablica |
Wymagany. Lista ciągów znaków opisujących obsługiwane polecenia sterowania transportem na tym urządzeniu. |
[item, ...] |
String |
Obsługiwane polecenia Obsługiwane wartości:
|
Przykłady
Urządzenie obsługujące polecenia odtwarzania
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
STANOWISKO URZĄDZENIA
Brak.
Polecenia urządzenia
Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE
. Więcej informacji o obsługiwaniu intencji EXECUTE
znajdziesz w artykule 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
Przeszukaj względną pozycję.
To polecenie wymaga tych atrybutów:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
relativePositionMs |
Liczba całkowita |
Wymagany. Liczba milisekund, o którą przesunąć pozycję do przodu (dodatnia) lub do tyłu (ujemna). |
Przykłady
Przewiń do przodu o 10 sekund
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
Przewiń o 10 sekund do tyłu
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
Przejście do pozycji bezwzględnej.
To polecenie wymaga tych atrybutów:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
absPositionMs |
Liczba całkowita |
Wymagany. Pozycja bezwzględna w milisekundach, do której ma nastąpić przewinięcie. |
Przykłady
Przewiń do 30 sekund
{ "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 |
Wymagany. Prawda – włącza tryb powtarzania, fałsz – wyłącza tryb powtarzania. |
isSingle |
Wartość logiczna |
(wartość domyślna: Jeśli jest określony, wartość true oznacza włączenie trybu powtarzania pojedynczego elementu, a wartość false oznacza włączenie normalnego trybu powtarzania (np. playlisty). |
Przykłady
Powtarzaj w
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
Powtórzenie wyłączone
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
Powtarzanie pojedynczego utworu
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
losowo odtwarzać 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, w którym mają być wyświetlane napisy. |
userQueryLanguage |
String |
Język lub lokalizacja 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 (amerykańskim)
{ "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": {} }