Giản đồ đặc điểm OpenClose của nhà thông minh

action.devices.traits.OpenClose – Đặc điểm này thuộc về các thiết bị hỗ trợ mở và đóng, và trong một số trường hợp, mở và đóng một phần hoặc có thể theo nhiều hướng.

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính Loại Mô tả
discreteOnlyOpenClose Boolean

(Mặc định: false)

Khi được đặt thành true, giá trị này cho biết thiết bị phải mở hoàn toàn hoặc đóng hoàn toàn (tức là không hỗ trợ các giá trị từ 0% đến 100%).
openDirection Mảng

Danh sách các hướng được hỗ trợ mà thiết bị có thể mở hoặc đóng. Thêm thuộc tính này nếu thiết bị hỗ trợ mở và đóng theo nhiều hướng.
[item, ...] String

Hướng được hỗ trợ.

Các giá trị được hỗ trợ:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Boolean

(Mặc định: false)

Cho biết liệu thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false) hay không. Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Báo cáo trạng thái cho đặc điểm này.
queryOnlyOpenClose Boolean

(Mặc định: false)

Cho biết liệu bạn chỉ có thể truy vấn thông tin trạng thái của thiết bị mà không thể điều khiển thiết bị đó hay không. Những cảm biến chỉ có thể báo cáo trạng thái mở phải đặt trường này thành true.

Ví dụ

Thiết bị mở-đóng đơn giản.

{
  "discreteOnlyOpenClose": true
}

Thiết bị từ trên xuống dưới. Có thể mở theo hướng bất kỳ.

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

Thiết bị chỉ dùng lệnh.

{
  "commandOnlyOpenClose": false
}

Trạng thái thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Trọng tải chứa một trong những nội dung sau:

Mở-đóng một chiều

Tiểu bang Loại Mô tả
openPercent Number

Bắt buộc.

Cho biết tỷ lệ phần trăm thiết bị được mở, trong đó 0 là đóng và 100 là mở hoàn toàn.
targetOpenPercent Number

Cấp độ cho biết tỷ lệ phần trăm mở mà thiết bị sẽ chuyển đến hoặc đang chuyển đến do vị trí liên tục thay đổi.

Mở-đóng theo nhiều hướng

Tiểu bang Loại Mô tả
openState Mảng

Bắt buộc.

Danh sách các trạng thái cho mỗi hướng mở được hỗ trợ.
[item, ...] Đối tượng

Trạng thái hiện tại cho hướng mở nhất định.
openPercent Number

Bắt buộc.

Cho biết tỷ lệ phần trăm thiết bị được mở, trong đó 0 là đóng và 100 là mở hoàn toàn.
targetOpenPercent Number

Cấp độ cho biết tỷ lệ phần trăm mở mà thiết bị sẽ chuyển đến hoặc đang chuyển đến do vị trí liên tục thay đổi.
openDirection String

Bắt buộc.

Hướng mở thiết bị.

Các giá trị được hỗ trợ:

UP
DOWN
LEFT
RIGHT
IN
OUT

Ví dụ

Thiết bị mở-đóng đơn giản.

{
  "openPercent": 100
}

Thiết bị mở-đóng đơn giản hiện đang mở ra một vị trí mới.

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

Mở thiết bị 30% theo hướng xuống và 50% theo hướng lên.

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

Mở thiết bị 30% theo hướng xuống và 50% theo hướng lên, hiện đang chuyển sang 80% theo hướng lên.

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

LỆNH của thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.OpenClose

Đặt trạng thái mở-đóng của thiết bị.

Thông số

Thông số Loại Mô tả
openPercent Number

Bắt buộc.

Cho biết tỷ lệ phần trăm thiết bị được mở, trong đó 0 là đóng và 100 là mở hoàn toàn.
openDirection String

Hướng mở. Chỉ xuất hiện nếu thiết bị hỗ trợ nhiều hướng, như được chỉ định bằng thuộc tính openDirection và người dùng chỉ định một hướng.

Các giá trị được hỗ trợ:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Mã thông báo do Google cung cấp để trả lời tiếp theo.

Ví dụ

Mở thiết bị.

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

Mở thiết bị giảm 50%.

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

Đã xảy ra lỗi khi thiết lập trạng thái mở-đóng của thiết bị.

Các giá trị được hỗ trợ:

lockedState
deviceJammingDetected

Câu trả lời tiếp theo

Các thiết bị có đặc điểm này có thể trả về tải trọng phản hồi tiếp theo sau đây trong quá trình thao tác EXECUTE. Để tìm hiểu thêm về cách triển khai phản hồi tiếp theo, hãy xem phần Thông báo cho Hành động nhà thông minh.

Trọng tải chứa một trong những nội dung sau:

Thành công

Trường Loại Mô tả
followUpToken String

Bắt buộc.

Mã thông báo được cung cấp trong yêu cầu EXECUTE ban đầu.
status String

Bắt buộc.

Kết quả của yêu cầu.

Các giá trị được hỗ trợ:

SUCCESS
openPercent Number

Bắt buộc.

Cho biết tỷ lệ phần trăm thiết bị được mở, trong đó 0 là đóng và 100 là mở hoàn toàn.

Lỗi

Trường Loại Mô tả
followUpToken String

Bắt buộc.

Mã thông báo được cung cấp trong yêu cầu EXECUTE ban đầu.
status String

Bắt buộc.

Kết quả của yêu cầu.

Các giá trị được hỗ trợ:

FAILURE
errorCode String

Bắt buộc.

Giá trị này có thể là bất kỳ mã lỗi nào cho đặc điểm này, ví dụ: lockedState.

Ví dụ

Mở cửa nhà để xe. (phản hồi tiếp theo cho trường hợp thành công)

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

Mở cửa nhà để xe. (phản hồi tiếp theo cho trường hợp không thành công)

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

action.devices.commands.OpenCloseRelative

Điều chỉnh trạng thái mở-đóng của thiết bị so với trạng thái hiện tại. Bạn chỉ có thể sử dụng lệnh này nếu đặt commandOnlyOpenClose thành false.

Lệnh này yêu cầu các thuộc tính sau: 
{
  "commandOnlyOpenClose": false
}

Thông số

Thông số Loại Mô tả
openRelativePercent Number

Bắt buộc.

Tỷ lệ phần trăm chính xác để thay đổi trạng thái mở-đóng. Các lệnh tương đối không rõ ràng sẽ được chuyển đổi thành thông số tỷ lệ phần trăm chính xác (ví dụ: "Mở mành cửa thêm một chút" so với "Mở mành cửa thêm 5%").
openDirection String

Hướng mở. Chỉ xuất hiện nếu thiết bị hỗ trợ nhiều hướng, như được chỉ định bằng thuộc tính openDirection và người dùng chỉ định một hướng.

Các giá trị được hỗ trợ:

UP
DOWN
LEFT
RIGHT
IN
OUT

Ví dụ

Mở thiết bị thêm một chút

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

Đóng thiết bị thêm 10%

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

Mở thiết bị thêm 50%, hướng xuống.

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

Đã xảy ra lỗi khi thiết lập trạng thái mở-đóng của thiết bị.

Các giá trị được hỗ trợ:

lockedState
deviceJammingDetected

Câu lệnh mẫu

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%

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.