스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

스마트 홈 OpenClose 특성 스키마

action.devices.traits.OpenClose: 이 트레잇은 열기 및 닫기를 지원하는 기기에 속합니다. 경우에 따라 부분적으로 열거나 닫을 수도 있고 둘 이상의 방향으로 닫을 수도 있습니다.

기기 속성

이 특성이 있는 기기는 다음을 보고할 수 있습니다. 속성을 SYNC 작업의 일부로 사용할 수 있습니다. 배우기 위해 SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

속성	유형	설명
`discreteOnlyOpenClose`	Boolean	(기본값: `false`) true로 설정하면 기기가 완전히 열려 있거나 완전히 닫혀 있어야 함을 나타냅니다 (즉, 0% 와 100% 사이의 값을 지원하지 않음).
`openDirection`	배열	기기를 열거나 닫을 수 있는 지원되는 길찾기 목록입니다. 기기가 두 방향으로 열고 닫는 기능을 지원하는 경우 이 속성을 포함합니다.
`[item, ...]`	String	지원되는 방향입니다. 지원되는 값: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`commandOnlyOpenClose`	Boolean	(기본값: `false`) 기기가 단방향 (true) 통신 사용을 지원하는지 또는 양방향 (false) 통신 사용을 지원하는지 여부를 나타냅니다. 기기가 이 트레잇에 관한 QUERY 인텐트 또는 상태 보고에 응답할 수 없는 경우 이 속성을 true로 설정합니다.
`queryOnlyOpenClose`	Boolean	(기본값: `false`) 기기에 상태 정보를 쿼리할 수만 있고 제어할 수 없는지를 나타냅니다. 열린 상태만 보고할 수 있는 센서는 이 필드를 true로 설정해야 합니다.

예

간편하게 열고 닫을 수 있는 기기.

{
  "discreteOnlyOpenClose": true
}

하향식 상향식 기기. 어느 방향으로든 열 수 있습니다.

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

명령어 전용 기기.

{
  "commandOnlyOpenClose": false
}

기기 상태

이 특성을 가진 항목은 다음을 보고할 수 있습니다. QUERY 작업의 일부로 제공됩니다. 배우기 위해 QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

페이로드에는 다음 중 하나가 포함됩니다.

단일 방향 열기/닫기

주 유형 설명

주	유형	설명
`openPercent`	숫자	필수사항. 기기가 열린 비율을 나타내며 0은 닫혀 있고 100은 완전히 열린 상태입니다.
`targetOpenPercent`	숫자	지속적인 위치 변경으로 인해 기기가 이동 중이거나 이동 중인 열린 비율을 나타내는 수준입니다.

openPercent

숫자

필수사항.

기기가 열린 비율을 나타내며 0은 닫혀 있고 100은 완전히 열린 상태입니다.

targetOpenPercent

숫자

지속적인 위치 변경으로 인해 기기가 이동 중이거나 이동 중인 열린 비율을 나타내는 수준입니다.

여러 방향 열기/닫기

주	유형	설명
`openState`	배열	필수사항. 지원되는 각 열린 방향의 상태 목록입니다.
`[item, ...]`	객체	지정된 열린 방향의 현재 상태입니다.
`openPercent`	숫자	필수사항. 기기가 열린 비율을 나타내며 0은 닫혀 있고 100은 완전히 열린 상태입니다.
`targetOpenPercent`	숫자	지속적인 위치 변경으로 인해 기기가 이동하거나 이동하는 열린 비율을 나타내는 수준입니다.
`openDirection`	String	필수사항. 기기가 열리는 방향입니다. 지원되는 값: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

예

간편하게 열고 닫을 수 있는 기기.

{
  "openPercent": 100
}

현재 새로운 위치에 열려 있는 간단한 오픈 클로즈 기기입니다.

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

기기를 아래쪽으로는 30%, 위쪽으로는 50% 엽니다.

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

기기를 아래쪽으로는 30%, 위로 50% 씩 엽니다. 현재는 위쪽으로 80% 까지 열고 있습니다.

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

기기 명령어

