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.
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: 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 |
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" } }
Powiązane błędy
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 } }
Powiązane błędy
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": {} }
Powiązane błędy
Wystąpił błąd podczas powrotu do ostatniego kanału na urządzeniu.
Obsługiwane wartości:
channelSwitchFailed