Timer
Timer(타이머) 위젯은 지정한 시간을 카운트다운하거나 경과 시간을 세어 화면에 표시하는 시간 표시 위젯입니다.
제한 시간, 스톱워치, 이벤트 종료 알림 등에 사용합니다.
정의 / 역할
Timer 위젯은 설정한 형식(mm:ss 등)으로 시간을 텍스트로 그려줍니다. 카운트다운 모드는 지정한 시간에서 0까지 줄어들고, 카운트업 모드는 0부터 증가합니다. 스크립트로 시작·정지·리셋할 수 있으며, 카운트다운이 00:00에 도달하면 만료 동작을 실행할 수 있습니다.
- 카테고리: Contents
- 기본 모드: 카운트다운 (
countDown) - 기본 표시 형식:
mm:ss - 기본 카운트다운 시간: 60초 (60000ms)
- 기본 갱신 간격: 1초 (1000ms)
기능
| 기능 | 설명 |
|---|---|
| 카운트다운 / 카운트업 | 모드에 따라 지정 시간에서 감소하거나 0부터 증가합니다. |
| 시간 형식 표시 | hh:mm:ss, mm:ss, ss 및 밀리초를 포함한 형식으로 표시합니다. |
| 스크립트 제어 | 시작·정지·리셋·실행 여부 확인을 스크립트로 처리합니다. |
| 만료 이벤트 | 카운트다운이 00:00에 도달하면 onExpired에 연결한 동작을 실행합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Timer 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 모드(
timerType)와 표시 형식(timeFormat)을 설정합니다. - 카운트다운 모드면
countdownTimeMs로 제한 시간을 지정합니다. - 필요하면
onExpired에 만료 시 실행할 동작을 연결하고, 스크립트로start()·stop()·reset()을 호출합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
timerType | 타이머 모드 (카운트다운/카운트업) | countDown | countDown, countUp |
timeFormat | 시간 표시 형식 | mmss | hhmmss, mmss, ss, hhmmssMs, mmssMs, ssMs |
countdownTimeMs | 카운트다운 시작 시간 (밀리초) | 60000 (60초) | 숫자(ms) |
updateIntervalMs | 화면 갱신 간격 (밀리초) | 1000 (1초) | 숫자(ms) |
style | 글자 스타일 (색·크기 등) | 기본 스타일 (지정 안 함) | 텍스트 스타일 |
주의 / 팁
경고
카운트다운 모드에서만 onExpired가 발생합니다. 카운트업 모드는 상한 없이 계속 증가하므로 만료 이벤트가 없습니다.
팁
편집(디자인) 모드에서는 타이머가 실제로 동작하지 않고 시작 값 미리보기만 표시됩니다. 실행 화면에서 start()를 호출해야 시간이 흘러갑니다. 또한 updateIntervalMs를 0 이하로 두면 기본 1초(1000ms) 간격으로 동작합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Timer (타이머) Widget Control 문서에서 확인하세요.