Youtube
Youtube(유튜브) 위젯은 YouTube 동영상을 앱 화면 안에 내장(임베드)해 재생하는 플레이어입니다.
영상 URL만 지정하면 자동 재생·반복·시작/끝 지점·자막 등 재생 옵션을 함께 설정할 수 있습니다.
정의 / 역할
Youtube 위젯은 YouTube 영상 URL(watch · embed · youtu.be · 재생목록 형태)을 받아 내부 웹뷰로 임베드 플레이어를 그려줍니다. URL에서 영상 ID를 추출해 재생하며, 자동 재생·반복·시작/끝 지점·컨트롤 표시·자막 여부 등 재생 옵션을 속성으로 조정합니다. URL이 비어 있으면 재생 대신 Youtube Player 안내 영역을 표시합니다.
- 카테고리: Contents
- 팔레트에 추가 시 기본 높이:
400 - 기본 재생 상태:
Play(자동 재생 + 자동 음소거)
기능
| 기능 | 설명 |
|---|---|
| URL 임베드 재생 | watch · embed · youtu.be 및 재생목록(list) URL에서 영상 ID를 추출해 내장 플레이어로 재생합니다. |
| 자동 재생 / 음소거 | 재생 상태를 Play로 두면 자동 재생되며, 자동 재생을 위해 영상이 자동으로 음소거됩니다. |
| 구간 지정 | 재생 시작 지점과 끝 지점을 초 단위로 지정합니다. |
| 반복 재생 | 영상을 반복 재생합니다. |
| 재생 UI 옵션 | 플레이어 컨트롤·관련 동영상·로고 최소화·전체화면 버튼·자막 표시 여부를 설정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Youtube 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서
path에 재생할 YouTube 영상 URL을 입력합니다. - 필요하면 자동 재생(
status)·반복(loop)·시작/끝 지점(startSecond·endSecond) 등 재생 옵션을 조정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
path | 재생할 YouTube 영상 URL (watch · embed · youtu.be · 재생목록) | 빈 값 | 문자열 |
status | 재생 상태. Play면 자동 재생되며 이때 자동 음소거됩니다. | Play | Stop, Play |
startSecond | 재생 시작 지점(초). 0이면 처음부터 재생 | 0 | 숫자(초) |
endSecond | 재생 끝 지점(초). 0이면 끝까지 재생 | 0 | 숫자(초) |
loop | 반복 재생 여부 | false | 참/거짓 |
showControls | 플레이어 컨트롤 UI 표시 여부 | true | 참/거짓 |
showRel | 영상 종료 후 관련 동영상 표시 여부 | true | 참/거짓 |
modestbranding | YouTube 로고 최소화 여부 | false | 참/거짓 |
fullScreen | 전체 화면 버튼 표시 여부 | true | 참/거짓 |
ccLoadPolicy | 자막 표시 여부 | false | 참/거짓 |
showLoadingBar | 페이지 로딩 중 로딩 표시기 노출 여부 | false | 참/거짓 |
주의 / 팁
노트
path가 비어 있으면 플레이어 대신 Youtube Player 안내 영역만 표시됩니다. 유효한 YouTube URL을 입력해야 영상이 재생됩니다.
팁
status를 Play로 두면 자동 재생을 위해 영상이 자동으로 음소거됩니다. 또한 startSecond·endSecond는 반복 재생(loop)일 때 최초 재생에만 적용됩니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Youtube (유튜브) Widget Control 문서에서 확인하세요.