사용방법
샘플코드
使用方法
| Code Block | ||||
|---|---|---|---|---|
| ||||
http://v.krjp.kollus.com/[MEDIA_CONTENT_KEY]?key=value&... |
query string은 url 뒤에 ?를 붙이고 key와 value를 =로 엮는다. data type이 null인 경우는 key만 붙인다. key, value 쌍을 하나 이상 엮을 경우엔 &로 구분한다.
플레이어구분
플레이어는 다음과 같은 명칭으로 통일한다.
모바일stringの場合、urlの最後に?を付けてkeyとvalueを=で結びます。data typeがnullの場合、keyのみ付けます。keyとvalueの組を複数結ぶ場合には&で区別します。
Player仕分
Playerは以下の名称で統一します。
- モバイル : Mobile
- iOS 전용 플레이어 player app : iOS
- Android 전용 플레이어 player app : Android
- 데스크탑 PC : Desktop
- Flash 플레이어 Player : Flash
- V2 플레이어 Player (ActiveX, NPAPI 플레이어Player) : V2
- V3 전용 플레이어 (설치형, Agent 방식의 플레이어Security Player (インストール型・AgentタイプのPlayer) : V3e
- V3 플레이어 Player (HTML5 Agent 방식의 플레이어AgentタイプのPlayer) : V3h
- V4 플레이어 Player (HTML5 플레이어Player, 비암호화ブラウザ対応標準Player) : V4
パラメータ
| key | DataType | 지원플레이어対応Player | 설명説明 |
|---|---|---|---|
| pf | string | All | 프로파일 자동 설정을 무시하고 지정된 프로파일 키에 해당하는 트랜스코딩 파일을 서빙. 존재하지 않으면 자동 설정. 예> プロファイルの自動設定に関係なく指定されたプロファイルキーに該当するトランスコーディングファイルをServing。存在しない場合には自動設定。 high1に該当するトランスコーディングファイルをServing) |
| autoplay (a) | null | All | 로딩 후 동영상 자동 시작. 단, 모바일 전용 플레이어는 기본이 자동시작이다. (옵션에 영향을 받지 않음自動で再生を開始。但し、モバイルPlayerアプリはデフォルト値が自動開始となります。 (オプションに影響されない) |
| mute | null | All | 로딩 후 음소거된 상태에서 동영상 재생. 모바일 HTML5 플레이어는 시작시 음소거가 가능하지 않음.ミュート状態で再生を開始。Mobile HTML5 Playerは対応不可。 |
| download | null | Mobile, V3e, V3h컨텐츠 다운로드 기능. download 옵션을 추가하면 비디오 게이트웨이가 다운로드 모드로 동작한다. 만약 채널에서 모바일이나 PC 다운로드 옵션을 사용하지 않음으로 설정하면, 실제 다운로드를 시도하더라도 플레이어가 다운로드하지 않음. | コンテンツダウンロード機能。download optionを追加するとVideo gatewayがダウンロードモードで動作します。チャンネルからモバイル又はPC ダウンロードオプションを使用しない設定にした場合、 ダウンロードを試してもPlayer側でダウンロードをさせない。 |
| title | string | All | 지정된 제목 외에 강제로 제목 지정. 모바일 HTML5 플레이어의 경우 원래 제목이 지원되지 않음.元タイトルを表示する代わりに強制指定したタイトルに変更する。Mobile HTML5 Playerは対応不可 |
| t | integer | All | 지정한 위치부터 재생함. nscreen 정보가 있더라도 이를 무시하고 주어진 시간부터 재생함. (이 경우 이어보기 팝업이 뜬다.) 예> 指定された時点から再生。Nscreenデータに関係なくここで指定された時点から再生されます。(続き再生のポップアップが表示されます。) 10秒から再生) |
| s | integer | All지정한 | 위치부터 재생하는 것은 t 옵션과 동일하지만, s 옵션은 이어보기 팝업이 뜨지 않는다.指定した時点から再生。tオプションと異なってs オプションは続き再生ポップアップが表示されません。 |
| force_exclusive_player | null | V2, V3e, V3h | 비암호화 컨텐츠의 경우에도 데스크탑 전용 플레이어를 강제 사용하도록 설정. (모바일은 지원하지 않음.非暗号化コンテンツをPC専用Playerで再生されるように強制指定。(モバイルは対応不可) |
| uservalue0~9 | mixed | All | 고객사가 원하는대로 uservalue0부터 9까지 값을 설정하여 사용함.uservalue0~9までの値を設定 |
| brightness | integer | V2 | 기본 밝기 값을 설정. 값의 범위는 明るさレベルを設定。設定範囲は -50 <= brightness <= 50임. default는 050 となります。 Defaultは0 |
| contrast | integer | V2 | 기본 대비 값을 설정. 값의 범위는 コントラストレベルを設定。設定範囲は -50 <= contrast <= 50임. default는 050となります。Defaultは0 |
| saturation | integer | V2 | 기본 색조 값을 설정. 값의 범위는 カーラートーンを設定。設定範囲は -50 <= saturation <= 50임. default는 050となります。Defaultは0 |
| mobile_return_url | string | iOS재생 | 중 뒤로가기 버튼을 누르거나 재생 종료시에 지정한 url을 safari web browser로 오픈.再生中バックキーを押すかまたは再生終了した場合に指定したURLをsafari web browserで開く |
| mobile_folder_download | string | Mobile | 모바일 다운로드시 지정할 폴더명을 입력한다. 예> 폴더1/폴더2/폴더3 モバイルダウンロードのフォルダを指定 |
| wmode | string | Flash데스크탑의 | 경우 Flash player의 wmode를 강제로 지정한다. 지정하지 않은 경우는 ‘direct’ 사용. wmode는 다음의 값 가운데서 하나를 지정할 수 있다. 예> PCの場合Flash playerのwmodeを強制指定する。指定してない場合には‘direct’になる。wmodeは以下の中で一つを指定します。 |
| pc_player_version | string | Desktop | 데스크탑에서 Player2.0 ~ 3.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다. 가능한 옵션> PCでPlayer2.0又は3.0の中で使用するバージョンを指定。指定してない場合2.0が再生不可能な環境(3.0では再生できる前提として) の場合には自動で3.0が立ち上がる。以下の中で一つを指定します。 選択可能オプション> v2, v3, v3e \ * v3e를 지정할 경우엔 v3 전용 플레이어가 호출된다. * 호환성 이슈로 유지. 신규 사용자는 player_version 옵션을 사용하는 것을 권장한다.v3eに指定した場合にはv3 専用Playerが呼出されます。 * 互換性の問題で維持中。新規使用の場合、下のplayer_versionオプションを使用するように推奨 |
| player_version | string | Desktop | 데스크탑에서 PCで Player2.0 ~ 4.0 버전을 사용하도록 선택한다. 지정하지 않을 경우는 환경에 맞는 플레이어가 자동으로 실행된다.다음의 값 가운데서 하나만 지정할 수 있다.가능한 옵션> 0の中で使用するバージョンを指定。指定しない場合、視聴環境に適合するPlayerが自動で起動します。以下の中で一つを指定します。 選択可能オプション> v2, v3, v3e, html5* v3e를 지정할 경우엔 v3 전용 플레이어가 호출된다.v3eに指定した場合にはv3 専用Playerが呼出されます。 |
| pc_folder_download | string | V2, V3e, V3hPC 다운로드시 지정할 폴더명을 입력한다. (모바일과 형식은 동일) | PCダウンロードのフォルダ名を指定 例> フォルダ1/フォルダ2/フォルダ3 |
| play_downloaded_file | null | V3e, V3h | 다운로드된 파일을 재생한다.ダウンロードされたファイルを再生する。 |
| buffer | integer | V2, V3e, V3h | 기본 버퍼링 값을 무시하고 지정한 값만큼 버퍼링을 수행한다. 2 バッファリング時間を指定。2 <= buffer <= 10 사이의 정수만 유효하며, 해당 값은 기본 버퍼링 값의 배수로 작용한다.예> 2 -> 기본 버퍼링값의 2배の中で定数のみ指定可能。基本値の倍数として適用されます。 例> 2 → 基本値の2倍 |
| show_controls_paused | boolean | Flash, V4 | 값이 true이면 일시정지 상태일 경우 inactive 상태가 되었을 때 controlbar와 overlay button을 계속 보여줌. Trueの場合、一時停止状態からinactive 状態に変わったときcontrolbarとoverlay buttonをそのまま表示する。(Default : false) |
| show_poster_ended | boolean | Flash, V4 | 값이 true이면 컨텐츠 재생이 끝난 후 포스터를 보여준다. Trueの場合、再生が終了した後ポスターイメージを表示する。(Default : false) |
| overlay_button_position | string | Flash, V4 | Overlay button의 위치값을 설정한다.buttonの場所を設定する。 - TR : Top & Right - TL : Top & Left - BR : Bottom & Right - BL : Bottom & Left 해당 옵션이 설정되지 않거나 위 4개의 값 외의 다른 문자열이 오면 가운데 정렬되어 보여진다.設定されてない場合、又は上記以外の値を入れた場合には真ん中に整列されて表示されます。 |
| loadcheck | integer | V3 | 0: play callback 에서 메시지 사용 でメッセージを使用する。 |