YouTube 동영상 활용하기
YouTube 에서는 다양한 옵션 기능을 제공하고 있습니다. 게임에서는 이 기능을 활용해 다양한 이벤트를 진행할 수 있습니다.
URL로 YouTube 재생¶
URL로 YouTube 영상을 재생했을 때 사용자의 기기에 YouTube 앱이 설치되어 있으면 앱에서, 없으면 웹 브라우저 (예. Chrome, Safari)에서 실행됩니다.
앱에서 자막 노출하기¶
YouTube 영상을 등록할 때 태그에 ‘yt:cc=on‘을 추가합니다. 유저가 다른 영상을 재생할 때 자막 노출 안 함으로 설정했더라도 해당 태그가 등록된 영상을 재생하면 자막이 강제 노출됩니다. 해당 설정으로 노출되는 자막 언어는 YouTube에서 자체적으로 결정합니다.
웹에서 자막 노출하기¶
YouTube Embed URL을 이용하여 강제 자막 노출과 자막 언어를 설정할 수 있습니다. cc_load_policy 파라미터로 자막 강제 노출 여부를, hl 파라미터로 노출할 자막 언어를 결정합니다.
- 형식: https://www.youtube.com/embed/동영상 ID}?cc_load_policy={강제 자막 노출 여부}&hl={자막 노출 언어}
- 예시: https://www.youtube.com/embed/4Fpeq3R0QXE?cc_load_policy=1&hl=ko
Hive에서 YouTube 재생¶
Hive 에서 YouTube 영상을 재생 시, 아래의 다양한 옵션값을 활용할 수 있습니다. 필요한 옵션값은 이벤트 페이지 개발 단계에서 적용 할 수 있도록 요청해주시면 반영하여 개발이 진행됩니다.
| 옵션명 | 코드 | 설명 |
|---|---|---|
| 자동재생 | autoplay | 영상 자동재생 여부를 설정할 수 있습니다. |
| 자막 | cc_load_policy | 동영상에 자막 표시 여부를 설정할 수 있습니다. 언어값(아래 hl옵션)을 설정하지 않을 경우, 언어는 YouTube 자체 알고리즘에 의해 결정됩니다. |
| 컨트롤러 | controls | 동영상 컨트롤러 표시 여부를 설정할 수 있습니다. |
| 재생 시작 시간 | start | 동영상 재생을 시작할 시간을 설정할 수 있습니다. |
| 재생 종료 시간 | end | 동영상 재생을 중지할 시간을 설정할 수 있습니다. |
| 전체 화면 | fs | 동영상 컨트롤러에 전체 화면 버튼을 표시할지 여부를 설정할 수 있습니다. |
| 언어값 | hl | 동영상 인터페이스 및 자막 언어값을 설정할 수 있습니다. 해당 값에 따라 동영상 제목과 자막 등의 모든 언어가 결정됩니다. 해당 값이 설정되어있지 않는 경우, YouTube 자체 알고리즘이 노출할 언어를 결정합니다. |
| 특수 효과 | iv_load_policy | 동영상의 특수효과를 표시할지 여부를 설정할 수 있습니다. controls 옵션이 비활성화된 상태에서만 해당 옵션이 동작합니다. |
| 반복 재생 | loop | 동영상 재생이 종료된 후 반복 재생할지 여부를 설정할 수 있습니다. |
| YouTube 로고 표시 | modestbranding | YouTube 로고를 동영상 재생 중 노출할지 여부를 결정할 수 있습니다. controls 옵션이 비활성화된 상태에서만 해당 옵션이 동작합니다. |
| 플레이 리스트 | playlist | 재생할 동영상 ID를 쉼표로 구분한 목록을 노출할지 여부를 설정할 수 있습니다. |
| 재생 화면 타입 | playinline | iOS에서 동영상을 웹뷰로 재생할지 혹은 전체화면을 재생할지 여부를 설정할 수 있습니다. 웹뷰로 재생을 권장합니다. |
| 관련 영상 표시 | rel | 동영상 재생이 종료되면 관련 동영상을 표시할지 여부를 설정할 수 있습니다. |
| 관련 정보 표시 | showinfo | 동영상 재생을 시작하기 전에, 동영상 관련한 정보를 표시할지 여부를 설정할 수 있습니다. |