스마트 홈 RunCycle 특성 스키마

action.devices.traits.RunCycle - 이 특성은 쿼리할 수 있는 작업 기간이 지속되는 기기를 나타냅니다.

이와 같은 기기는 작업 시작 시 총 주기 수를 보고하며 기기가 현재 실행 중인 동안 각 주기를 순환시킵니다. 이를 통해 사용자는 다음과 같은 쿼리를 할 수 있습니다.

  • 건조기의 어떤 주기를 사용하나요?
  • 식기세척기가 얼마나 남았나요?
  • 건조기는 어떤 일을 하나요?
  • 세탁은 언제 완료되나요?

일부 기기에는 비주기 형식의 기간이 포함되어 있습니다. 특정 시간 동안 실행되는 모든 기기는 주기 없이 남은 시간을 보고할 수 있습니다. 또한 일관되지 않은 사이클도 처리합니다 (예: 식기세척기가 항상 모든 사이클을 사용하지 않을 수 있음). 예를 들어 사용자가 청소기를 얼마나 오래 실행할 수 있나요?라고 질문하면 남은 시간에 비례하여 단위로 시간이 반환됩니다. 이는 위에 나열된 기기에도 적용됩니다. 옷이 얼마나 말릴까요?는 분 단위로 기간을 반환합니다.

기기는 알고 있는 정보를 반환할 수 있으며 어시스턴트 TTS 응답은 사용 가능한 데이터로 최상의 답변을 제공합니다 (예: 식기세척기가 실행 중이며 약 20분 후 완료됩니다).

RunCycle은 현재 읽기 전용 특성입니다. 명령어 없이 쿼리만 상태입니다. 향후 사이클을 다시 실행하거나 사이클을 건너뛰는 메커니즘이 있을 수 있습니다 (스프링클러에는 좋음, 세탁기에는 적합하지 않음).

기기 속성

없음

기기 상태: STATES

이 특성이 있는 항목은 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
}

기기 COMMANDS

없음

기기 알림

이 특성이 있는 기기는 기기 상태가 변경될 때 다음 알림 페이로드를 반환할 수 있습니다. 알림 구현에 관한 자세한 내용은 스마트 홈 작업 알림을 참고하세요.

필드 유형 설명
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"
  }
}

기기 ERRORS

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