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.
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: 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 |
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" } }
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
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 } }
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
Wróć do ostatniego kanału
{ "command": "action.devices.commands.returnChannel", "params": {} }
Powiązane błędy
Podczas powrotu do ostatniego kanału na urządzeniu wystąpił błąd.
Obsługiwane wartości:
channelSwitchFailed