Schemat inteligentnego kanału głównego

action.devices.traits.Channel – ten atrybut należy do urządzeń, które obsługują kanały telewizyjne na urządzeniu multimedialnym.

Podczas SYNC dostępne kanały należy udostępnić jako listę według użytkownika lub urządzenia za pomocą atrybutu availableChannels. Lista powinna zawierać wszystkie popularne i popularne kanały zasubskrybowane przez użytkownika lub urządzenie. Aby uniknąć małego opóźnienia zapytania, zalecamy tworzenie krótkiej listy kanałów (maksymalnie 30 kanałów).

ATRYBUTY 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
availableChannels	Tablica	Wymagany. Lista obiektów opisujących dostępne kanały multimediów dla tego urządzenia. Każdy element opisuje kanał, który użytkownik może wybrać na tym urządzeniu.
[item, ...]	Obiekt	Dostępny kanał komunikacji.
key	Ciąg	Wymagany. Unikalny identyfikator tego kanału. Niewidoczne dla użytkowników.
names	Tablica	Wymagany. Lista nazw kanałów widocznych dla użytkowników.
[item, ...]	Ciąg	Nazwa kanału
number	Ciąg	Opcjonalny identyfikator numeryczny dla tego kanału.
commandOnlyChannels	Wartość logiczna	(domyślnie: false) Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość „true”, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu.

Przykłady

Urządzenie obsługujące 2 kanały.

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

Urządzenie STATES

Brak.

Polecenie urządzenia

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

action.devices.commands.selectChannel

Ustaw bieżący kanał na określoną wartość.

Parametry

Ładunek zawiera jeden z tych elementów:

Wybierz kanał według identyfikatora

Parametry	Typ	Opis
channelCode	Ciąg	Wymagany. Unikalny identyfikator żądanego kanału pasujący do jednego z elementów availableChannels.
channelName	Ciąg	Przyjazna dla użytkownika nazwa żądanego kanału.
channelNumber	Ciąg	Identyfikator numeryczny żądanego kanału.

Wybierz kanał według numeru

Parametry	Typ	Opis
channelNumber	Ciąg	Wymagany. Identyfikator numeryczny żądanego kanału.

Przykłady

Zmień na KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

Przejdź do trzeciego kanału.

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

Powiązane błędy

Podczas wybierania nowego kanału na urządzeniu wystąpił błąd.

Obsługiwane wartości:

noAvailableChannel

noChannelSubscription

channelSwitchFailed

action.devices.commands.relativeChannel

Dostosuj bieżący kanał o względną kwotę.

Parametry

Parametry	Typ	Opis
relativeChannelChange	Liczba całkowita	Wymagany. Liczba kanałów do zwiększenia lub zmniejszenia.

Przykłady

Przełącz się na następny kanał

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

Przełączanie się na poprzedni kanał

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

Powiązane błędy

Podczas dostosowywania kanału urządzenia wystąpił błąd.

Obsługiwane wartości:

channelSwitchFailed

action.devices.commands.returnChannel

Wróć do ostatniego lub poprzedniego kanału, z którego korzysta użytkownik.

Parametry

Parametry	Typ	Opis
Brak właściwości

Przykłady

Powrót do ostatniego kanału

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

Powiązane błędy

Wystąpił błąd podczas powrotu do ostatniego kanału na urządzeniu.

Obsługiwane wartości:

channelSwitchFailed

Urządzenie ERRORS

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