Page tree
Skip to end of metadata
Go to start of metadata

사용방법

http://v.kr.kollus.com/[MEDIA_CONTENT_KEY]?key=value&...

query string은 url 뒤에 ?를 붙이고 key와 value를 =로 엮는다. data type이 null인 경우는 key만 붙인다. key, value 쌍을 하나 이상 엮을 경우엔 &로 구분한다.

플레이어구분

플레이어는 다음과 같은 명칭으로 통일한다.

  • 모바일 : Mobile
    • iOS 전용 플레이어 : iOS
    • Android 전용 플레이어 : Android
  • 데스크탑 : Desktop
    • Flash 플레이어 : Flash
    • V2 플레이어 (ActiveX, NPAPI 플레이어) : V2
    • V3 전용 플레이어 (설치형, Agent 방식의 플레이어) : V3e
    • V3 플레이어 (HTML5 Agent 방식의 플레이어) : V3h
    • V4 플레이어 (HTML5 플레이어, 비암호화) : V4

파라미터

keyDataType지원플레이어설명
pfstringAll프로파일 자동 설정을 무시하고 지정된 프로파일 키에 해당하는 트랜스코딩 파일을 서빙. 존재하지 않으면 자동 설정.
예> ?pf=mixnut-pc-high1 (mixnut-pc-high1에 해당하는 트랜스코딩 파일을 서빙)
autoplay (a)nullAll로딩 후 동영상 자동 시작. 단, 모바일 전용 플레이어는 기본이 자동시작이다. (옵션에 영향을 받지 않음)
mutenullAll로딩 후 음소거된 상태에서 동영상 재생. 모바일 HTML5 플레이어는 시작시 음소거가 가능하지 않음.
downloadnullMobile,
V3e, V3h
컨텐츠 다운로드 기능. download 옵션을 추가하면 비디오 게이트웨이가 다운로드 모드로 동작한다. 만약 채널에서 모바일이나 PC 다운로드 옵션을 사용하지 않음으로 설정하면, 실제 다운로드를 시도하더라도 플레이어가 다운로드하지 않음.
titlestringAll지정된 제목 외에 강제로 제목 지정. 모바일 HTML5 플레이어의 경우 원래 제목이 지원되지 않음.
tintegerAll지정한 위치부터 재생함. nscreen 정보가 있더라도 이를 무시하고 주어진 시간부터 재생함. (이 경우 이어보기 팝업이 뜬다.)
예> ?t=10 (10초부터 재생)
sintegerAll지정한 위치부터 재생하는 것은 t 옵션과 동일하지만, s 옵션은 이어보기 팝업이 뜨지 않는다.
force_exclusive_playernullV2,
V3e, V3h
비암호화 컨텐츠의 경우에도 데스크탑 전용 플레이어를 강제 사용하도록 설정. (모바일은 지원하지 않음.)
uservalue0~9mixedAll고객사가 원하는대로 uservalue0부터 9까지 값을 설정하여 사용함.
brightnessintegerV2기본 밝기 값을 설정. 값의 범위는 -50 <= brightness <= 50임. default는 0
contrastintegerV2기본 대비 값을 설정. 값의 범위는 -50 <= contrast <= 50임. default는 0
saturationintegerV2기본 색조 값을 설정. 값의 범위는 -50 <= saturation <= 50임. default는 0
mobile_return_urlstringiOS재생 중 뒤로가기 버튼을 누르거나 재생 종료시에 지정한 url을 safari web browser로 오픈.
mobile_folder_downloadstringMobile모바일 다운로드시 지정할 폴더명을 입력한다.
예> 폴더1/폴더2/폴더3
wmodestringFlash데스크탑의 경우 Flash player의 wmode를 강제로 지정한다. 지정하지 않은 경우는 ‘direct’ 사용.
wmode는 다음의 값 가운데서 하나를 지정할 수 있다.
예> direct, transparent, window, opaque, gpu
pc_player_versionstringDesktop데스크탑에서 Player2.0 ~ 3.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다.

가능한 옵션> v2, v3, v3e \

* v3e를 지정할 경우엔 v3 전용 플레이어가 호출된다.
* 호환성 이슈로 유지. 신규 사용자는 player_version 옵션을 사용하는 것을 권장한다.
player_versionstringDesktop데스크탑에서 Player2.0 ~ 4.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다.가능한 옵션> v2, v3, v3e, html5* v3e를 지정할 경우엔 v3 전용 플레이어가 호출된다.
pc_folder_downloadstringV2, V3e, V3hPC 다운로드시 지정할 폴더명을 입력한다. (모바일과 형식은 동일)
play_downloaded_filenullV3e, V3h다운로드된 파일을 재생한다.
bufferintegerV2, V3e, V3h기본 버퍼링 값을 무시하고 지정한 값만큼 버퍼링을 수행한다. 2 <= buffer <= 10 사이의 정수만 유효하며, 해당 값은 기본 버퍼링 값의 배수로 작용한다.예> 2 -> 기본 버퍼링값의 2배
show_controls_pausedbooleanFlash, V4값이 true이면 일시정지 상태일 경우 inactive 상태가 되었을 때 controlbar와 overlay button을 계속 보여줌. (Default : false)
show_poster_endedbooleanFlash, V4값이 true이면 컨텐츠 재생이 끝난 후 포스터를 보여준다. (Default : false)
overlay_button_positionstringFlash, V4Overlay button의 위치값을 설정한다.
- TR : Top & Right
- TL : Top & Left
- BR : Bottom & Right
- BL : Bottom & Left
해당 옵션이 설정되지 않거나 위 4개의 값 외의 다른 문자열이 오면 가운데 정렬되어 보여진다.
loadcheckintegerV3

0: play callback 에서 메시지 사용 

샘플코드

V/G Query String – java