Schemat zadania inteligentnego kanału domowego

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

Podczas udostępniania za pomocą atrybutu availableChannels dostępne kanały powinny być udostępniane jako lista na użytkownika lub urządzenia. Powinna ona zawierać wszystkie popularne lub popularne kanały, które subskrybuje użytkownik lub urządzenie. Aby czas oczekiwania na odpowiedź był niski, zalecamy utworzenie krótkiej listy kanałów (maksymalnie 30 kanałów).

ATTRIBUTES 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

Wymagane.

Lista obiektów opisujących dostępne kanały multimedialne 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 String

Wymagane.

Unikalny identyfikator tego kanału. Niewidoczne dla użytkowników.

names Tablica

Wymagane.

Lista nazw kanałów widocznych dla użytkowników.

[item, ...] String

Nazwa kanału

number String

Opcjonalny identyfikator numeryczny 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 (prawda), 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.

Urządzenie CommandS

W ramach operacji EXECUTE urządzenia z tą cechą mogą reagować 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 jedną z tych wartości:

Wybierz kanał według identyfikatora

Parametry Typ Opis
channelCode String

Wymagane.

Unikalny identyfikator żądanego kanału pasujący do jednego z identyfikatorów availableChannels.

channelName String

Przyjazna dla użytkownika nazwa żądanego kanału.

channelNumber String

Liczbowy identyfikator żądanego kanału.

Wybierz kanał według numeru

Parametry Typ Opis
channelNumber String

Wymagane.

Liczbowy identyfikator żądanego kanału.

Przykłady

Zmień na KTVU

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

Przejdź na kanał 3

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

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

Wymagane.

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

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

Obsługiwane wartości:

channelSwitchFailed

action.devices.commands.returnChannel

Wróć na kanał poprzedni lub poprzedni.

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Wróć do ostatniego kanału

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

Podczas powrotu do ostatniego kanału urządzenia wystąpił błąd.

Obsługiwane wartości:

channelSwitchFailed

Urządzenie ERRORS

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