스마트 홈 세탁기 가이드
action.devices.types.WASHER
- 세탁기의 켜기/끄기 기능과 관계없이 기능을 시작할 수 있습니다. 일부 세탁기에는 별도의 전원 버튼이 있지만 일부 세탁기는 그렇지 않습니다. 일부 제품은 세탁 중에 일시중지하거나 다시 시작할 수 있습니다.
세탁기에는 다양한 모드도 있으며 각 모드마다 고유한 관련 설정이 있습니다. 세탁기에만 해당되며 일반화된 형식으로 해석됩니다.
이 유형은 기기가 세탁기 아이콘과 일부 관련 동의어 및 별칭을 얻는 것을 나타냅니다.
Google 스마트 홈으로 세탁기를 제어하는 방법에 관한 예는 스마트 홈 세탁기 Codelab을 참고하세요.
기기 기능
서비스에서 지원해야 하는 속성 및 상태, EXECUTE 및 QUERY 응답을 빌드하는 방법과 같은 구현 세부정보는 관련 특성 문서를 참고하세요.
필수 특성
기기에 해당하는 경우 이러한 특성과 명령어가 필요합니다.
권장 특성
기기에 해당하는 경우 이러한 특성을 사용하는 것이 좋습니다. 그러나 기존의 제품 기능과 가장 잘 일치하도록 사용 가능한 모든 특성에서 자유롭게 조합할 수 있습니다.
-
action.devices.traits.Modes
-
action.devices.traits.OnOff
-
action.devices.traits.RunCycle
-
action.devices.traits.Toggles
품질 요구사항
- 지연 시간: 3000ms 이하여야 합니다.
- 안정성: 97% 이상이어야 합니다.
기기 예: 간단한 세탁기
이 섹션에는 위의 기기 유형과 특성을 기준으로 일반적인 '세탁기'를 나타내는 인텐트 페이로드의 예가 포함되어 있습니다. 구현에서 특성을 추가하거나 삭제하는 경우 이러한 변경사항을 반영하도록 응답을 수정하세요.
샘플 SYNC 응답
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.WASHER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.RunCycle", "action.devices.traits.StartStop", "action.devices.traits.Modes" ], "name": { "name": "Simple washer" }, "willReportState": true, "attributes": { "availableModes": [ { "name": "load_key", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_key", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "large_key", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true } ], "pausable": 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, "on": true, "isRunning": true, "isPaused": false, "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300, "currentModeSettings": { "load_key": "small_key" } } } } }
샘플 EXECUTE 명령어
사용 중지
명령어 매개변수에 대한 자세한 내용은
action.devices.traits.OnOff
참조를 확인하세요.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
시작 중지
명령어 매개변수에 대한 자세한 내용은
action.devices.traits.StartStop
참조를 확인하세요.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.StartStop", "params": { "start": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }
설정 모드
명령어 매개변수에 대한 자세한 내용은
action.devices.traits.Modes
참조를 확인하세요.
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_key": "large_key" } } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentModeSettings": { "load_key": "large_key" } } } ] } }