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.

Die verfügbaren Kanäle sollten während der SYNC-Datei über das Attribut 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: false) 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 availableChannels entspricht.
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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen