Video
Video(비디오) 위젯은 앱 화면에 동영상을 재생하는 미디어 플레이어입니다.
재생·정지·볼륨·재생 속도·반복 등을 설정할 수 있고, 영상 위에 재생 컨트롤 UI를 함께 표시할 수 있습니다.
정의 / 역할
Video 위젯은 지정한 동영상 소스(네트워크·파일·에셋)를 재생하는 플레이어 영역을 그려줍니다. 자동 반복, 볼륨/음소거, 재생 속도, 시작 위치, 재생 컨트롤 UI 표시 여부 등을 속성으로 설정합니다.
- 카테고리: Contents
- 기본 크기: 너비 가로 꽉 참 · 높이 200
- 편집 화면 기본 표시:
Media라벨이 들어간 빈 영역
기능
| 기능 | 설명 |
|---|---|
| 동영상 재생 | 네트워크·파일·에셋 소스의 동영상을 재생합니다. |
| 재생 제어 | 재생·정지 상태(status), 시작 위치(seek), 반복(loop)을 설정합니다. |
| 소리 제어 | 볼륨(volume)과 음소거(mute)를 설정합니다. |
| 재생 속도 | 0.5~2.0배 범위로 재생 속도를 조정합니다. |
| 컨트롤 UI | 영상 위에 재생/정지·진행 바·볼륨·속도 컨트롤을 표시합니다. |
| 표시 영역 | 영상에서 보여줄 영역(잘라내기 비율, viewport)을 지정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Video 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 동영상 소스(
media)를 지정합니다. - 필요하면
loop,volume,playBackRate,showControlUI등을 조정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
media | 재생할 동영상 소스(네트워크·파일·에셋) | 미지정 | 미디어 소스 |
loop | 재생이 끝나면 자동으로 다시 재생 | false (끔) | 참/거짓 |
volume | 재생 볼륨 | 0.5 | 숫자 0.0~1.0 |
seek | 재생 시작 위치 (전체 길이 대비 백분율) | 0 | 숫자 0~99 |
playBackRate | 재생 속도 배율 | 1.0 | 숫자 0.5~2.0 |
showControlUI | 재생 컨트롤 UI 표시 여부 | true (표시) | 참/거짓 |
fullScreen | 전체화면 사용 여부 | true (사용) | 참/거짓 |
mute | 음소거 여부 | false (끔) | 참/거짓 |
status | 재생 상태 | Stop (정지) | Stop, Play |
viewport | 영상에서 보여줄 영역(잘라내기 비율) | 전체 (x:0, y:0, 너비:1, 높이:1) | 뷰포트 값 |
주의 / 팁
팁
volume은 0.0~1.0 범위입니다. mute가 켜져 있으면 볼륨 값과 무관하게 소리가 나지 않습니다.
노트
seek은 초 단위가 아니라 전체 길이 대비 백분율(0~99)입니다. 예를 들어 50은 영상의 중간 지점에서 시작합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Video (비디오) Widget Control 문서에서 확인하세요.