스마트 홈 OpenClose 특성 스키마

action.devices.traits.OpenClose - 이 트레이트는 열고 닫기를 지원하는 기기에 속하며, 경우에 따라 부분적으로 또는 잠재적으로 두 개 이상의 방향으로 열고 닫기를 지원합니다.

기기 속성

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

속성 유형 설명
discreteOnlyOpenClose Boolean

(기본값: false)

true로 설정하면 기기가 완전히 열리거나 완전히 닫혀야 함을 나타냅니다 (즉, 0% 와 100% 사이의 값을 지원하지 않음).
openDirection 배열

기기가 열리거나 닫힐 수 있는 지원되는 방향의 목록입니다. 기기가 두 개 이상의 방향으로 열고 닫기를 지원하는 경우 이 속성을 포함합니다.
[item, ...] 문자열

지원되는 방향입니다.

지원되는 값:

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은 완전히 열림입니다.

값은 0에서 100 사이여야 합니다.
targetOpenPercent 숫자

기기가 이동하거나 이동할 열린 비율을 나타내는 수준입니다.

값은 0에서 100 사이여야 합니다.

다중 방향 열고 닫기

주 유형 설명
openState 배열

필수사항.

지원되는 각 열린 방향의 상태 목록입니다.
[item, ...] 객체

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

필수사항.

기기가 열린 비율을 나타냅니다. 0은 닫힘, 100은 완전히 열림입니다.

값은 0에서 100 사이여야 합니다.
targetOpenPercent 숫자

기기가 이동하거나 이동할 열린 비율을 나타내는 수준입니다.

값은 0에서 100 사이여야 합니다.
openDirection 문자열

필수사항.

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

지원되는 값:

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은 완전히 열림입니다.

값은 0에서 100 사이여야 합니다.
openDirection 문자열

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

지원되는 값:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken 문자열

후속 응답을 위해 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 문자열

필수사항.

원래 EXECUTE 요청에 제공된 토큰입니다.
status 문자열

필수사항.

요청 결과입니다.

지원되는 값:

SUCCESS
openPercent 숫자

필수사항.

기기가 열린 비율을 나타냅니다. 0은 닫힘, 100은 완전히 열림입니다.

값은 0에서 100 사이여야 합니다.

실패

필드 유형 설명
followUpToken 문자열

필수사항.

원래 EXECUTE 요청에 제공된 토큰입니다.
status 문자열

필수사항.

요청 결과입니다.

지원되는 값:

FAILURE
errorCode 문자열

필수사항.

값은 이 특성의 오류 코드일 수 있습니다(예: 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

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

이 명령어에는 다음 속성이 필요합니다. 
{
  "discreteOnlyOpenClose": false
}

매개변수

매개변수 유형 설명
openRelativePercent 숫자

필수사항.

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

값은 -100에서 100 사이여야 합니다.
openDirection 문자열

열 방향입니다. 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%

기기 오류

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