스마트 홈 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"
}
}