1. Player API
1) qPlayerLayout 클래스
- qPlayerLayout클래스는 플레이어 제어에 관련하여 사용자에게 제공되는 클래스입니다.
Android
■ 생성자 펼치기
public qPlayerLayout(Context context) public qPlayerLayout(Context context, AttributeSet attrs) public qPlayerLayout(Context context, AttributeSet attrs, int defStyle) ■ Public Methods 펼치기
boolean isShow()
플레이어의 보여짐 상태를 확인합니다.
반환 값
플레이어가 현재 보여지고 있다면 true 그렇지 않으면 falseboolean isZoom()
플레이어가 Zoom 상태인지 확인합니다.
반환값
플레이어가 현재 Zoom 상태이면 true 그렇지 않으면 falsevoid setMainWebView(WebView webview)
플레이어를 제어 할 WebView를 설정 합니다.
전달인자
webview : 플레이어를 제어 할 WebView 객체void setControlWebView(String Lrl)
플레이어의 웹 컨트롤러 Url을 설정 합니다.
전달인자
URL : 플레이어 컨트롤러 Url 경로void setAppSchema(String schema)
플레이어 웹컨트롤러에서 사용되어지는 App 스키마를 설정 합니다.
전달인자
schema : Web Controller에서 사용되어지는 App 스키마void setWebScroll(int l,int t,int oldl,int oldt)
Main WebView의 스크롤 포지션을 전달 합니다.
전달인자
l : Left Scroll Pos
t : Top Scroll Pos
oldl : Old Left Scroll Pos
oldt : Old Top Scroll Posvoid setCrypt(qCrypt crypt)
Url 암호화 객체를 전달 합니다.
전달인자
crypt : qCrpyt암호화 설정관련 작업이 완료된 qCrypt 객체void setFullVideo(boolean isWide)
플레이어를 전체화면으로 설정 합니다.
전달인자
isWide : 현재 Orientation 이 Landscape 상태라면 true 그렇지 않으면 falsevoid setInlineVideo()
플레이어를 Default 위치로 설정 합니다.void setZoomVideo()
플레이어를 Zoom 위치로 설정 합니다.void setCloseVideo()
플레이어를 닫습니다.void setPauseVideo()
플레이어를 일시정지 합니다.void setPlayerProperty(String data)
Player Property를 설정합니다.void setPlayerVideo(String data)
Video Property를 설정합니다.void setPause()
App Pause 상태로 플레이어를 설정합니다.void setResume()
App Resume 상태로 플레이어를 설정합니다.void setDestroy()
App Destroy 상태로 플레이어를 설정합니다.
2. Web Controller Protocol
- qPlayer의 Web Controller는 아래의 프로토콜을 이용하여 플레이어를 제어합니다.
■ Web Controller -> App 펼치기
전달 형식 : Schema://명령?전달값 - Web Controller 에서 사용자가 정의한 스키마를 이용하여 Url Navigate를 진행하며 App에서는 스키마를 확인하여 지정된 명령을 수행합니다.
명령 전달값 설명 close 플레이어를 닫습니다. default default Property로 Player를 위치 합니다. zoom zoom Property로 Player를 위치 합니다. full full Property로 Player를 위치 합니다. play 설정된 미디어를 재생 합니다. pause 플레이어를 일시 정지 합니다. mute string : "true" or "false" 음소거 설정 합니다. seek int value 전달 받은 값으로 재생이동 한다. setVol int value 전달 받은 값으로 볼륨을 설정 합니다. getVol Controller가 현재 장비의 볼륨 값을 전달 받습니다. setBright int value 전달 받은 값으로 밝기를 설정 합니다. getBright Controller가 현재 장비의 밝기를 전달 받습니다. hideMenu Controller를 숨긴다. seetTimeOutFlag string : "true" or "false" true일 경우 Controller가 지정된 시간이 지나면 숨겨지고 false 일경우 지정된 시간이 지나도 숨겨지지 않도록 설정합니다. navigateMainWeb string : URL 전달 받은 URL을 Main Web에 Navigate 합니다. setOnlyFullScreen string : "true' or "false" true일 경우 플레이어는 무조건 Full Screen으로 재생됩니다. false 일경우 해당 옵션이 해제 됩니다.
(default,zoom명령이 실행되면 해당 옵션은 해제 됩니다.)사용자 명령 App는 등록된 명령을 제외한 다른 명령이 입력될 경우 사용자 명령으로 인지하여 사용자가 등록한 명령을 검색을 진행 합니다. 매칭되는 명령이 존재 할 경우 지정한 javascript를 Main Web에 실행 합니다. 사용자 명령 등록은 Video Property에 정의된 callback script에서 처리 됩니다. ■ App -> Web Controller 펼치기
전달 형식 : javascript call - App에서는 javascript를 통해 현재 App의 다양한 상태를 Web Controller에게 전달 합니다.
함수 원형
function setDevice(device);
함수정의
장비 정보를 전달 한다.
전달인자
device : "android" or "iOS"함수 원형
function setupVideo(q);
함수정의
App에 설정된 Player Property가 최종적으로 적용되기 전 Web Controller에 Player Property Json 데이터를 전달 합니다.
전달인자
q : App에 적용된 Player Property Json 데이터함수 원형
function setPlayer(mode,width,height,max_volume,playing,live,duration,bright,volume);
함수정의
플레이어 위치가 변경될 때마다 현재 플레이어의 각종 정보를 전달합니다.
전달인자
mode : 현재 Player모드 (“default” or “zoom” or “full”)
width : Player 가로 크기
height : Player 세로 크기
max_volume : 장비 최대 볼륨 값
playing : 현재 재생 상태 true or false
live : live상태 인지 true or false
duration : 동영상 전체 재생시간
bright : 현재 밝기
volume : 현재 볼륨 크기함수 원형
function setSeek(current);
함수정의
현재 재생되고 있는 시간을 전달 합니다.
전달인자
current : 현재 재생시간함수 원형
function setVol(value);
함수정의
현재 볼륨 크기를 전달 합니다.
전달인자
current : 현재 볼륨 크기
(Android 전용)함수 원형
function setBright(value);
함수정의
현재 밝기를 전달 합니다.
전달인자
current : 현재 밝기
(Android 전용)
3. Api 다운로드
- Android Download
- iOS Download
- Web Controller Protocol Download