智慧型住宅 OpenClose Trait 結構定義

action.devices.traits.OpenClose - 這種特性適用於支援開啟和關閉功能的裝置，有時也可用於部分方向，或可能從多個方向開啟和關閉。

裝置屬性

具備這項特徵的裝置可能會回報下列資料： 在 SYNC 作業中使用屬性變更。學習 如要進一步瞭解如何處理 SYNC 意圖，請參閱 意圖執行要求。

屬性 類型 說明
discreteOnlyOpenClose 布林值

(預設值：false)

如果設為 true，表示裝置必須完全展開或完全關閉 (也就是不支援介於 0% 和 100% 之間的值)。
openDirection 陣列

支援的路線清單，列出裝置可在哪些地方開啟或關閉。如果裝置支援往多個方向開啟和關閉，請加入這項屬性。
[item, ...] String

支援的方向。

支援的值：

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose 布林值

(預設值：false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的「QUERY」意圖或「回報狀態」，請將這項屬性設為 true。
queryOnlyOpenClose 布林值

(預設值：false)

指出裝置是否只能查詢狀態資訊，也無法控制。如果感應器只能回報營業狀態，請將這個欄位設為 true。

範例

簡單易用的開放式裝置。

{
  "discreteOnlyOpenClose": true
}

由上而下的裝置。可雙向開啟。

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

僅支援指令的裝置。

{
  "commandOnlyOpenClose": false
}

裝置狀態

具有此特徵的實體可能會回報下列資料： 做為 QUERY 作業的一部分。學習 如要進一步瞭解如何處理 QUERY 意圖，請參閱 意圖執行要求。

酬載包含下列其中一個項目：

單向開放封閉

州 類型 說明
openPercent Number

必要。

表示使用者開啟裝置的百分比，其中 0 為關閉狀態，100 為完全開啟狀態。
targetOpenPercent Number

等級：表示裝置隨著位置持續變動而移動或移動的剩餘百分比。

多方向開放關閉

州 類型 說明
openState 陣列

必要。

各個支援的開放方向的狀態清單。
[item, ...] 物件

指定開放方向的目前狀態。
openPercent Number

必要。

表示使用者開啟裝置的百分比，其中 0 為關閉狀態，100 為完全開啟狀態。
targetOpenPercent Number

等級：表示裝置隨著位置持續變動而移動或移動的剩餘百分比。
openDirection String

必要。

開啟裝置時的方向。

支援的值：

UP
DOWN
LEFT
RIGHT
IN
OUT

範例

簡單易用的開放式裝置。

{
  "openPercent": 100
}

換上全新位置的簡單闔上裝置，目前開著新位置。

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

將裝置打開了 30%，向前移動 30%，向前移動 50% 的距離。

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

打開裝置方向：向下 30%，往上移動 50% 的方向，目前向上移動到 80%。

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

裝置指令

具備這種特徵的裝置可能會回應下列問題 做為 EXECUTE 作業的一部分。學習 如要進一步瞭解如何處理 EXECUTE 意圖，請參閱 意圖執行要求。

action.devices.commands.OpenClose

設定裝置的開啟關閉狀態。

參數

參數 類型 說明
openPercent Number

必要。

表示使用者開啟裝置的百分比，其中 0 為關閉狀態，100 為完全開啟狀態。
openDirection String

開啟的方向。只有在裝置支援多種方向 (如 openDirection 屬性所示)，且使用者指定方向時才會顯示。

支援的值：

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Google 提供的權杖，用於後續回應。

範例

開啟裝置。

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

開啟裝置螢幕的百分之 50。

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

設定裝置的開啟關閉狀態時發生錯誤。

支援的值：

lockedState
deviceJammingDetected

後續回覆

具備這種特徵的裝置可能會傳回下列項目 在 EXECUTE 作業中持續追蹤回應酬載。學習 如要進一步瞭解如何實作後續回應，請參見 智慧型住宅動作的通知。

酬載包含下列其中一個項目：

成功

欄位 類型 說明
followUpToken String

必要。

原始 EXECUTE 要求中提供的權杖。
status String

必要。

要求的結果。

支援的值：

SUCCESS
openPercent Number

必要。

表示裝置在關閉 0 和 100 完全開啟的情況下開啟的百分比。

失敗

欄位 類型 說明
followUpToken String

必要。

原始 EXECUTE 要求中提供的權杖。
status String

必要。

要求的結果。

支援的值：

FAILURE
errorCode String

必要。

值可以是這個特徵的任何錯誤代碼，例如 lockedState。

範例

打開車庫門。(成功案例的後續回覆)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

打開車庫門。(失敗案件的後續回覆)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

根據目前狀態調整裝置的開啟關閉狀態。只有在 commandOnlyOpenClose 設為 false 時，才能使用這個指令。

這個指令需要下列屬性： 
{
  "commandOnlyOpenClose": false
}

參數

參數 類型 說明
openRelativePercent Number

必要。

變更開啟情形狀態的確切百分比。不明確的相對指令將轉換為確切的百分比參數，例如「多打開百葉窗」或「打開百葉窗 5%」。
openDirection String

開啟的方向。只有在裝置支援多種方向 (如 openDirection 屬性所示)，且使用者指定方向時才會顯示。

支援的值：

UP
DOWN
LEFT
RIGHT
IN
OUT

範例

多打開裝置

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

關閉裝置 10% 以上

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

裝置開啟量增加 50%，向下移動。

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

設定裝置的開啟關閉狀態時發生錯誤。

支援的值：

lockedState
deviceJammingDetected

範例語音

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

hi-IN

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को थोड़ा और बंद कर दिजिए
  • ब्लाइंड बंद करें

it-IT

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25% に ブラインド を開けて
  • 25% ブラインド を閉めてください
  • 25% ブラインド 開けて
  • ブラインド 閉めて
  • ブラインド 開けて
  • 少し ブラインド を閉じて
  • 玄関のドア は開いてますか

ko-KR

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

裝置錯誤

查看完整清單 錯誤和例外狀況。