歡迎來到 Google Home 開發人員中心,你可以在這裡學習如何學習智慧型住宅動作。注意事項:您將在 Actions 主控台建構動作。

智慧型住宅無線交易結構定義

action.devices.traits.OnOff - 任何裝置均開啟/關閉基本功能,包括插座、開關以及日後推出的裝置。

裝置屬性

具此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖,請參閱意圖執行要求

屬性 類型 說明
commandOnlyOnOff 布林

(預設值:false)

表示裝置是否只能透過指令控管,無法查詢狀態資訊。

queryOnlyOnOff 布林

(預設值:false)

表示裝置是否只能查詢狀態資訊,且無法透過指令控管。

範例

支援開啟/關閉指令和回報狀態的裝置。

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

只支援開啟/關閉指令的裝置。

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

裝置 (通常為感應器) 僅支援開啟/關閉狀態。

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

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求

類型 說明
on 布林

表示裝置是否開啟開關。

範例

裝置是否開機?

{
  "on": true
}

裝置關機了嗎?

{
  "on": false
}

裝置指令

具有此特性的裝置可能會回應 EXECUTE 作業中的下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱意圖執行要求

action.devices.commands.OnOff

開啟或關閉裝置。

參數

參數 類型 說明
on 布林

必要。

開啟或關閉裝置。

範例

開啟裝置。

{
  "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å?

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。