Audio
Audio(오디오) 위젯은 오디오 파일을 재생하는 플레이어입니다.
재생·일시정지·10초 앞뒤 이동 버튼과 재생 위치 슬라이더가 있는 기본 UI를 함께 제공합니다.
정의 / 역할
Audio 위젯은 지정한 오디오 소스(에셋·URL)를 재생합니다. 볼륨·재생 속도·좌우 밸런스·반복 여부와 시작 위치를 설정할 수 있고, 앱이 백그라운드로 전환될 때의 동작도 지정할 수 있습니다.
- 카테고리: Contents
- 기본 UI: 재생/일시정지·10초 앞뒤 이동 버튼과 재생 위치 슬라이더
- 기본 볼륨:
0.5 - 기본 재생 상태:
Stop
기능
| 기능 | 설명 |
|---|---|
| 재생 / 정지 | status 값으로 오디오 재생과 정지를 제어합니다. |
| 반복 재생 | loop를 켜면 재생이 끝난 뒤 seek 위치부터 다시 반복합니다. |
| 볼륨 · 속도 · 밸런스 | volume, playBackRate, balance로 음량·재생 속도·좌우 음향 밸런스를 조정합니다. |
| 시작 위치 지정 | seek로 전체 길이 대비 시작 위치를 백분율(%)로 지정합니다. |
| 기본 UI 표시 | showUi를 켜면 재생/일시정지·10초 이동 버튼과 진행 슬라이더가 표시됩니다. |
| 백그라운드 동작 | playBackgroundOption으로 앱이 백그라운드로 갈 때 재생을 정지·일시정지·유지할지 선택합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Audio 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서
audio속성에 재생할 오디오 소스(에셋·URL)를 지정합니다. - 필요하면
volume·loop·playBackRate·balance등을 조정합니다. status를Play로 설정하면 재생이 시작됩니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
audio | 재생할 오디오 소스 (에셋 또는 URL) | 없음 (빈 소스) | 오디오 소스 |
showUi | 기본 플레이어 UI(버튼·슬라이더) 표시 여부 | true | 참/거짓(bool) |
status | 재생 상태 | Stop | Stop, Play |
loop | 반복 재생 여부 | false | 참/거짓(bool) |
volume | 재생 볼륨 | 0.5 | 숫자 0.0 ~ 1.0 |
seek | 재생 시작 위치 (전체 길이 대비 %) | 0 | 정수 0 ~ 99 |
playBackRate | 재생 속도 배율 | 1.0 | 숫자 0.5 ~ 2.0 |
balance | 좌우 음향 밸런스 | 0.0 | 숫자 -1.0 ~ 1.0 |
playBackgroundOption | 앱이 백그라운드로 갈 때의 재생 동작 | Disable | Disable, DisablePause, Enabled |
주의 / 팁
경고
audio 소스가 비어 있으면(빈 URL) 아무 소리도 재생되지 않습니다. 재생하려면 audio 속성에 오디오 소스를 반드시 지정해야 합니다.
팁
seek는 초 단위가 아니라 전체 길이 대비 백분율(0~99)입니다. loop를 켜면 재생이 끝난 뒤 이 위치부터 다시 반복됩니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Audio (오디오) Widget Control 문서에서 확인하세요.