사용방법
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
파라미터
| key | DataType | 지원플레이어 | 설명 |
|---|---|---|---|
| pf | string | All | 프로파일 자동 설정을 무시하고 지정된 프로파일 키에 해당하는 트랜스코딩 파일을 서빙. 존재하지 않으면 자동 설정. 예> ?pf=mixnut-pc-high1 (mixnut-pc-high1에 해당하는 트랜스코딩 파일을 서빙) |
| autoplay (a) | null | All | 로딩 후 동영상 자동 시작. 단, 모바일 전용 플레이어는 기본이 자동시작이다. (옵션에 영향을 받지 않음) |
| mute | null | All | 로딩 후 음소거된 상태에서 동영상 재생. 모바일 HTML5 플레이어는 시작시 음소거가 가능하지 않음. |
| download | null | Mobile, V3e, V3h | 컨텐츠 다운로드 기능. download 옵션을 추가하면 비디오 게이트웨이가 다운로드 모드로 동작한다. 만약 채널에서 모바일이나 PC 다운로드 옵션을 사용하지 않음으로 설정하면, 실제 다운로드를 시도하더라도 플레이어가 다운로드하지 않음. |
| title | string | All | 지정된 제목 외에 강제로 제목 지정. 모바일 HTML5 플레이어의 경우 원래 제목이 지원되지 않음. |
| t | integer | All | 지정한 위치부터 재생함. nscreen 정보가 있더라도 이를 무시하고 주어진 시간부터 재생함. (이 경우 이어보기 팝업이 뜬다.) 예> ?t=10 (10초부터 재생) |
| s | integer | All | 지정한 위치부터 재생하는 것은 t 옵션과 동일하지만, s 옵션은 이어보기 팝업이 뜨지 않는다. |
| force_exclusive_player | null | V2, V3e, V3h | 비암호화 컨텐츠의 경우에도 데스크탑 전용 플레이어를 강제 사용하도록 설정. (모바일은 지원하지 않음.) |
| uservalue0~9 | mixed | All | 고객사가 원하는대로 uservalue0부터 9까지 값을 설정하여 사용함. |
| brightness | integer | V2 | 기본 밝기 값을 설정. 값의 범위는 -50 <= brightness <= 50임. default는 0 |
| contrast | integer | V2 | 기본 대비 값을 설정. 값의 범위는 -50 <= contrast <= 50임. default는 0 |
| saturation | integer | V2 | 기본 색조 값을 설정. 값의 범위는 -50 <= saturation <= 50임. default는 0 |
| mobile_return_url | string | iOS | 재생 중 뒤로가기 버튼을 누르거나 재생 종료시에 지정한 url을 safari web browser로 오픈. |
| mobile_folder_download | string | Mobile | 모바일 다운로드시 지정할 폴더명을 입력한다. 예> 폴더1/폴더2/폴더3 |
| wmode | string | Flash | 데스크탑의 경우 Flash player의 wmode를 강제로 지정한다. 지정하지 않은 경우는 ‘direct’ 사용. wmode는 다음의 값 가운데서 하나를 지정할 수 있다. 예> direct, transparent, window, opaque, gpu |
| pc_player_version | string | Desktop | 데스크탑에서 Player2.0 ~ 3.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다. 가능한 옵션> v2, v3, v3e \ * v3e를 지정할 경우엔 v3 전용 플레이어가 호출된다. * 호환성 이슈로 유지. 신규 사용자는 player_version 옵션을 사용하는 것을 권장한다. |
| player_version | string | Desktop | 데스크탑에서 Player2.0 ~ 4.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다.가능한 옵션> v2, v3, v3e, html5* v3e를 지정할 경우엔 v3 전용 플레이어가 호출된다. |
| pc_folder_download | string | V2, V3e, V3h | PC 다운로드시 지정할 폴더명을 입력한다. (모바일과 형식은 동일) |
| play_downloaded_file | null | V3e, V3h | 다운로드된 파일을 재생한다. |
| buffer | integer | V2, V3e, V3h | 기본 버퍼링 값을 무시하고 지정한 값만큼 버퍼링을 수행한다. 2 <= buffer <= 10 사이의 정수만 유효하며, 해당 값은 기본 버퍼링 값의 배수로 작용한다.예> 2 -> 기본 버퍼링값의 2배 |
| show_controls_paused | boolean | Flash, V4 | 값이 true이면 일시정지 상태일 경우 inactive 상태가 되었을 때 controlbar와 overlay button을 계속 보여줌. (Default : false) |
| show_poster_ended | boolean | Flash, V4 | 값이 true이면 컨텐츠 재생이 끝난 후 포스터를 보여준다. (Default : false) |
| overlay_button_position | string | Flash, V4 | Overlay button의 위치값을 설정한다. - TR : Top & Right - TL : Top & Left - BR : Bottom & Right - BL : Bottom & Left 해당 옵션이 설정되지 않거나 위 4개의 값 외의 다른 문자열이 오면 가운데 정렬되어 보여진다. |
| loadcheck | integer | V3 | 0: play callback 에서 메시지 사용 |