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

지원플레이어

설명

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

지정된 제목 외에 강제로 제목 지정. 

t

integer

All

지정한 위치부터 재생함. nscreen 정보가 있더라도 이를 무시하고 주어진 시간부터 재생함. (이 경우 이어보기 팝업이 뜬다.)
예> ?t=10 (10초부터 재생)

(참고)다음과 같은 시간 설정에서는 해당 파라미터가 적용되지 않습니다

  • 영상 시작부터 10초 미만인 경우 ‘처음부터 재생’ 처리한다.

  • 영상 종료까지 10초 미만 일때 ‘처음부터 재생’ 처리한다.

s

integer

All

지정한 위치부터 재생하는 것은 t 옵션과 동일하지만, s 옵션은 이어보기 팝업이 뜨지 않는다.

(참고)다음과 같은 시간 설정에서는 해당 파라미터가 적용되지 않습니다

  • 영상 시작부터 10초 미만인 경우 ‘처음부터 재생’ 처리한다.

  • 영상 종료까지 10초 미만 일때 ‘처음부터 재생’ 처리한다.

force_exclusive_player

null

V2,
V3e, V3h

비암호화 컨텐츠의 경우에도 데스크탑 전용 플레이어를 강제 사용하도록 설정. (모바일은 지원하지 않음.)

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

모바일 다운로드시 지정할 폴더명을 입력한다.
예> 폴더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 (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의 위치값을 설정한다.
- TR : Top & Right
- TL : Top & Left
- BR : Bottom & Right
- BL : Bottom & Left
해당 옵션이 설정되지 않거나 위 4개의 값 외의 다른 문자열이 오면 가운데 정렬되어 보여진다.

loadcheck

integer

V3

0: play callback 에서 메시지 사용 

enable_initialize_focus

boolean

V3, V4

기본 값은 true이며 false로 설정 시 플레이어 로딩 시 포커스가 적용되지 않음

ios_player_type

string

iOS

iOS 의 디코더 타입을 설정한다.

  • native : 네이티브 디코더로 설정한다.

  • hw : 하드웨어 디코더로 설정한다.

  • sw : 소프트웨어 디코더로 설정한다.

* 이 설정은 iOS Kollus Player 2.2.14 이상부터 동작합니다.

샘플코드

V/G Query String – java

Copyright © CATENOID, lnc. All Rights Reserved.
E-mail. support@catenoid.net | Tel. 1544-4367