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.

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
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ł komunikacji.

key String

Wymagany.

Unikalny identyfikator tego kanału. Niedostępna dla użytkowników.

names Tablica

Wymagane.

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

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łudze intencji EXECUTE znajdziesz w artykule o realizacji intencji.

action.devices.commands.selectChannel

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

Parametry

Ładunek zawiera jedną z tych opcji:

Wybieranie kanału za pomocą identyfikatora

Parametry Typ Opis
channelCode String

Wymagane.

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 numeryczny kanału, którego dotyczy żądanie.

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

Zmień 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 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óć do ostatniego lub poprzedniego kanału, z którego korzystał 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

BŁĘDY urządzenia

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