Schema des Smart-Home-Kanals
action.devices.traits.Channel
: Diese Eigenschaft gehört zu Geräten, die TV-Kanäle auf einem Mediengerät unterstützen.
availableChannels
als Liste, pro Nutzer oder Gerät freigegeben werden. Diese Liste sollte alle Top- oder beliebten Kanäle enthalten, die der Nutzer oder das Gerät abonniert hat. Damit die Abfragelatenz gering ist, sollte die Kanalliste klein gehalten werden (maximal 30 Kanäle).
Gerät ATTRIBUTE
Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC
die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
availableChannels |
Array |
Erforderlich. Liste der Objekte, die die verfügbaren Medienkanäle für dieses Gerät beschreiben. Jedes Element beschreibt einen Kanal, den der Nutzer auf diesem Gerät auswählen kann. |
[item, ...] |
Objekt |
Verfügbarer Medienkanal. |
key |
String |
Erforderlich. Eindeutige Kennung für diesen Kanal. Nicht für Nutzer sichtbar. |
names |
Array |
Erforderlich. Liste der für den Nutzer sichtbaren Namen für diesen Kanal. |
[item, ...] |
String |
Kanalname |
number |
String |
Optionale numerische Kennung für diesen Kanal. |
commandOnlyChannels |
Boolesch |
(Standard: Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann. |
Beispiele
Gerät mit zwei Kanälen
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
Gerät STATES
Keine.
Gerätebefehle
Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.selectChannel
Legen Sie den aktuellen Kanal auf einen bestimmten Wert fest.
Parameter
Die Nutzlast enthält einen der folgenden Werte:
Kanal nach ID auswählen
Parameter | Typ | Beschreibung |
---|---|---|
channelCode |
String |
Erforderlich. Eindeutige Kennung für den angeforderten Kanal, die einem der |
channelName |
String |
Benutzerfreundlicher Name des angeforderten Kanals. |
channelNumber |
String |
Numerische Kennung für den angeforderten Kanal. |
Kanal nach Nummer auswählen
Parameter | Typ | Beschreibung |
---|---|---|
channelNumber |
String |
Erforderlich. Numerische Kennung für den angeforderten Kanal. |
Beispiele
Zu KTVU wechseln
{ "command": "action.devices.commands.selectChannel", "params": { "channelCode": "ktvu2", "channelName": "KTVU" } }
Wechsle zu Kanal 3.
{ "command": "action.devices.commands.selectChannel", "params": { "channelNumber": "3" } }
Ähnliche Fehler
Beim Auswählen eines neuen Kanals auf dem Gerät ist ein Fehler aufgetreten.
Unterstützte Werte:
noAvailableChannel
noChannelSubscription
channelSwitchFailed
action.devices.commands.relativeChannel
Den aktuellen Kanal um einen relativen Betrag anpassen.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
relativeChannelChange |
Ganzzahl |
Erforderlich. Die Anzahl der Kanäle, die erhöht oder verringert werden sollen. |
Beispiele
Zum nächsten Kanal wechseln
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } }
Zum vorherigen Kanal wechseln
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": -1 } }
Ähnliche Fehler
Beim Anpassen des Gerätekanals ist ein Fehler aufgetreten.
Unterstützte Werte:
channelSwitchFailed
action.devices.commands.returnChannel
Kehren Sie zum letzten/vorherigen Kanal zurück, in dem sich der Nutzer befand.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Keine Attribute |
Beispiele
Zurück zum letzten Kanal
{ "command": "action.devices.commands.returnChannel", "params": {} }
Ähnliche Fehler
Bei der Rückkehr zum letzten Kanal des Geräts ist ein Fehler aufgetreten.
Unterstützte Werte:
channelSwitchFailed