Smart Home OpenClose Trait 結構定義

action.devices.traits.OpenClose - 此屬性屬於支援開場及關合裝置，有時可能是部分方向的開放和關閉，或有可能橫跨多個方向。

裝置屬性

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

屬性	類型	說明
discreteOnlyOpenClose	布林	(預設：false) 如果設為 true，表示裝置必須完全開啟或完全關閉 (亦即不支援 0% 到 100% 之間的值)。
openDirection	陣列	支援可開啟或關閉的支援路線清單。如果裝置支援在多個方向開啟和關閉，請加入這個屬性。
[item, ...]	字串	支援的方向。 支援的值： UP DOWN LEFT RIGHT IN OUT
commandOnlyOpenClose	布林	(預設：false) 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態，請將此屬性設為 true。
queryOnlyOpenClose	布林	(預設：false) 指出裝置是否只能查詢狀態資訊，而且無法控制。如果感應器只能回報開放狀態，則應將這個欄位設為 true。

範例

簡單的開放式裝置。

{
  "discreteOnlyOpenClose": true
}

由下而下的裝置。方向不限。

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

使用「僅限指令」的裝置。

{
  "commandOnlyOpenClose": false
}

裝置狀態：STATE

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

酬載包含下列其中一個值：

單向開放式

州	類型	說明
openPercent	Number	必填。 表示裝置開啟的百分比，其中 0 為關閉狀態，100 則為完全開啟。

多方向開放式關閉

州	類型	說明
openState	陣列	必填。 各支援開放式方向的狀態清單。
[item, ...]	物件	指定開放式方向的目前狀態。
openPercent	Number	必填。 表示裝置開啟的百分比，其中 0 為關閉狀態，100 則為完全開啟。
openDirection	字串	必填。 裝置的開啟方向。 支援的值： UP DOWN LEFT RIGHT IN OUT

範例

簡單的開放式裝置。

{
  "openPercent": 100
}

以 30% 的向下方向開啟裝置，朝 50% 的方向保持開啟。

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

裝置指令

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

action.devices.commands.OpenClose

設定裝置的開放狀態。

參數

參數	類型	說明
openPercent	Number	必填。 表示裝置開啟的百分比，其中 0 為關閉狀態，100 則為完全開啟。
openDirection	字串	開啟方向。只有在裝置支援多個方向 (如 openDirection 屬性所示) 且使用者指定方向時，才會顯示這個選項。 支援的值： UP DOWN LEFT RIGHT IN OUT
followUpToken	字串	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	字串	必填。 原始 EXECUTE 要求中提供的憑證。
status	字串	必填。 要求的結果。 支援的值： SUCCESS
openPercent	Number	必填。 表示裝置開啟時 (0 關閉且 100 完全開啟) 所開啟的百分比。

失敗

欄位	類型	說明
followUpToken	字串	必填。 原始 EXECUTE 要求中提供的憑證。
status	字串	必填。 要求的結果。 支援的值： FAILURE
errorCode	字串	必填。 這個值可以是此特性的任何錯誤代碼，例如 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	字串	開啟方向。只有在裝置支援多個方向 (如 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%

裝置錯誤：ERRORS

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