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 Temperatureinstellungen von Smart-Home-Geräten

action.devices.traits.TemperatureControl – Attribut für Geräte (außer Thermostate), die die Temperatur im Gerät oder in der Nähe steuern.

Dies unterscheidet sich vom Attribut TemperatureSetting, das speziell für die Steuerung von Thermostaten vorgesehen ist. Das Merkmal TemperatureSetting stellt die Umgebungstemperatur (Raum/Außenbereich) dar und sollte nicht zur Steuerung der Temperatur eines bestimmten Geräts verwendet werden. Um die Temperatur eines bestimmten Geräts zu regeln, müssen Sie das Attribut TemperatureControl verwenden.

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
temperatureRange Objekt

Erforderlich.

Der unterstützte Temperaturbereich des Geräts.

minThresholdCelsius Number

Erforderlich.

Minimale Temperatur für den Bereich in Grad Celsius.

maxThresholdCelsius Number

Erforderlich.

Höchsttemperatur für den Bereich in Grad Celsius.

temperatureStepCelsius Number

Gibt den relativen Temperaturschritt an. Das Mindestintervall für die Anpassung, das vom Gerät unterstützt wird. Wenn nicht angegeben, werden relative Schritte als Prozentsatz von temperatureRange berechnet.

temperatureUnitForUX String

Erforderlich.

Temperatureinheit, die in Antworten an den Nutzer verwendet wird.

Unterstützte Werte:

C
F
commandOnlyTemperatureControl 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.

queryOnlyTemperatureControl Boolesch

(Standard: false)

Erforderlich, wenn das Gerät die Ausführung nur für Abfragen unterstützt. Dieses Attribut gibt an, ob das Gerät nur für Statusinformationen abgefragt werden kann und nicht gesteuert werden kann.

Beispiele

Das Gerät unterstützt die Steuerung in 5-Grad-Schritten zwischen 150 und 500 Grad.

{
  "temperatureRange": {
    "minThresholdCelsius": 65.5,
    "maxThresholdCelsius": 260
  },
  "temperatureStepCelsius": 2.778,
  "temperatureUnitForUX": "F"
}

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
temperatureSetpointCelsius Number

Der aktuelle Temperatursollwert in Grad Celsius. Muss innerhalb von temperatureRange liegen. Erforderlich, wenn queryOnlyTemperatureControl auf false festgelegt ist

temperatureAmbientCelsius Number

Die aktuell beobachtete Temperatur in Grad Celsius. Muss innerhalb von temperatureRange liegen.

Beispiele

Auf welche Temperatur ist das Gerät eingestellt?

{
  "temperatureSetpointCelsius": 150
}

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

Stelle die Temperatur auf einen bestimmten Wert.

Parameter

Parameter Typ Beschreibung
temperature Number

Erforderlich.

Die festzulegende Temperatur in Grad Celsius. Muss innerhalb von temperatureRange liegen.

Beispiele

Stelle das Gerät auf 350 Grad Celsius.

{
  "command": "action.devices.commands.SetTemperature",
  "params": {
    "temperature": 176.67
  }
}

Beim Festlegen der Zieltemperatur ist ein Fehler aufgetreten.

Unterstützte Werte:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Beispieläußerungen

de-DE

  • Erhöhe die Temperatur des Ofens
  • Stelle die Temperatur des Ofens auf 425 Grad

en-US

  • I want the temperature of the oven higher
  • set the oven to 400

es-ES

  • pon la temperatura del horno a 180 grados
  • sube la temperatura del horno

fr-FR

  • Mets la température du four à 180 degrés .
  • augmente la température du four

hi-IN

  • ओवन का तापमान 425 डिग्री पर करें

it-IT

  • Alza la temperatura del forno
  • metti il forno a 200 gradi

ja-JP

  • オーブン の温度を 425度 に設定して
  • オーブン の温度を上げて

ko-KR

  • 오븐 온도 180 도로 맞춰
  • 오븐 온도 좀 높여 줄래

nl-NL

  • stel de oven in op 220 graden
  • verhoog de temperatuur van de oven

pt-BR

  • ajuste a temperatura do forno para 180 graus
  • aumenta a temperatura do forno
  • aumentar a temperatura do forno
  • define a temperatura do termostato nos 22 graus

sv-SE

  • höj temperaturen i ugnen
  • sätt ugnen 100 grader

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen