Giản đồ trait OpenClose cho 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 mở và đóng và trong một số trường hợp, việc mở và đóng một phần hoặc có thể đóng theo nhiều hướng.
ĐẶC ĐIỂM của 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 trong thao tác SYNC
. Để tìm hiểu thêm về cách xử lý các ý định SYNC
, hãy xem bài viết Thực hiện ý định.
Thuộc tính | Loại | Nội dung mô tả |
---|---|---|
discreteOnlyOpenClose |
Boolean |
(Mặc định: Khi bạn đặt chính sách này thành true (đúng), thuộc tính này cho biết thiết bị phải mở hoặc đóng hoàn toàn (nghĩa 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 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ợ đóng và mở theo nhiều hướng. |
[item, ...] |
String |
Hướng được hỗ trợ. Các giá trị được hỗ trợ:
|
commandOnlyOpenClose |
Boolean |
(Mặc định: Cho biết thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false). Đặ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 Trạng thái báo cáo cho trait này. |
queryOnlyOpenClose |
Boolean |
(Mặc định: Cho biết liệu thiết bị chỉ có thể truy vấn được về thông tin trạng thái và không thể kiểm soát 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ị có thể đóng mở đơn giản.
{ "discreteOnlyOpenClose": true }
Thiết bị từ trên xuống dưới. Có thể mở theo một trong hai hướng.
{ "openDirection": [ "UP", "DOWN" ] }
Thiết bị chỉ dùng lệnh.
{ "commandOnlyOpenClose": false }
TIỂU BANG của 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 trong thao tác QUERY
. Để tìm hiểu thêm về cách xử lý các ý định QUERY
, hãy xem bài viết Thực hiện ý định.
Tải trọng này có một trong các trạng thái sau:
Đóng – mở một hướng
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ột thiết bị được mở, trong đó 0 là đóng và 100 là mở hoàn toàn. |
targetOpenPercent |
Number |
Mức độ cho biết phần trăm mở nơi thiết bị sẽ tới hoặc di chuyển đến do vị trí thay đổi liên tục. |
Đóng-mở nhiều hướng
Tiểu bang | Loại | Nội dung mô tả |
---|---|---|
openState |
Mảng |
Bắt buộc. Danh sách 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ở đã cho. |
openPercent |
Number |
Bắt buộc. Cho biết tỷ lệ phần trăm một thiết bị được mở, trong đó 0 là đóng và 100 là mở hoàn toàn. |
targetOpenPercent |
Number |
Mức độ cho biết phần trăm mở nơi thiết bị sẽ tới hoặc di chuyển đến do vị trí thay đổi liên tục. |
openDirection |
String |
Bắt buộc. Hướng mở thiết bị. Các giá trị được hỗ trợ:
|
Ví dụ
Thiết bị có thể đóng mở đơn giản.
{ "openPercent": 100 }
Thiết bị đóng mở đơn giản hiện đang mở vào 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 mở 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 trong thao tác EXECUTE
. Để tìm hiểu thêm về cách xử lý các ý định EXECUTE
, hãy xem bài viết Thực hiện ý định.
action.devices.commands.OpenClose
Đặt trạng thái mở và đóng của thiết bị.
Tham số
Tham số | Loại | Nội dung mô tả |
---|---|---|
openPercent |
Number |
Bắt buộc. Cho biết tỷ lệ phần trăm một 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ởi thuộc tính Các giá trị được hỗ trợ:
|
followUpToken |
String |
Mã thông báo do Google cung cấp cho phản hồi tiếp theo. |
Ví dụ
Mở thiết bị.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
Mở thiết bị hướng xuống 50%.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Lỗi liên quan
Đã 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 nối tiếp
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 thao tác 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 cho Hành động trong nhà thông minh.
Tải trọng này có một trong các trạng thái 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ợ:
|
openPercent |
Number |
Bắt buộc. Cho biết tỷ lệ phần trăm mà một 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ợ:
|
errorCode |
String |
Bắt buộc. Giá trị có thể là bất kỳ mã lỗi nào cho trait này, chẳng hạn như |
Ví dụ
Mở cửa nhà để xe. (câu trả lời tiếp nối 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 nối trong trường hợp lỗi)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Điều chỉnh trạng thái mở và đóng của thiết bị tương ứng với trạng thái hiện tại. Lệnh này chỉ dùng được nếu bạn đặt commandOnlyOpenClose
thành false
.
{ "commandOnlyOpenClose": false }
Tham số
Tham 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 mở/đóng. Các lệnh tương đối không rõ ràng sẽ được chuyển đổi thành một tham số phần trăm chính xác (ví dụ: "Mở mành cửa thêm một chút" và "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ởi thuộc tính Các giá trị được hỗ trợ:
|
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 dưới.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Lỗi liên quan
Đã 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ách phát âm 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%