Schema des Smart-Home-Kanals

action.devices.traits.Channel: Diese Eigenschaft gilt für Geräte, die TV-Kanäle auf einem Mediengerät unterstützen.

Die verfügbaren Kanäle sollten während der SYNC-Version über das Attribut availableChannels als Liste für jeden Nutzer oder jedes Gerät freigegeben werden. Die Liste sollte alle Top- oder beliebten Kanäle enthalten, die der Nutzer oder das Gerät abonniert hat. Wir empfehlen, die Channelliste auf maximal 30 Kanäle zu beschränken, um für eine niedrige Abfragelatenz zu sorgen.

Geräte-ATTRIBUTE

Geräte mit diesem Merkmal können im Rahmen des SYNC-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von 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 des Kanals.

[item, ...] String

Kanalname

number String

Optionale numerische Kennung für diesen Kanal.

commandOnlyChannels Boolesch

(Standard: false)

Gibt an, ob das Gerät die Verwendung von Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder einen Berichtstatus reagieren kann.

Beispiele

Gerät, das zwei Kanäle unterstützt

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

Gerätestatus

Keine.

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.selectChannel

Legen Sie für den aktuellen Kanal einen bestimmten Wert fest.

Parameter

Die Nutzlast enthält eine der folgenden Optionen:

Channel nach ID auswählen

Parameter Typ Beschreibung
channelCode String

Erforderlich.

Eindeutige Kennung des angeforderten Kanals, die mit einem der availableChannels übereinstimmt.

channelName String

Nutzerfreundlicher Name des angeforderten Kanals.

channelNumber String

Numerische Kennung des angeforderten Kanals.

Kanal nach Nummer auswählen

Parameter Typ Beschreibung
channelNumber String

Erforderlich.

Numerische Kennung des angeforderten Kanals.

Beispiele

Zu KTVU wechseln

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

Zu Kanal 3 wechseln.

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

Bei der Auswahl eines neuen Kanals auf dem Gerät ist ein Fehler aufgetreten.

Unterstützte Werte:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Aktuellen Kanal um einen bestimmten 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
  }
}

Beim Anpassen des Gerätekanals ist ein Fehler aufgetreten.

Unterstützte Werte:

channelSwitchFailed

action.devices.commands.returnChannel

Kehre zum letzten/vorherigen Kanal des Nutzers zurück.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Zurück zum letzten Kanal

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

Beim Zurückkehren zum letzten Kanal des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

channelSwitchFailed

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.