스마트 홈 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	필수사항. 작업 결과입니다. 지원되는 값: SUCCESS
currentCycleRemainingTime	정수	필수사항. 현재 주기에 남은 시간(초)입니다.
1	객체	실패
priority	정수	필수사항. 알림 수준을 나타냅니다. 현재 지원되는 값은 0으로, 알림을 소리내어 읽어야 함을 나타냅니다.
status	String	필수사항. 작업 결과입니다. 지원되는 값: FAILURE
errorCode	String	필수사항. 값은 이 트레잇의 오류 코드(예: deviceStuck)일 수 있습니다.

예

기기의 실행이 완료되었습니다.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

현재 주기를 완료하는 중에 오류가 발생했습니다.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

기기 오류

오류 및 예외의 전체 목록을 참고하세요.