스마트 홈 RunCycle 특성 스키마
action.devices.traits.RunCycle
- 이 특성은 쿼리할 수 있는 운영 시간이 지속되는 기기를 나타냅니다.
이와 같은 기기는 작업 시작 시 총 사이클 수를 보고하고 기기가 현재 실행 중인 각 사이클을 보고합니다. 이렇게 하면 사용자가 다음과 같은 쿼리를 할 수 있습니다.
- 건조기가 무슨 사이클이야?
- 식기세척기에서 사이클이 몇 개나 남았나요?
- 건조기는 어떤 일을 하나요?
- 세척은 언제 진행되나요?
특정 기기는 비주기적 형식의 기간을 포함합니다. 특정 시간 동안 실행되는 기기는 사이클 없이 남은 시간을 보고할 수 있습니다. 또한 사이클이 일관되지 않을 수 있는 경우도 처리합니다 (예: 식기세척기가 항상 모든 사이클을 사용하지는 않을 수 있음). 예를 들어 사용자가 진공청소기를 얼마나 더 오래 실행할 것인가?라고 물을 수 있습니다. 그러면 청소기에 남은 시간에 비례하는 시간이 반환됩니다. 이는 위에 나열된 기기에도 적용됩니다. 옷이 얼마 동안 건조되나요?는 기간을 분 단위로 반환합니다.
기기가 알고 있는 정보를 반환할 수 있고 어시스턴트 TTS 응답이 가능한 데이터로 최상의 답변을 구성합니다 (예: 식기세척기가 실행 중이며 약 20분 후 완료).
RunCycle은 현재 읽기 전용 특성입니다. 이 명령어에는 명령어가 없고 쿼리할 상태만 있습니다. 향후 사이클을 재실행하거나 자전거를 건너뛰는 메커니즘이 제공될 가능성이 있습니다 (스프링클러에는 좋고 세탁기에 적합하지 않음).
기기 속성
없음.
기기 상태
이 특성이 있는 항목은 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" } }