Trang này được dịch bởi Cloud Translation API.

Lược đồ trạng thái đóng nhà thông minh

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

ATTRIBUTES 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 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 tính	Loại	Nội dung mô tả
`discreteOnlyOpenClose`	Boolean	(Mặc định: `false`) Khi người dùng thiết lập giá trị này là true, thì giá trị này cho biết thiết bị phải đang mở hoàn toàn hoặc đã đóng hoàn toàn (tức là thiết bị không hỗ trợ các giá trị nằm trong khoảng 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ợ việc mở và đóng theo nhiều hướng.
`[item, ...]`	Chuỗi	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 thiết bị có hỗ trợ giao tiếp một chiều (đúng) hay hai chiều (sai) hay không. Đặt thuộc tính này thành đúng nếu thiết bị không thể phản hồi ý định QUERY hoặc Trạng thái báo cáo cho đặc điểm này.
`queryOnlyOpenClose`	Boolean	(Mặc định: `false`) Cho biết thiết bị chỉ có thể truy vấn thông tin trạng thái và không thể kiểm soát được. Các cảm biến chỉ có thể báo cáo trạng thái mở nên đặt trường này thành true (đúng).

Ví dụ

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

{
  "discreteOnlyOpenClose": true
}

Thiết bị từ trên xuống từ dưới lên. Có thể mở theo một trong hai hướng.

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

Thiết bị chỉ có lệnh.

{
  "commandOnlyOpenClose": false
}

Thiết bị STATES

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 toán tử 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 mục sau:

Mở một hướng

Tiểu bang Loại Nội dung mô tả

Tiểu bang	Loại	Nội dung mô tả
`openPercent`	Number	Bắt buộc. Cho biết tỷ lệ phần trăm mở được thiết bị, trong đó 0 là đóng và 100 là mở hoàn toàn.

openPercent

Number

Bắt buộc.

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

Đóng nhiều hướng mở

Tiểu bang	Loại	Nội dung 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 của hướng mở nhất định.
`openPercent`	Number	Bắt buộc. Cho biết tỷ lệ phần trăm mở được thiết bị, trong đó 0 là đóng và 100 là mở hoàn toàn.
`openDirection`	Chuỗi	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ị đóng đơn giản.

{
  "openPercent": 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"
    }
  ]
}

Thiết bị COMMANDS

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác 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 đóng của thiết bị.

Thông số

Thông số Loại Nội dung mô tả

Thông số	Loại	Nội dung mô tả
`openPercent`	Number	Bắt buộc. Cho biết tỷ lệ phần trăm mở được thiết bị, trong đó 0 là đóng và 100 là mở hoàn toàn.
`openDirection`	Chuỗi	Hướng mở. Chỉ hiển thị nếu thiết bị hỗ trợ nhiều hướng, như được chỉ định bởi thuộc tính `openDirection` và hướng được người dùng chỉ định. Các giá trị được hỗ trợ: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	Chuỗi	Mã thông báo do Google cung cấp để phản hồi theo dõi.

openPercent

Number

Bắt buộc.

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

openDirection

Chuỗi

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

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

UP
DOWN
LEFT
RIGHT
IN
OUT

followUpToken

Chuỗi

Mã thông báo do Google cung cấp để phản hồi theo dõi.

Ví dụ

Mở thiết bị.

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

Mở thiết bị xuống 50%.

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

Đã xảy ra lỗi khi đặt trạng thái đóng mở 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 hoạt động EXECUTE. Để tìm hiểu thêm về cách triển khai các phản hồi tiếp theo, hãy xem bài viết Thông báo về tính năng Hành động dành cho nhà thông minh.

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

Thành công

Các trường Loại Mô tả

Các trường	Loại	Mô tả
`followUpToken`	Chuỗi	Bắt buộc. Mã thông báo được cung cấp trong yêu cầu EXECUTE ban đầu.
`status`	Chuỗi	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 mở được thiết bị trong đó 0 được đóng và 100 mở hoàn toàn.

followUpToken

Chuỗi

Bắt buộc.

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

status

Chuỗi

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 mở được thiết bị trong đó 0 được đóng và 100 mở hoàn toàn.

Lỗi

Các trường Loại Mô tả

Các trường	Loại	Mô tả
`followUpToken`	Chuỗi	Bắt buộc. Mã thông báo được cung cấp trong yêu cầu EXECUTE ban đầu.
`status`	Chuỗi	Bắt buộc. Kết quả của yêu cầu. Các giá trị được hỗ trợ: `FAILURE`
`errorCode`	Chuỗi	Bắt buộc. Giá trị có thể là bất kỳ mã lỗi nào cho đặc điểm này, ví dụ: `lockedState`.

followUpToken

Chuỗi

Bắt buộc.

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

status

Chuỗi

Bắt buộc.

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

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

FAILURE

errorCode

Chuỗi

Bắt buộc.

Giá trị 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 gara. (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 gara. (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 đóng của thiết bị so với trạng thái hiện tại. Lệnh này chỉ có sẵn nếu bạn đặ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 Nội dung mô tả

Thông số	Loại	Nội dung mô tả
`openRelativePercent`	Number	Bắt buộc. Tỷ lệ phần trăm chính xác để thay đổi trạng thái đóng. Các lệnh tương đối lớn sẽ được chuyển đổi thành tham số tỷ lệ phần trăm chính xác (ví dụ: "Mở rèm cửa hơn một chút" so với "Mở rèm cửa 5%").
`openDirection`	Chuỗi	Hướng mở. Chỉ hiển thị nếu thiết bị hỗ trợ nhiều hướng, như được chỉ định bởi thuộc tính `openDirection` và hướng được người dùng chỉ định. Các giá trị được hỗ trợ: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Number

Bắt buộc.

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

openDirection

Chuỗi

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

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% xuống dưới.

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

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

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

lockedState
deviceJammingDetected

Lời nói 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%

Thiết bị ERRORS

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

Lược đồ trạng thái đóng nhà thông minh

ATTRIBUTES thiết bị

Ví dụ

Thiết bị STATES

Mở một hướng

Đóng nhiều hướng mở

Ví dụ

Thiết bị COMMANDS

action.devices.commands.OpenClose

Thông số

Ví dụ

Lỗi liên quan

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

Thành công

Lỗi

Ví dụ

action.devices.commands.OpenCloseRelative

Thông số

Ví dụ

Lỗi liên quan

Lời nói mẫu

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

Thiết bị ERRORS

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`