Video Player Enhancement 사용 준비
- 인쇄
- PDF
Video Player Enhancement 사용 준비
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC 환경에서 이용 가능합니다.
Video Player Enhancement의 원활한 이용을 위한 클라우드 환경 사양, 요구 사항, 에러 코드, 기능별 지원 사항 및 이용 요금을 확인합니다.
클라우드 환경 사양
Video Player Enhancement가 지원하는 클라우드 환경 사양은 다음과 같습니다.
| 항목 | 지원 사양 |
|---|---|
| 리전(존) | 한국, 미국, 홍콩, 싱가포르, 일본, 독일 |
| 플랫폼 | Classic, VPC |
| 언어 | 한국어, 영어, 일본어 |
요구 사항
Video Player Enhancement를 사용하려면 다음과 같은 환경이 필요합니다.
- 외부와의 통신이 가능한 환경
- 크로미엄 기반의 웹 표준을 준수하는 브라우저
웹 브라우저 지원 사양
Video Player Enhancement를 사용할 수 있는 웹 브라우저 지원 사양은 다음과 같습니다.
| 디바이스 구분 | 브라우저 구분 | 최소 버전 | 개발 환경 |
|---|---|---|---|
| PC | 크롬 | 최신(Latest) 버전 | - |
| 사파리 | 14 이상 버전 | - | |
| 엣지 | 최신(Latest) 버전 | - | |
| 파이어폭스 | 최신(Latest) 버전 | - | |
| 웨일 | 최신(Latest) 버전 | - | |
| iOS | 사파리 | 14 이상 버전 | Xcode |
| 웹뷰 | iOS 14.0 이상 | ||
| Android | 크롬 | 최신(Latest) 버전 | Android Studio(gradle 4.2.2 d 이상) |
| 삼성 브라우저 | 최신(Latest) 버전 | ||
| 웹뷰 | 8.0(Oreo) 이상 |
에러 코드
Video Player Enhancement에서 발생할 수 있는 에러 코드는 다음과 같습니다.
| 에러 번호 | 에러 코드 | 설명 |
|---|---|---|
| E0001 | ACCESS DENIED | 잘못된 옵션 값이 전달되는 경우 발생하며, 동영상 재생 불가
|
| E0002 | NOT AUTHORIZED | 잘못된 요청으로 플레이어 인증이 실패하는 경우 발생
|
| E0003 | NETWORK ERROR | 네트워크 문제로 플레이어 인증이 실패하는 경우 발생
|
| E0004 | CANNOT PLAY VIDEO | 영상 재생에 실패하는 경우 발생
|
| E0005 | LICENSE IS INVALID | 플레이어 라이선스가 만료되었을 때 발생하며, 동영상 재생 불가
|
| E0006 | LIMIT DENIED | 무료 플레이어 월 사용량을 모두 소진한 경우 발생하며, 동영상 재생 불가
|
기능별 지원 사항
디바이스/브라우저에 대한 기능별 지원 사항은 다음과 같습니다.
전체화면
디바이스/브라우저별 전체화면 제공 형태는 다음과 같습니다.
| 디바이스 정보 | 상황 | 제공 형태 |
|---|---|---|
| Android 모바일 웹 | 크롬, 엣지, 삼성 브라우저 | VPE UI 정상 제공(Type-1) |
| Android 앱 | Native SDK | VPE UI 정상 제공(Type-1) |
| iOS 모바일 웹 | 사파리 | 강제 OS Native Player(Type-2) |
| iOS 앱 | Native SDK | VPE UI 정상 제공(Type-1) |
| iPadOS 모바일 웹 | 사파리 | VPE UI 정상 제공(Type-1) |
| iPadOS 앱 | Native SDK | VPE UI 정상 제공(Type-1) |
| PC 브라우저 | 크롬, 엣지(크로미움), 웨일, 사파리, 파이어폭스 | VPE UI 정상 제공(Type-1) |
| PC 브라우저 | IE 계열, 구형 엣지 | 제공하지 않음 |
전체화면은 다음과 같이 제공됩니다.
- Video Player Enhancement 전체화면 UI
- iOS OS Native 플레이어(iOS 버전별로 다른 UI)
참고
애플 정책상 iPhone일 경우, 반드시 OS Native 플레이어를 이용해야 합니다.
PIP(Picture-In-Picture)
디바이스/브라우저별 PIP 제공 형태는 다음과 같습니다.
| 디바이스 정보 | 상황 | 제공 형태 |
|---|---|---|
| Android 모바일 웹 | 크롬, 삼성 브라우저 | PIP 지원 가능 |
| Android 앱 | Native SDK | PIP 지원 가능, 고객사 추가 개발 필요 |
| iOS 모바일 웹 | 사파리 | PIP 지원 가능 |
| iOS 앱 | Native SDK | PIP 지원 가능 |
| iPadOS 모바일 웹 | 사파리 | PIP 지원 가능 |
| iPadOS 앱 | Native SDK | PIP 지원 가능 |
| PC 브라우저 | 크롬, 엣지(크로미움), 웨일, 사파리 | PIP 지원 가능 |
| PC 브라우저 | IE 계열, 구형 엣지, 파이어폭스 | 지원 불가 |
참고
파이어폭스 계열은 브라우저 자체에서 PIP 기능이 제공됩니다.
볼륨 컨트롤 UI
디바이스/브라우저별 볼륨 컨트롤 UI 제공 형태는 다음과 같습니다.
참고
- 디바이스 볼륨과 플레이어 볼륨이 싱크되지 않으며, 모바일에서 플레이어의 볼륨은 항상 100%로 동작합니다.
- 볼륨 컨트롤 UI기능은 모바일 UI를 기준으로 설명합니다.
- 모바일에서 강제로 PC UI를 선택할 수 있으나, 정상 동작은 보장하지 않습니다.
| 디바이스 정보 | 상황 | 제공 형태 |
|---|---|---|
| Android 모바일 웹 | 크롬, 삼성 브라우저 | 음소거만 지원 |
| Android 앱 | Native SDK | 음소거만 지원 |
| iOS 모바일 웹 | 사파리 | 음소거만 지원 |
| iOS 앱 | Native SDK | 음소거만 지원 |
| iPadOS 모바일 웹 | 사파리 | 음소거만 지원 |
| iPadOS 앱 | Native SDK | 음소거만 지원 |
| PC 브라우저 | 크롬, 엣지(크로미움), 웨일, 사파리 | 음소거, 볼륨 컨트롤 지원(PC UI 기준) |
| PC 브라우저 | IE 계열, 구형 엣지, 파이어폭스 | 지원 불가 |
디바이스 자동회전
전체화면 시 디바이스에서 플레이어 자동 회전에 대한 특징은 다음과 같습니다.
모바일 웹 전체화면(Android의 모든 브라우저)
Android의 모든 브라우저에서 전체화면 전환 시 다음과 같은 특징을 가지고 있습니다.
- 플레이어가 제공하는 모든 UI가 그대로 유지됩니다.
- 전체화면 해제 시 재생 정지 없이 재생 상태가 유지됩니다.
- 브라우저를 통해 서비스되는 플레이어는 디바이스 회전을 제어할 권한이 없기 때문에, 세로 상태에서 전체화면 전환 시 세로 전체화면으로 시작됩니다.
- 세로 전체화면에서 사용자가 직접 디바이스를 회전시켜야 가로 전체화면으로 변환할 수 있습니다. 단, 사용자 디바이스의 자동 회전이 잠금된 경우, 화면이 가로로 회전하지 않습니다.
모바일 웹 전체화면(iPhone의 사파리)
iPhone의 사파리에서 전체화면 전환 시 다음과 같은 특징을 가지고 있습니다.
- iOS OS Native 플레이어가 강제 실행됩니다.(애플 정책)
- iOS 버전에 따라 UI 디자인에 차이가 있습니다.
- 전체화면 해제 시 재생이 정지됩니다.
- 브라우저를 통해 서비스되는 플레이어는 디바이스 회전을 제어할 권한이 없기 때문에, 세로 상태에서 전체화면 전환 시 세로 전체화면으로 시작됩니다.
- 세로 전체화면에서 사용자가 직접 디바이스를 회전시켜야 가로 전체화면으로 변환할 수 있습니다. 단, 사용자 디바이스의 자동 회전이 잠금된 경우, 화면이 가로로 회전하지 않습니다.
모바일 웹 전체화면(iPad)
iPad의 모바일 웹에서 전체화면으로 전환 시 다음과 같은 특징을 가지고 있습니다.
- 플레이어가 제공하는 모든 UI가 그대로 유지됩니다.
- 전체화면 해제 시 재생 정지 없이 재생 상태가 유지됩니다.
- 왼쪽 상단에 Native 닫기 버튼이 표시됩니다.(OS 강제)
- 브라우저를 통해 서비스되는 플레이어는 디바이스 회전을 제어할 권한이 없기 때문에, 세로 상태에서 전체화면 전환 시 세로 전체화면으로 시작됩니다.
- 세로 전체화면에서 사용자가 직접 디바이스를 회전시켜야 가로 전체화면으로 변환할 수 있습니다. 단, 사용자 디바이스의 자동 회전이 잠금된 경우, 화면이 가로로 회전하지 않습니다.
Video Player Enhancement Native SDK 전체화면(iPhone, Android)
iPhone과 Android의 Video Player Enhancement Native SDK에서 전체화면 전환 시 다음과 같은 특징을 가지고 있습니다.
- 플레이어가 제공하는 모든 UI가 유지됩니다.
- 화면 전환 시 재생 정지 없이 재생 상태가 유지됩니다.
- 전체화면 전환 시 자동으로 가로 회전됩니다.
- 전체화면 해제 시 자동으로 세로 회전됩니다.
이용 요금
Video Player Enhancement는 이용 요금제에 따라 기본 요금을 과금하며, 기본 요금에 포함된 호출 건수를 초과할 경우 초과한 건당 추가 요금이 과금됩니다. 또한, Video Player Enhancement의 이용을 위해 함께 사용하는 연동 서비스에 대한 요금은 별도로 과금되며 자세한 요금 기준은 각 서비스 소개 페이지를 통해 확인해 주십시오.
Video Player Enhancement의 이용 요금에 대한 자세한 기준은 포털의 서비스 > Media > Video Player Enhancement 메뉴 또는 리전별 요금 안내 페이지를 참고해 주십시오.
이 문서가 도움이 되었습니까?