스마트 홈 OpenClose 속성 스키마
action.devices.traits.OpenClose
- 이 특성은 열기 및 닫기를 지원하는 기기에 속하며, 경우에 따라 둘 이상의 방향으로 부분적으로 열거나 닫을 수 있습니다.
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
discreteOnlyOpenClose |
Boolean |
(기본값: true로 설정하면 기기가 완전히 열려 있거나 완전히 닫혀 있어야 합니다. 즉, 0% 에서 100% 사이의 값을 지원하지 않습니다. |
openDirection |
배열 |
기기를 열거나 닫을 수 있는 지원되는 경로 목록입니다. 기기가 둘 이상의 방향으로 열기 및 닫기를 지원하는 경우 이 속성을 포함합니다. |
[item, ...] |
String |
지원되는 방향입니다. 지원 값:
|
commandOnlyOpenClose |
Boolean |
(기본값: 기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요. |
queryOnlyOpenClose |
Boolean |
(기본값: 기기를 상태 정보에 대해서만 쿼리할 수 있고 제어할 수 없는지 여부를 나타냅니다. 열린 상태만 보고할 수 있는 센서는 이 필드를 true로 설정해야 합니다. |
예
간단한 닫는 기기.
{ "discreteOnlyOpenClose": true }
하향식 상향식 기기. 어느 방향으로든 열 수 있습니다.
{ "openDirection": [ "UP", "DOWN" ] }
명령어 전용 기기.
{ "commandOnlyOpenClose": false }
기기 상태
이 특성이 있는 항목은 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
페이로드에는 다음 중 하나가 포함됩니다.
한 방향으로 열린 닫기
상태 | 유형 | 설명 |
---|---|---|
openPercent |
Number |
필수. 기기가 열린 비율을 나타냅니다. 0은 닫혀있고 100은 완전히 열려 있습니다. |
다방향 개방형 닫기
상태 | 유형 | 설명 |
---|---|---|
openState |
배열 |
필수. 지원되는 각 열린 방향의 상태 목록입니다. |
[item, ...] |
객체 |
지정된 열린 방향의 현재 상태입니다. |
openPercent |
Number |
필수. 기기가 열린 비율을 나타냅니다. 0은 닫혀있고 100은 완전히 열려 있습니다. |
openDirection |
String |
필수. 기기가 열리는 방향입니다. 지원 값:
|
예
간단한 닫는 기기.
{ "openPercent": 100 }
기기를 아래쪽 방향으로 30%, 위쪽 방향으로 50% 엽니다.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.OpenClose
기기의 닫힘 상태를 설정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
openPercent |
Number |
필수. 기기가 열린 비율을 나타냅니다. 0은 닫혀있고 100은 완전히 열려 있습니다. |
openDirection |
String |
열 방향입니다. 기기가 지원 값:
|
followUpToken |
String |
후속 응답을 위해 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 |
String |
필수. 원래 EXECUTE 요청에 제공된 토큰입니다. |
status |
String |
필수. 요청의 결과입니다. 지원 값:
|
openPercent |
Number |
필수. 기기가 열려 있고 0이 닫혀 있고 100이 완전히 열려 있는 비율을 나타냅니다. |
실패
필드 | 유형 | 설명 |
---|---|---|
followUpToken |
String |
필수. 원래 EXECUTE 요청에 제공된 토큰입니다. |
status |
String |
필수. 요청의 결과입니다. 지원 값:
|
errorCode |
String |
필수. 이 특성의 모든 오류 코드가 값이 될 수 있습니다(예: |
예
차고 문을 엽니다. (성공 사례에 대한 후속 답변)
{ "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 |
String |
열 방향입니다. 기기가 지원 값:
|
예
기기 조금 더 열기
{ "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 auf30% -
Fensterläden um25 % schliessen -
Ist
die Jalousie zu? -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Are
the blinds in the kitchen open -
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
está abierta
la puerta -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
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 de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
क्या मैंने
सामने वाला दरवाजा खुला छोड दिया? -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25% -
è 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 voor25% dicht -
doe
het raam ietsje meer dicht -
is
de voordeur open -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% 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 a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
är
ytterdörren öppen? -
öppna
persiennerna med25%