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:

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"
  ]
}

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: false)

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

BŁĘDY urządzenia

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