Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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"
  }
}

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
  }
}

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": {}
}

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