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

필수사항.

작업의 결과입니다.

지원되는 값:

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"
  }
}

기기 오류

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