Schemat atrybutu kanału inteligentnego domu

action.devices.traits.Channel – ta cecha dotyczy 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. Lista powinna zawierać wszystkie popularne lub najlepsze kanały, do których subskrypcję wykupił użytkownik lub urządzenie. Aby zapewnić krótki czas oczekiwania na zapytanie, zalecamy ograniczenie liczby kanałów na liście do 30 lub mniej.

Urządzenia – ATTRIBUTES

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
availableChannels Tablica

Wymagane.

Lista obiektów opisujących dostępne kanały multimedialne na danym urządzeniu. Każdy element opisuje kanał, który użytkownik może wybrać na tym urządzeniu.
[item, ...] Obiekt

Dostępny kanał multimedialny.
key String

Wymagane.

Unikalny identyfikator tego kanału. nie są widoczne dla użytkowników.
names Tablica

Wymagany.

Lista nazw tego kanału widocznych dla użytkowników.
[item, ...] String

Nazwa kanału
number String

Opcjonalny identyfikator numeryczny tego kanału.
commandOnlyChannels Wartość logiczna

(wartość domyślna: false)

Określa, czy urządzenie obsługuje komunikację w jednym kierunku (prawda) czy w obu kierunkach (fałsz). Ustaw ten atrybut na „PRAWDA”, jeśli urządzenie nie może odpowiadać na intencję QUERY ani nie może zgłaszać stanu dla 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"
    }
  ]
}

Urządzenie STATES

Brak.

Polecenia urządzenia

Urządzenia z tą cechą mogą reagować na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsługiwaniu intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.selectChannel

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

Parametry

Ładunek zawiera jeden z następujących elementów:

Wybierz kanał według identyfikatora

Parametry Typ Opis
channelCode String

Wymagany.

Unikalny identyfikator żądanego kanału, który pasuje do jednego z availableChannels.
channelName String

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

Identyfikator liczbowy żądanego kanału.

Wybieranie kanału według numeru

Parametry Typ Opis
channelNumber String

Wymagany.

Identyfikator numeryczny kanału, którego dotyczy żądanie.

Przykłady

Zmień na KTVU

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

Przełącz się 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

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

Parametry

Parametry Typ Opis
relativeChannelChange Liczba całkowita

Wymagany.

Liczba kanałów, które chcesz zwiększyć lub zmniejszyć.

Przykłady

Przełączanie 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óć do ostatniego/poprzedniego kanału, na którym znajdował się użytkownik.

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 na urządzeniu wystąpił błąd.

Obsługiwane wartości:

channelSwitchFailed

Urządzenie ERRORS

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