欢迎使用 Google Home 开发者中心,这是一个学习如何开发智能家居 Action 的新平台。注意:构建 Action 的工作仍需在 Actions 控制台中完成。

智能家居 OnOff 特征架构

action.devices.traits.OnOff - 适用于具有二进制文件开启或关闭的所有设备的基本开启和关闭功能,包括插头和开关,以及日后推出的许多设备。

设备属性

具有此特征的设备可以在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent,请参阅 intent 执行方式

属性 类型 说明
commandOnlyOnOff Boolean

(默认:false

指示设备是否只能通过命令控制,且无法查询状态信息。

queryOnlyOnOff Boolean

(默认:false

指示设备是否只能查询状态信息,且无法通过命令控制。

示例

支持开启/关闭命令和报告状态的设备

{
  "commandOnlyOnOff": false,
  "queryOnlyOnOff": false
}

仅支持开启/关闭命令的设备

{
  "commandOnlyOnOff": true,
  "queryOnlyOnOff": false
}

仅支持报告开启/关闭状态的设备(通常是传感器)。

{
  "queryOnlyOnOff": true,
  "commandOnlyOnOff": false
}

设备状态

具有此特征的实体可以在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent,请参阅 intent 执行方式

类型 说明
on Boolean

设备是否具有开启/关闭开关。

示例

设备是否处于开启状态?

{
  "on": true
}

设备处于关闭状态吗?

{
  "on": false
}

设备命令

具有此特征的设备可能会在 EXECUTE 操作中响应以下命令。如需详细了解如何处理 EXECUTE intent,请参阅 intent 执行方式

action.devices.commands.OnOff

开启或关闭设备。

参数

参数 类型 说明
on Boolean

必填。

是开启还是关闭设备。

示例

开启设备

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": true
  }
}

关闭设备。

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": false
  }
}

示例话语

de-DE

  • Bitte Licht aus
  • Bitte das Wohnzimmer einschalten
  • Bitte die Küche ausstellen
  • Ist der Staubsauger an
  • Ist in der Küche noch was an
  • Lampen an

en-US

  • are the lights off
  • turn off the AC
  • turn on my lights
  • what is on in the kitchen ?

es-ES

  • enciende el robot de limpieza
  • enciéndeme el salón

fr-FR

  • Tu peux éteindre le salon ?
  • allume la chambre
  • allume les lumières
  • est-ce que la lumière de la cuisine est éteinte
  • qu'est-ce qui est allumé dans la cuisine
  • éteins les lumières

hi-IN

  • किचन को ऑन करो
  • किचन में कुछ ऑन है?
  • बत्तियाँ जला दें
  • बालकनी ऑफ कर दो
  • लाइट आन है क्या
  • लाइट ऑफ करो

it-IT

  • Accendimi la luce in cucina
  • Ho spento la luce in bagno ?
  • accendere in cucina
  • ho lasciato il bagno acceso?
  • spegni la luce della camera
  • spengi camera bimbi

ja-JP

  • エアコン はついてる
  • キッチン で何がオンになっていますか
  • ベッドルーム をつけて
  • リビング をオフにして
  • 照明 をオンにして
  • 照明 を消して

ko-KR

  • 거실 꺼 줘
  • 거실 에어컨 전원 켜
  • 거실 켜 줘
  • 켜져 있어
  • 에어컨 전원 꺼 줘
  • 주방 에 뭐 켜져 있어

nl-NL

  • babykamer aandoen
  • doe het licht aan
  • doe het licht uit
  • staat de droger aan
  • staat er iets aan in de keuken

pt-BR

  • Acender a luz .
  • Apagar a luz .
  • a sala está apagada?
  • acender a sala
  • eu apaguei luz do quarto ?
  • quero desligar o quarto

sv-SE

  • stäng av lampan
  • sätt på ljuset
  • vad är på i badrummet
  • Är badrumslampan på?

设备错误

查看错误和异常的完整列表。