이 특성을 가진 기기는 다음에 응답할 수 있습니다. EXECUTE 작업의 일부로 사용할 수 있습니다. 배우기 위해 EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

`action.devices.commands.OpenClose`

기기의 열기-닫기 상태를 설정합니다.

매개변수

매개변수 유형 설명

매개변수	유형	설명
`openPercent`	숫자	필수사항. 기기가 열린 비율을 나타내며 0은 닫혀 있고 100은 완전히 열린 상태입니다.
`openDirection`	String	열 방향입니다. 기기가 `openDirection` 속성으로 표시된 여러 경로를 지원하고 사용자가 방향을 지정한 경우에만 존재합니다. 지원되는 값: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Google에서 후속 응답을 위해 제공하는 토큰입니다.

openPercent

숫자

필수사항.

기기가 열린 비율을 나타내며 0은 닫혀 있고 100은 완전히 열린 상태입니다.

openDirection

String

열 방향입니다. 기기가 openDirection 속성으로 표시된 여러 경로를 지원하고 사용자가 방향을 지정한 경우에만 존재합니다.

지원되는 값:

UP
DOWN
LEFT
RIGHT
IN
OUT

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	필수사항. 요청의 결과입니다. 지원되는 값: `SUCCESS`
`openPercent`	숫자	필수사항. 0은 닫혀 있고 100은 완전히 열린 경우 기기가 열린 비율을 나타냅니다.

followUpToken

String

필수사항.

원래 EXECUTE 요청에 제공된 토큰입니다.

status

String

필수사항.

요청의 결과입니다.

지원되는 값:

SUCCESS

openPercent

숫자

필수사항.

0은 닫혀 있고 100은 완전히 열린 경우 기기가 열린 비율을 나타냅니다.

실패

필드 유형 설명

필드	유형	설명
`followUpToken`	String	필수사항. 원래 EXECUTE 요청에 제공된 토큰입니다.
`status`	String	필수사항. 요청의 결과입니다. 지원되는 값: `FAILURE`
`errorCode`	String	필수사항. 이 값은 이 트레잇에 관한 모든 오류 코드가 될 수 있습니다(예: `lockedState`).

followUpToken

String

필수사항.

원래 EXECUTE 요청에 제공된 토큰입니다.

status

String

필수사항.

요청의 결과입니다.

지원되는 값:

FAILURE

errorCode

String

필수사항.

이 값은 이 트레잇에 관한 모든 오류 코드가 될 수 있습니다(예: lockedState).

예

차고 문을 엽니다. (성공 사례에 대한 후속 응답)

{
  "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`	숫자	필수사항. 열기/닫기 상태를 변경할 정확한 비율입니다. 모호한 상대 명령어는 정확한 비율 매개변수로 변환됩니다 (예: "블라인드 조금 더 열어 줘" 대 "블라인드 5% 열어 줘")
`openDirection`	String	열 방향입니다. 기기가 `openDirection` 속성으로 표시된 여러 경로를 지원하고 사용자가 방향을 지정한 경우에만 존재합니다. 지원되는 값: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

숫자

필수사항.

열기/닫기 상태를 변경할 정확한 비율입니다. 모호한 상대 명령어는 정확한 비율 매개변수로 변환됩니다 (예: "블라인드 조금 더 열어 줘" 대 "블라인드 5% 열어 줘")

openDirection

String

열 방향입니다. 기기가 openDirection 속성으로 표시된 여러 경로를 지원하고 사용자가 방향을 지정한 경우에만 존재합니다.

지원되는 값:

UP
DOWN
LEFT
RIGHT
IN
OUT

예

기기 조금 더 열기

{
  "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 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%

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.

스마트 홈 OpenClose 특성 스키마

기기 속성

예

기기 상태

단일 방향 열기/닫기

여러 방향 열기/닫기

예

기기 명령어

action.devices.commands.OpenClose

매개변수

예

관련 오류

후속 응답

성공

실패

예

action.devices.commands.OpenCloseRelative

매개변수

예

관련 오류

샘플 발화

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

기기 ERRORS

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`