Schemat cechy kanału inteligentnego domu

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

Dostępne kanały powinny być udostępniane jako lista na użytkownika lub urządzenie podczas synchronizacji za pomocą atrybutu availableChannels. Ta lista powinna zawierać wszystkie najpopularniejsze kanały, które subskrybuje użytkownik lub urządzenie. Aby zapewnić krótki czas oczekiwania na zapytanie, zalecamy, aby lista kanałów była krótka (do 30 kanałów).

ATRYBUTY urządzenia

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
availableChannels Tablica

Wymagane.

Lista obiektów opisujących dostępne kanały multimedialne na tym urządzeniu. 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. Nie jest widoczny dla użytkowników.
names Tablica

Wymagane.

Lista nazw tego kanału widocznych dla użytkownika.
[item, ...] String

Nazwa kanału
number String

Opcjonalny identyfikator numeryczny 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 true, jeśli urządzenie nie może odpowiadać na intencję QUERY ani na raportowanie stanu w przypadku tej cechy.

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

STANY 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łudze intencji EXECUTE znajdziesz w artykule 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, który pasuje do jednego z kanałów availableChannels.
channelName String

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

Identyfikator numeryczny żądanego kanału.

Wybierz kanał według numeru

Parametry Typ Opis
channelNumber String

Wymagane.

Identyfikator numeryczny żądanego kanału.

Przykłady

Przełącz na KTVU

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

Przełącz na kanał 3.

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

Wystąpił błąd podczas wybierania nowego kanału na urządzeniu.

Obsługiwane wartości:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Dostosuj bieżący kanał o wartość względną.

Parametry

Parametry Typ Opis
relativeChannelChange Liczba całkowita

Wymagane.

Liczba kanałów, o którą należy zwiększyć lub zmniejszyć wartość.

Przykłady

Przełącz na następny kanał

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

Przełącz na poprzedni kanał

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

Wystąpił błąd podczas dostosowywania kanału urządzenia.

Obsługiwane wartości:

channelSwitchFailed

action.devices.commands.returnChannel

Wróć do ostatniego lub poprzedniego kanału, który był oglądany przez użytkownika.

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Wróć do ostatniego kanału

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

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

Obsługiwane wartości:

channelSwitchFailed

BŁĘDY urządzenia

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