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 für die Energiespeicherung von Smart Homes

action.devices.traits.EnergyStorage – Diese Eigenschaft gehört zu Geräten, die Energie in einem Akku speichern und möglicherweise aufladen können, oder zu Geräten, die ein anderes Gerät laden können.

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
queryOnlyEnergyStorage Boolesch

Erforderlich.

Dieser Wert ist „True“, wenn das Gerät nur Abfragen zu den gespeicherten Energiepegeln und optional zum aktiven Ladestatus unterstützt (abhängig vom isRechargeable-Attribut), aber das Starten und Beenden des Ladevorgangs nicht unterstützt.

energyStorageDistanceUnitForUX String

(Standard: "KILOMETERS")

Wird als Antwort auf den Nutzer verwendet.

Unterstützte Werte:

KILOMETERS
MILES
isRechargeable Boolesch

(Standard: false)

Setze den Wert auf „true“, wenn das Gerät wiederaufladbar ist. Das bedeutet, dass das Gerät möglicherweise den Status capacityUntilFull, isCharging und optional isPluggedIn meldet und den Befehl Charge akzeptieren kann.

Beispiele

Aufladbares Gerät

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

Aufladbares Gerät, auf dem der aktuelle Akkustand in Meilen angezeigt wird

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

Nicht tragbares Gerät, das nur die Anzeige des aktuellen Ladestands unterstützt

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
descriptiveCapacityRemaining String

Erforderlich.

Eine qualitative Beschreibung der Energiekapazität. Das ist der Fall, wenn keine numerischen Kapazitätsdaten vorhanden sind. Wenn auch numerische Kapazitätsdaten verfügbar sind, werden sie nach Möglichkeit gegenüber der Beschreibung bevorzugt.

Unterstützte Werte:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Array mit Einheiten/Wert-Paaren, die Informationen über die momentan vom Gerät enthaltene Energiekapazität enthalten. Beispiele: Wie viele Kilometer hat mein <device> momentan oder Wie viel Prozent meines Akkus hat mein <device>?

[item, ...] Objekt

Verbleibende Kapazität in Einheits- und Wertpaar.

rawValue Ganzzahl

Erforderlich.

Der Kapazitätswert.

unit String

Erforderlich.

Die Kapazitätseinheit.

Unterstützte Werte:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

Array mit Einheiten/Wert-Paaren, die Informationen über die Kapazität enthalten, bis das Gerät vollständig geladen ist Beispiel: Wie lange dauert es, bis <device> vollständig aufgeladen ist?

[item, ...] Objekt

Kapazität bis zum Aufladen.

rawValue Ganzzahl

Erforderlich.

Der Kapazitätswert.

unit String

Erforderlich.

Die Kapazitätseinheit.

Unterstützte Werte:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Boolesch

Gibt an, ob das Gerät gerade geladen wird.

isPluggedIn Boolesch

Gibt an, ob das Gerät momentan angeschlossen ist. Das Gerät kann angeschlossen werden, aber nicht aktiv geladen werden.

Beispiele

Aufladbares Gerät

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Aufladbares Gerät, auf dem der aktuelle Akkustand in Meilen angezeigt wird

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Nicht tragbares Gerät, das nur die Anzeige des aktuellen Ladezustands unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

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.Charge

Starten oder beenden Sie den Ladevorgang.

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "isRechargeable": true
}

Parameter

Parameter Typ Beschreibung
charge Boolesch

Erforderlich.

Mit „true“ wird der Ladevorgang gestartet, mit „false“ wird der Ladevorgang beendet.

Beispiele

Ladebefehl starten

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Ladebefehl beenden

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen

deviceUnplugged: Der Nutzer hat versucht, ein Gerät zu laden, das nicht an die Stromversorgung angeschlossen ist.