스마트 홈 타이머 특성 스키마

action.devices.traits.Timer - 타이머 특성은 기기의 타이머를 나타냅니다.

예: 스마트 스프링클러 컨트롤러 또는 스마트 조명 스위치에 타이머가 내장되어 있을 수 있습니다. 이 특성은 기본 제공 타이머를 제어하는 데 사용할 수 있으며 새 타이머 시작하기, 실행 중인 타이머 일시중지 및 취소와 같은 기기 시간이 얼마나 남았는지 묻습니다.

기기 속성

이 특성이 있는 기기는 다음을 보고할 수 있습니다. 속성을 SYNC 작업의 일부로 사용할 수 있습니다. 배우기 위해 SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

속성 유형 설명
maxTimerLimitSec 정수

필수사항.

기기에서 사용할 수 있는 가장 긴 타이머 설정을 나타내며 초 단위로 측정됩니다.
commandOnlyTimer Boolean

(기본값: false)

기기가 단방향 (true) 통신 사용을 지원하는지 또는 양방향 (false) 통신 사용을 지원하는지 여부를 나타냅니다. 기기가 이 트레잇에 관한 QUERY 인텐트 또는 상태 보고에 응답할 수 없는 경우 이 속성을 true로 설정합니다.

예

타이머 제한이 2시간인 기기

{
  "maxTimerLimitSec": 7200
}

기기 상태

이 특성을 가진 항목은 다음을 보고할 수 있습니다. QUERY 작업의 일부로 제공됩니다. 배우기 위해 QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

주 유형 설명
timerRemainingSec 정수

필수사항.

현재 남은 시간(초), -1 또는 [0, maxTimerLimitSec] 실행 중인 타이머가 없음을 나타내기 위해 -1로 설정합니다.
timerPaused Boolean

활성 타이머가 있지만 현재 일시중지된 경우 true입니다.

예

기기 타이머에 시간이 얼마나 남았나요? (실행 중이 아님)

{
  "timerRemainingSec": -1
}

기기 타이머에 시간이 얼마나 남았나요? (실행 중).

{
  "timerRemainingSec": 60
}

기기 타이머에 시간이 얼마나 남았나요? (일시중지됨).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

기기 명령어

이 특성을 가진 기기는 다음에 응답할 수 있습니다. EXECUTE 작업의 일부로 사용할 수 있습니다. 배우기 위해 EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

action.devices.commands.TimerStart

새 타이머를 시작합니다.

매개변수

매개변수 유형 설명
timerTimeSec 정수

필수사항.

타이머 지속 시간(초)입니다. [1, maxTimerLimitSec] 이내여야 합니다.

예

기기 타이머를 5분 동안 실행합니다.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

타이머를 시작하는 중에 오류가 발생했습니다.

지원되는 값:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

타이머 시간을 조정합니다.

매개변수

매개변수 유형 설명
timerTimeSec 정수

필수사항.

타이머의 양수 또는 음수 조정(초) [-maxTimerLimitSec, maxTimerLimitSec] 내에 있어야 합니다.

예

기기 타이머에 1분을 추가합니다.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

기기 타이머에서 30초 빼기

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

타이머를 조정하는 중에 오류가 발생했습니다.

지원되는 값:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

타이머를 일시중지합니다.

매개변수

매개변수 유형 설명

속성이 없습니다.

예

기기 타이머를 일시중지합니다.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

타이머를 일시중지하는 중에 오류가 발생했습니다.

지원되는 값:

noTimerExists

action.devices.commands.TimerResume

타이머 다시 시작.

매개변수

매개변수 유형 설명

속성이 없습니다.

예

기기 타이머를 다시 시작합니다.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

타이머를 다시 시작하는 중에 오류가 발생했습니다.

지원되는 값:

noTimerExists

action.devices.commands.TimerCancel

타이머를 취소합니다.

매개변수

매개변수 유형 설명

속성이 없습니다.

예

기기 타이머를 중지합니다.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

타이머를 중지하는 중에 오류가 발생했습니다.

지원되는 값:

noTimerExists

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.