Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục xây dựng các hành động trong bảng điều khiển Actions.

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

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

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 có thể mở và đóng một phần hoặc có thể theo nhiều hướng.

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem Thực hiện ý định.

Thuộc tính	Loại	Mô tả
`discreteOnlyOpenClose`	Boolean	(Mặc định: `false`) Khi bạn đặt chính sách này thành true (đúng), thông báo này cho biết thiết bị phải mở hoàn toàn hoặc đóng hoàn toàn (nghĩa là thiết bị không hỗ trợ các giá trị trong khoảng từ 0% đến 100%).
`openDirection`	Mảng	Danh sách hướng dẫn đượ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ợ: `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 (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 đối với đặc điểm này.
`queryOnlyOpenClose`	Boolean	(Mặc định: `false`) Cho biết liệu thiết bị chỉ có thể truy vấn về thông tin trạng thái và không thể kiểm soát hay không. Các 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ị đó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
}

Thiết bị STATES

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

Tải trọng chứa một trong các mục sau:

Đóng/mở một hướng

Tiểu bang Loại Mô tả

Tiểu bang	Loại	Mô tả
`openPercent`	Number	Bắt buộc. Cho biết tỷ lệ phần trăm mà một thiết bị đang mở, trong đó 0 là đóng và 100 là mở hoàn toàn.
`targetOpenPercent`	Number	Mức cho biết tỷ lệ phần trăm mở cửa mà thiết bị sẽ hoặc sắp chuyển đến do thay đổi vị trí liên tục.

openPercent

Number

Bắt buộc.

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

targetOpenPercent

Number

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

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

Tiểu bang	Loại	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 của hướng mở đã cho.
`openPercent`	Number	Bắt buộc. Cho biết tỷ lệ phần trăm mà một thiết bị đang mở, trong đó 0 là đóng và 100 là mở hoàn toàn.
`targetOpenPercent`	Number	Mức cho biết tỷ lệ phần trăm mở cửa mà thiết bị sẽ hoặc sắp chuyển đến do thay đổi vị trí liên tục.
`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ị đóng mở đơn giản.

{
  "openPercent": 100
}

Thiết bị đóng-mở đơn giản hiện đang mở đến 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 tại là 80% theo hướng lên.

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

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem Thực hiện ý định.

`action.devices.commands.OpenClose`

Thiết lập trạng thái đóng – mở của thiết bị.

Tham số

Tham số Loại Mô tả

Tham số	Loại	Mô tả
`openPercent`	Number	Bắt buộc. Cho biết tỷ lệ phần trăm mà một thiết bị đang 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à một hướng do người dùng chỉ định. 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 cho phản hồi tiếp theo.

openPercent

Number

Bắt buộc.

Cho biết tỷ lệ phần trăm mà một thiết bị đang 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à một hướng do người dùng chỉ định.

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 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ị ở mức 50% trở xuống.

{
  "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 nối tiếp

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

Tải trọng chứa một trong các mục sau:

Thành công

Trường Loại Mô tả

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

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

Lỗi

Trường Loại Mô tả

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à mã lỗi bất kỳ của đặc điểm này, ví dụ: `lockedState`.

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à mã lỗi bất kỳ của đặc điểm này, ví dụ: lockedState.

Ví dụ

Mở cửa nhà xe. (liên hệ lại câu trả lời đối với 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 đóng – mở 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.

Lệnh này yêu cầu các thuộc tính sau:

{
  "commandOnlyOpenClose": false
}

Tham số

Tham số Loại Mô tả

Tham 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 đóng cửa mở. Các lệnh tương đối không rõ ràng sẽ được chuyển đổi thành một tham 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à một hướng do 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ửa mở. Các lệnh tương đối không rõ ràng sẽ được chuyển đổi thành một tham 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à một hướng do 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% nữa

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

Mở thiết bị thêm 50% theo hướng 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

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%

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.

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

ATTRIBUTE của thiết bị

Ví dụ

Thiết bị STATES

Đóng/mở một hướng

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

Ví dụ

lệnh của thiết bị

action.devices.commands.OpenClose

Tham số

Ví dụ

Lỗi có liên quan

Câu trả lời nối tiếp

Thành công

Lỗi

Ví dụ

action.devices.commands.OpenCloseRelative

Tham số

Ví dụ

Lỗi có liên quan

Cách phát âm 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`