V/G Query String
사용방법
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 | 프로파일 자동 설정을 무시하고 지정된 프로파일 키에 해당하는 트랜스코딩 파일을 서빙. 존재하지 않으면 자동 설정. |
autoplay (a) | null | All | 로딩 후 동영상 자동 시작. 단, 모바일 전용 플레이어는 기본이 자동시작이다. (옵션에 영향을 받지 않음) |
mute | null | All | 로딩 후 음소거된 상태에서 동영상 재생. 모바일 HTML5 플레이어는 시작시 음소거가 가능하지 않음. |
download | null | Mobile, | 컨텐츠 다운로드 기능. download 옵션을 추가하면 비디오 게이트웨이가 다운로드 모드로 동작한다. 만약 채널에서 모바일이나 PC 다운로드 옵션을 사용하지 않음으로 설정하면, 실제 다운로드를 시도하더라도 플레이어가 다운로드하지 않음. |
title | string | All | 지정된 제목 외에 강제로 제목 지정. |
t | integer | All | 지정한 위치부터 재생함. nscreen 정보가 있더라도 이를 무시하고 주어진 시간부터 재생함. (이 경우 이어보기 팝업이 뜬다.) (참고)다음과 같은 시간 설정에서는 해당 파라미터가 적용되지 않습니다
|
s | integer | All | 지정한 위치부터 재생하는 것은 t 옵션과 동일하지만, s 옵션은 이어보기 팝업이 뜨지 않는다. (참고)다음과 같은 시간 설정에서는 해당 파라미터가 적용되지 않습니다
|
force_exclusive_player | null | V2, | 비암호화 컨텐츠의 경우에도 데스크탑 전용 플레이어를 강제 사용하도록 설정. (모바일은 지원하지 않음.) |
uservalue0~99 | mixed | All | 고객사가 원하는대로 uservalue0부터 99까지 값을 설정하여 사용함. |
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 | 모바일 다운로드시 지정할 폴더명을 입력한다. |
wmode | string | Flash | 데스크탑의 경우 Flash player의 wmode를 강제로 지정한다. 지정하지 않은 경우는 ‘direct’ 사용. |
pc_player_version | string | Desktop | 데스크탑에서 Player2.0 ~ 3.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다. |
player_version (pv) | string | Desktop | 데스크탑에서 Player2.0 ~ 4.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다.가능한 옵션> v2, v3, ,v4a, 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의 위치값을 설정한다. |
loadcheck | integer | V3 | 0: play callback 에서 메시지 사용 |
enable_initialize_focus | boolean | V3, V4 | 기본 값은 true이며 false로 설정 시 플레이어 로딩 시 포커스가 적용되지 않음 |
ios_player_type | string | iOS | iOS 의 디코더 타입을 설정한다.
* 이 설정은 iOS Kollus Player 2.2.14 이상부터 동작합니다. |
샘플코드
Copyright © CATENOID, lnc. All Rights Reserved.
E-mail. support@catenoid.net | Tel. 1544-4367