스마트 홈 도어락 가이드
action.devices.types.LOCK - 도어락은 잠그고, 잠금 해제하고, 잠금 상태를 보고할 수 있습니다.
이 유형은 기기에 잠금 아이콘과 일부 관련 동의어 및 별칭이 표시됨을 나타냅니다.
기기 기능
서비스에서 지원해야 하는 속성 및 상태, EXECUTE 및 QUERY 응답을 빌드하는 방법과 같은 구현 세부정보는 해당 특성 문서를 참고하세요.
필수 특성
이러한 특성과 명령어는 기기에 적용되는 경우 필요합니다. 기기에서 이러한 특성을 지원하지 않으면 QUERY 또는 EXECUTE 응답에 functionNotSupported 오류 코드를 입력합니다. 자세한 내용은 오류 및 예외를 참고하세요.
기기 예: 간단한 도어락
이 섹션에는 위의 기기 유형과 특성을 기반으로 하는 일반적인 '잠금'을 나타내는 인텐트 페이로드의 예가 포함되어 있습니다. 구현에서 특성을 추가하거나 삭제하는 경우 이러한 변경사항을 반영하도록 응답을 적절히 수정하세요.
샘플 SYNC 응답
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.LOCK", "traits": [ "action.devices.traits.LockUnlock" ], "name": { "name": "Simple lock" }, "willReportState": true, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
샘플 QUERY 응답
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "isLocked": true, "isJammed": false } } } }
샘플 실행 명령어
LockUnlock
명령어 매개변수에 관한 자세한 내용은
action.devices.traits.LockUnlock 참조를 확인하세요.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.LockUnlock", "params": { "lock": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isLocked": true, "isJammed": false } } ] } }