스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 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": true
}

기기 상태

이 특성이 있는 기기는 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

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

한 방향으로 열린 닫기

상태 유형 설명
openPercent Number

필수사항.

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

다방향 개방형 닫기

상태 유형 설명
openState 배열

필수사항.

지원되는 각 열린 방향의 상태 목록입니다.

[item, ...] 객체

지정된 열린 방향의 현재 상태입니다.

openPercent Number

필수사항.

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

openDirection String

필수사항.

기기가 열리는 방향입니다.

지원 값:

UP
DOWN
LEFT
RIGHT
IN
OUT

간단한 닫는 기기.

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

열 방향입니다. 기기가 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 Number

필수사항.

기기가 열려 있고 0이 닫혀 있고 100이 완전히 열려 있는 비율을 나타냅니다.

실패

필드 유형 설명
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

현재 상태를 기준으로 기기의 닫힘 상태를 조정합니다. 이 명령어는 commandOnlyOpenClosetrue로 설정된 경우에만 사용할 수 있습니다.

이 명령어에는
{
  "commandOnlyOpenClose": true
}
속성이 필요합니다.

매개변수

매개변수 유형 설명
openRelativePercent Number

필수사항.

영업 종료 상태를 변경할 정확한 비율입니다. 모호한 상대 명령어는 정확한 백분율 매개변수로 변환됩니다 (예: '블라인드를 조금 더 열기'와 '블라인드를 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äden25% 슐리센
  • 마카 덴 롤라덴 zu
  • 마하 다이 롤로스 auf
  • 슐리에 다이 롤리덴 ein bisschen 메흐르
  • Öfne die Jalousien25%

en-US

  • 블라인드 닫기 25% 내 방
  • 문 닫기 자세히 알아보기
  • 현관을 닫기만 하면 됩니다.
  • 우리 방 블라인드 열어 줘
  • 블라인드 열기 25%
  • 문 열기 25%

es-ES

  • abre la ventana del salón
  • 세라르 persianas del dormitorio un 20%
  • 시에라 라 코르티나 델 살론
  • 시에라 mucho más la ventana
  • 콰로 케 수바스 라 페르시아나25%
  • 수 부 20% 라스 페르시아나

fr-FR

  • Baisse les 매장 de 10%
  • ferme 레스 매장
  • ferme un peu les store
  • ouvre les 매장
  • OUvre les store de la chambre de 25%
  • 매장 25%

기기 오류

오류 및 예외의 전체 목록을 참조하세요.