스마트 홈 LockUnlock 특성 스키마

action.devices.traits.LockUnlock - 이 특성은 잠금 및 잠금 해제를 지원하거나 잠금 상태를 보고하는 모든 기기에 적용됩니다.

기기 속성

없음

기기 상태

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

주 유형 설명
isLocked Boolean

기기가 현재 잠겨 있는지 여부입니다.
isJammed Boolean

기기가 현재 걸려 있어 잠금 상태를 확인할 수 없는지 여부입니다.

예

잠긴 기기

{
  "isLocked": true
}

걸린 기기

{
  "isJammed": true
}

기기 명령어

이 특성이 있는 기기는 다음 명령어에 EXECUTE 작업의 일부로 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리하기를 참고하세요.

action.devices.commands.LockUnlock

기기를 잠그거나 잠금 해제합니다.

매개변수

매개변수 유형 설명
lock Boolean

필수사항.

명령어가 잠그는 경우 true, 잠금 해제하는 경우 false입니다.
followUpToken 문자열

후속 응답을 위해 Google에서 제공한 토큰입니다.

예

현관 도어락 잠가 줘

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": true,
    "followUpToken": "123"
  }
}

현관 도어락 열어 줄래

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": false,
    "followUpToken": "567"
  }
}

기기를 잠그거나 잠금 해제하는 중에 오류가 발생했습니다.

지원되는 값:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

후속 응답

이 특성이 있는 기기는 다음 후속 응답 페이로드를 EXECUTE 작업의 일부로 반환할 수 있습니다. 후속 응답 구현에 관한 자세한 내용은 스마트 홈 액션 알림을 참고하세요.

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

성공: 잠김

필드 유형 설명
followUpToken 문자열

필수사항.

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

필수사항.

요청 결과입니다.

지원되는 값:

SUCCESS
isLocked Boolean

필수사항.

기기가 잠겨 있는지 여부를 나타냅니다.

실패

필드 유형 설명
followUpToken 문자열

필수사항.

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

필수사항.

요청 결과입니다.

지원되는 값:

FAILURE
errorCode 문자열

필수사항.

이 값은 이 특성의 오류 코드일 수 있습니다(예: deviceJammingDetected).

예

현관 도어락 잠가 줘 (성공 사례의 후속 응답)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": true,
      "followUpToken": "1234"
    }
  }
}

현관 도어락 열어 줄래 (성공 사례의 후속 응답)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": false,
      "followUpToken": "1234"
    }
  }
}

현관 도어락 잠가 줘 (실패 사례의 후속 응답)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "deviceJammingDetected",
      "followUpToken": "1234"
    }
  }
}

샘플 발화

de-DE

  • Bitte Eingangstür abschließen
  • Bitte schließ die Eingangstür auf

en-US

  • lock my doors
  • unlock study room

es-ES

  • cierra la puerta con llave
  • quitar el cerrojo de la puerta de entrad a

fr-FR

  • déverrouille la porte d'entrée
  • verrouille la porte d'entrée

hi-IN

  • फ़्रंट डोर अनलॉक करो
  • सामने के दरवाजे को लॉक करो

it-IT

  • apri la porta d'ingresso
  • puoi chiudere la porta d'ingresso a chiave

ja-JP

  • 玄関のドア を施錠して
  • 玄関 開錠して

ko-KR

  • 도어락 잠가 줘
  • 현관 도어락 열어 줄래

nl-NL

  • Ontgrendel de voordeur
  • doe de voordeur op slot

pt-BR

  • Tranca a porta do quarto .
  • destranca a porta da cozinha
  • destrancar a porta da frente
  • trancar a porta da frente

sv-SE

  • lås upp ytterdörren
  • lås ytterdörren

기기 오류

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