Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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

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

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": {}
}

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.