스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

기기 오류

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