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": {}
}