스마트 홈 RunCycle 특성 스키마
action.devices.traits.RunCycle
: 이 특성은 쿼리 가능한 작업 기간이 진행 중인 모든 기기를 나타냅니다.
이러한 기기는 작업 시작 시 총 주기 수를 보고하고 기기가 현재 실행 중인 주기마다 보고합니다. 이를 통해 사용자는 다음과 같은 쿼리를 할 수 있습니다.
- 드라이어의 사이클이 어떻게 되나요?
- 식기세척기가 몇 사이클 남았어?
- 건조기가 무슨 일을 하나요?
- 세탁은 언제 끝나요?
특정 기기에는 비주기적 형식의 기간이 포함됩니다. 특정 시간 동안 실행되는 모든 기기는 주기 없이 남은 시간을 보고할 수 있습니다. 이는 사이클이 일관되지 않을 수 있는 사례도 처리합니다 (예: 식기세척기가 항상 모든 사이클을 사용하지는 않을 수 있음). 예를 들어 사용자가 청소기 작동 시간은 얼마나 되나요?라고 물으면 남은 시간에 비례하는 시간이 단위 단위로 반환됩니다. 이는 위에 나열된 기기에도 적용됩니다. 옷이 얼마나 오래 말리나요?는 분 단위의 기간을 반환합니다.
기기는 알고 있는 정보를 반환할 수 있으며, 어시스턴트 TTS 응답은 사용 가능한 데이터를 바탕으로 최상의 답변을 제공합니다 (예: 식기 세척기가 작동 중이며 약 20분 후에 완료됩니다).
RunCycle은 현재 읽기 전용 특성입니다. 여기에는 명령어가 없고 쿼리할 상태만 있습니다. 향후에는 사이클을 재실행하거나 사이클을 건너뛰는 메커니즘 (스프링클러에는 좋음, 세탁기에는 좋지 않음)이 있을 수 있습니다.
기기 ATTRIBUTES
없음.
기기 상태
이 특성을 가진 항목은 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
상태 | 유형 | 설명 |
---|---|---|
currentRunCycle |
배열 |
필수사항. 지원되는 각 언어로 현재 주기의 동의어를 포함합니다. |
[item, ...] |
객체 |
순환 동의어 이름입니다. |
currentCycle |
String |
필수사항. 실행 중인 현재 주기입니다. |
nextCycle |
String |
선택사항입니다. 수행할 다음 주기입니다. |
lang |
String |
필수사항. 지정된 주기 이름의 언어 코드입니다. 지원되는 언어를 참고하세요. |
currentTotalRemainingTime |
정수 |
필수사항. 작업 시 남은 시간(초)입니다. |
currentCycleRemainingTime |
정수 |
필수사항. 현재 주기의 남은 시간(초)입니다. |
예시
기기를 5분 더 헹구고 20분 후에 종료됩니다.
{ "currentRunCycle": [ { "currentCycle": "rinse", "lang": "en" } ], "currentTotalRemainingTime": 1200, "currentCycleRemainingTime": 300 }
기기를 5분 더 헹군 후 회전합니다.
{ "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 }
기기 명령어
없음.
기기 알림
이 특성이 있는 기기는 기기 상태 변경의 일부로 다음 알림 페이로드를 반환할 수 있습니다. 알림 구현에 관한 자세한 내용은 스마트 홈 작업 알림을 참고하세요.
필드 | 유형 | 설명 |
---|---|---|
RunCycle |
필수사항. 알림 페이로드. |
|
다음 중 하나를 지원합니다. | ||
0
|
객체 |
성공 |
priority |
정수 |
필수사항. 알림 수준을 나타냅니다. 현재 지원되는 값은 0이며 알림을 소리내어 읽어야 함을 나타냅니다. |
status |
String |
필수사항. 작업의 결과입니다. 지원되는 값:
|
currentCycleRemainingTime |
정수 |
필수사항. 현재 주기의 남은 시간(초)입니다. |
1
|
객체 |
실패 |
priority |
정수 |
필수사항. 알림 수준을 나타냅니다. 현재 지원되는 값은 0이며 알림을 소리내어 읽어야 함을 나타냅니다. |
status |
String |
필수사항. 작업의 결과입니다. 지원되는 값:
|
errorCode |
String |
필수사항. 이 값은 이 특성의 모든 오류 코드(예: |
예시
기기 실행이 완료되었습니다.
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
현재 주기를 완료하는 중에 오류가 발생했습니다.
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }