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

스마트 홈 잠금 해제 특성 스키마

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 String

후속 응답을 위해 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 String

필수사항.

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

status String

필수사항.

요청의 결과입니다.

지원 값:

SUCCESS
isLocked Boolean

필수사항.

기기의 잠금 여부를 나타냅니다.

실패

필드 유형 설명
followUpToken String

필수사항.

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

status String

필수사항.

요청의 결과입니다.

지원 값:

FAILURE
errorCode String

필수사항.

이 특성의 모든 오류 코드가 값이 될 수 있습니다(예: 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 에잉스투르 압슐리센
  • 비테 슐리슈 다이 에강스튀르 auf

en-US

  • 자물쇠 내 문
  • 잠금 해제 학습실

es-ES

  • 시에라 라 푸에르타 Con llave
  • 퀴타르 el cerrojo de la puerta de entrad a

fr-FR

  • 데베르후유 la porte d'entrée
  • 베로유레 라 포르테 디엔테

기기 오류

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