Videogateway Controller Library가 지원하는 메소드를 호출하는 방법은 간단합니다.

controller.play();

set_repeat_start();

因子で位置(秒)値を入力すると指定した位置をリピート再生の開始位置として設定します。

controller.set_repeat_start(10); // 10秒時点を開始位置に設定

設定されている終了位置より開始位置が後になる場合、終了位置が解除されます。

Parameters:

• position Integer (Optional) 開始位置値

Return:

• No return

set_repeat_end([position])

リピート再生の終了位置を設定します。因子なしで呼び出す場合現在の位置を終了位置として設定します。

controller.set_volumerepeat_end(90);

참고사항

메소드 목록

on(event_name, callback_function)

이벤트 리스너를 등록합니다.

因子で位置(秒)値を入力すると指定した位置をリピート再生の終了位置として設定します。

controller.on('event_name', function(param) {
	// event_name에 해당하는 이벤트 발생시, 두번째 인자인 callback function 실행
});

• event_name String callback function을 bind할 이벤트 이름입니다.
• callback_function Function 이벤트 발생시 실행될 callback function입니다. 경우에 따라서 callback function에는 파라미터가 주어질 수 있습니다.

Return:

• Object VG-Controller Client 객체를 반환합니다.

off(event_name)

등록된 이벤트 리스너를 제거합니다.

controller.off('event_name');

• event_name String callback function으로 bind된 이벤트 이름입니다.

Return:

• Object VG-Controller Client 객체를 반환합니다.

get_progress()

set_repeat_end(20); // 20秒時点を開始位置に設定

設定されている開始位置より終了位置が前になる場合、開始位置が解除されます。

Parameters:

• position Integer (Optional) 終了位置値

Return:

• No return

unset_repeat()

リピート再生設定を解除

Parameters:

• No parameter

Return:

• No return

get_repeat() V2 V3 V4

リピート再生設定状態をリターン: V3, V4 Playerは状態の文字列と時間がリターンします。V2 Playerの場合状態の文字列のみリターンします。状態文字列はcancel, start, endの3種類となります。

Parameters:

• No parameter

Return:

• No return

refresh_bookmark()

Playerのbookmarkリストを更新

Parameters:

• No parameter

  eturn:

• Object percent, position, duration을 property로 갖는 object 객체를 반환합니다. 각 값들에 대한 설명은 progress 이벤트 를 참고하여 주십시요.

play([start_at])

동영상을 재생합니다.

controller.play();

특정 지점부터 재생하려면 다음과 같이 재생할 위치를 파라미터로 입력하여 주십시요.

controller.play(10); // 10초 위치부터 재생

• start_at Integer (Optional) 재생 시작 위치입니다. 생략하면 처음부터 재생합니다.

  eturn:

• No return

pause()

동영상 재생을 일시정지합니다.

Parameters:

No parameter

Return:

• No return

enable_fullscreen_button() V3 V4

Playerの全体画面ボタンを有効にします。(IE バージョン10 以前のバージョンはfullscreen 機能に対応していないためfullscreen buttonは自動で無効になります。)

Parameters:

• No parameter

Return:

• No return

get_player_id() V2 V3

PlayerのユニークIDをリターンします。この関数は「ready」イベントが呼出されるまでにはnullをリターンします。

Parameters:

• No parameter

Return:

• String PlayerのユニークID

get_hardware_id() V2 V3

ハードウェアユニークIDをリターンします。この関数は「ready」イベントが呼出されるまでにはnullをリターンします。

Parameters:

• No parameter

Return:

• String ハードウェアユニークID

get_player_type() 

現在のPlayer Typeをリターン：Flash, V2, V3, V4

Parameters:

• No parameter

Return:

• String 現在のPlayer Type

set_subtitle_visibility(visibility)

字幕表示を設定

Parameters:

• visibility Boolean 表示設定

Return:

• No return

set_subtitle_

음량을 변경합니다. 음량은 0 <= volume <= 100 사이의 Integer형 값이어야 합니다. 이 범위를 벗어난 감은 0이나 100으로 재조정 됩니다.

Parameters:

volume Integer 변경할 음량입니다.

shadow_rect(is_rect)

字幕の背景スタイルを設定：パラメータがtrueならblock形の不透明背景となり、falseなら文字の陰影として設定されます。

Parameters:

• is_rect Boolean 字幕の背景スタイルがBlock形であるかの有無

Return:

• No return

get_subtitle_shadow_

rect()

현재 설정된 음량을 반환합니다.字幕の背景スタイルがBlock形の不透明背景に設定されているかをリターンします。

Parameters:

• No parameter

  eturn:

• Integer 현재 설정된 음량입니다.

mute()

음소거를 설정하거나 해제합니다. 음소거가 해제된 상태에서 호출하면 음소거를 설정하고, 반대로 설정된 상태라면 해제합니다.

Parameters:

• No parameter

  eturnis_rect Boolean 字幕の背景スタイルがBlock形であるかの有無

Return:

• No return

set_subtitle_font_size(size) V3 V4

字幕フォントのサイズを設定します。

Parameters:

• size Integer 字幕フォントのサイズです。単位はpxです。

Return:

• No return

get_subtitle_font_size()

V3 V4

字幕フォントのサイズを設定をリターン

Parameters:

• No parametereturn

Return:

• size Integer 字幕フォントのサイズです。単位はpxです。

get_video_info()

Flash V4

コンテンツのwidth, height, bitrate 値をリターンします。この関数は「ready」イベントが呼出されるまでにはnullをリターンします。

Parameters:

• No parametereturn

Return:

• No returnObject width, height, bitrateがpropertyになるObjectをリターン

set_lms_

check() V2

일반 윈도우 모드와 전체화면 모드로 화면 상태를 변경합니다. 화면이 일반 윈도우 모드인 경우 호출하면 전체화면으로, 전체화면 모드인 경우는 일반 윈도우 모드로 변경됩니다.

Playerが終了またはブラウザを閉じた場合LMSデータが転送されたことを確認してから削除されるように設定します。

Parameters:

• No parameter

eturn

Return:

• No

return

get_screen()

현재 화면 모드를 반환합니다. set_screen이 V2, V3, V4 Player에서만 지원되긴 하지만, get_screen 함수는 모든 Player에서 정상적으로 현재 화면 상태를 반환합니다. 반환되는 값은 다음과 같습니다.

• 일반 윈도우 모드 : windowed
• 전체화면 모드 : fullscreen

Parameters:

• No parameter

  eturn:

• String 반환되는 현재 화면 모드입니다. windowed, fullscreen 두 값 가운데 하나를 갖습니다.

set_jumpstep(jumpstep)

ff 메소드나 rw 메소드를 통해 이동할 시간값을 설정합니다. 시간값은 초단위 정수로 입력합니다.

Parameters:

• jumpstep Integer 이동할 시간값 입니다.

  eturn:

• No return

get_jumpstep()

• parameter

set_keyframe_seek_default(is_default) V2

Seekする際にKeyframe移動をdefaultにするかを設定

Parameters:

• is_default Boolean default 設定有無

Return:

• No parameter

set_short_key(enable) V2

ショートカットキーのOn/Off設定

Parameters:

• enable Boolean ショートカットキー設定

Return:

• No parameter

set_enable_close_event()

close callback 関数の使用有無を設定

Parameters:

• No parameter

Return:

set_control_visibility(visibility)

Player 내장 Control들을 숨김하거나 숨김을 해제합니다. 파라미터로 true를 주면 숨김 해제, false를 주면 숨김입니다.

Parameters:

• visibility Boolean 내장 Control 숨김 여부입니다.

  eturn:

• No return

get_control_visibility()

설정된 내장 Control 숨김 여부를 반환합니다.

Parameters:

• No parameter

  eturn:

• Boolean 내장 Control 숨김 여부입니다.

set_scalemode(scalemode) Flash

Flash Player의 Scalemode를 변경합니다. Flash Player가 아닌 환경에서 호출할 경우 오류를 발생시키진 않지만, Scalemode가 변경되진 않습니다. Scalemode는 다음 4가지 중 하나여야 합니다. (다른 값일 경우는 동작하지 않습니다.)

• letterbox, stretch, zoom, none

Parameters:

• scalemode String 설정할 scalemode의 값입니다.

  eturn:

• No return

get_scalemode() Flash

• No parameter

get_enable_close_event()

close callback 関数の使用設定をリターン

Parameters:

• No parameter

Return:

• Boolean 使用設定をリターン

set_close_callback_fn(fn)

ブラウザを閉じた際に実行する関数を登録します。

Parameters:

• fn Function 閉じた際に実行する関数

Return:

• No parameter

get_lms_data() V4

現在まで保存されたLMS dataをリターンします。

Parameters:

• No parameter

Return:

• Object LMS data

get_hls_frag_data() V4

hlsのfrag dataを呼出す

Parameters:

• No parameter

Return:

set_speed(speed) V2 V3 V4

재생 배속을 설정합니다. 배속의 범위는 기본적으로 0.5 <= speed <= 4 입니다. 배속 최대값은 플레이어의 설정에 따라 바뀔 수 있습니다. 또한, 배속은 0.1씩 증가하거나 감소할 수 있습니다. 그보다 작은 단위로 증감할 경우 기대한대로 배속이 증감하지 않을 수 있으니 주의하여 주십시요. 0.5보다 작거나 4보다 큰 값을 입력할 경우는 각각 0.5와 4로 값이 고정됩니다.

Parameters:

• speed Integer 설정할 배속값 입니다.

  eturn:

• No return

get_speed() V2 V3 V4

설정된 배속값을 반환합니다. Javascript에는 명시적인 Float형이 존재하지 않으므로, 소수점을 표현하기 위해 String형으로 반환합니다.

Parameters:

• No parameter

  eturn:

• String 설정된 배속값입니다. 1이나 2인 경우 각각 문자열 '1.0'과 '2.0'으로 표현합니다.

set_playback_rates(playback_rates) V3 V4

배속값 그룹을 설정합니다. Array type으로 순서는 상관없습니다. (Player 내부에서 Sort하여 UI를 구성합니다.) 이중배열의 형태로 들어가는 경우 UI에서 보여지는 배속값 그룹의 세로 줄 수를 설정 할 수 있습니다. 이 경우 첫번째 인자는 배속값의 배열이며, 두번째 인자는 세로 줄 수를 나타냅니다. ex) [[0.5, 1, 1.5, 2, 3, 4], 2]

Parameters:

• playback_rates Array 설정할 배속값 그룹의 배열입니다.

  eturn:

• No return

get_playback_rates() V3 V4

• base_url String M3U8 ファイルの呼出URL

• url String TS ファイル(media file)の呼出URL

• duration Integer TS ファイルの全体時間

• auto_level Boolean ABR 有無

• level Integer 現在ビットレートレベル値

• media_sequence Integer メディアシーケンスナンバー

• program_date_time Integer Program Date Time

• tag_list Array Tags [key, value]

• encrypted Boolean Encrypt 有無

set_controls_inactive_time (time) V2 V3 V4

コントロールバーが非表示になる時間を設定します。0の場合固定 (V3, V4 のみ)

Parameters:

• time Integer コントロールバーが非表示になる時間

Return:

• No parameter

get_controls_inactive_time () V2 V3 V4

設定されているコントロールバーの非表示時間をリターン

Parameters:

• No parameter

Return:

• Integer コントロールバーの非表示時間

set_controls_activity (activity) V3 V4

コントローラー(ControlBar, BigPlayButton)の有効・無効を設定

Parameters:

• activity Boolean コントローラーの有効・無効設定

Return:

• No parameter

get_controls_activity () V3 V4

コントローラー設定をリターン

Parameters:

• No parameter

Return:

• Boolean コントローラー設定

set_

controlbar_progress_only (enable) V2

V3 V4

コントロールバーのProgressBarのみ表示する設定

Parameters:

No parameter

• enable Boolean ProgressBar Only設定

Return:

• No

• parameter

get_

controlbar_progress_only () V2

V3 V4

ProgressBar Only設定をリターン

Parameters:

topmost Boolean true는 최상위 설정, false는 최상위 설정 해제입니다.

• No parameter

Return:

• Boolean

• ProgressBar Only設定

영상의 밝기를 설정합니다. 이 설정은 V2 Player에서만 동작합니다. 영상의 밝기는 -50 <= brightness <= 50입니다. -50보다 작거나 50보다 큰 값을 입력하면 각각 -50과 50으로 재조정됩니다.

Parameters:

brightness Integer 영상 밝기값 입니다.

set_

controlbar_hide_playing (enable) V4

再生中にコントロールバーとプログレスバーまで非表示にする設定

Parameters:

• enable Boolean 再生中にプログレスバーまで非表示にする設定

Return:

• No return

get_controlbar_hide_

playing ()

V4

再生中にコントロールバーとプログレスバーまで非表示にする設定をリターン

Parameters:

• No parameter

eturn:

set_contrast(contrast) V2

영상의 대비를 설정합니다. 이 설정은 V2 Player에서만 동작합니다. 영상의 대비는 -50 <= contrast <= 50입니다. -50보다 작거나 50보다 큰 값을 입력하면 각각 -50과 50으로 재조정됩니다.

Parameters:

• contrast Integer 영상 대비값 입니다.

  eturn:

• No return

get_contrast() V2

Return:

• Boolean 再生中にプログレスバーまで非表示にする設定

set_subtitle_activity (activity) V2 V3 V4

字幕の位置を変更

Parameters:

• activity Boolean trueの場合コントロールバー領域分だけ上に位置が上がり、falseの場合下がる

Return:

• No return

get_subtitle_activity () V3 V4

字幕の位置をリターン

Parameters:

• No parameter

Return:

• Boolean tコントロールバー領域分だけ上に位置が上がっているかをリターン

get_subtitles_LIST () V2 V3 V4

VGから字幕の順番を変更してPlayer側にリターンする場合があるため、APIを呼出して取得する字幕リストではなく、
VGのMediaInfoオブジェクト内部の字幕属性をリターンします。

Parameters:

• No parameter

Return:

• Array 字幕リストの配列オブジェクト

set_current_

subtitle (

영상의 색조를 설정합니다. 이 설정은 V2 Player에서만 동작합니다. 영상의 색조는 -50 <= saturation <= 50입니다. -50보다 작거나 50보다 큰 값을 입력하면 각각 -50과 50으로 재조정됩니다.

Parameters:

saturation Integer 영상 색조값 입니다.

index) V2 V3 V4

字幕を変更

Parameters:

• index Number get_subtitles_list()メソッドでリターンされた字幕配列のindex値

Return:

• No return

set_

ratio (type) V2

설정된 영상 색조값을 반환합니다. V2 Player가 아닌 경우 이 메소드를 호출하면 무조건 0을 반환합니다.

Parameters:

• No parameter

  eturn:

• Integer 설정된 영상 색조값 입니다.

set_repeat_start([position])

구간반복의 시작 위치를 설정합니다. 인자 없이 호출하면 현재 위치를 구간반복의 시작 위치로 설정합니다.

controller.set_repeat_start();

controller.set_repeat_start(10); // 10초 위치를 시작 위치로 설정

Parameters:

• position Integer (Optional) 시작 위치값 입니다.

  eturn:

• No return

set_repeat_end([position])

구간반복의 종료 위치를 설정합니다. 인자 없이 호출하면 현재 위치를 구간반복의 종료 위치로 설정합니다.

controller.set_repeat_end();

인자로 위치(초)값을 입력하면 지정한 위치를 구간반복의 종료 위치로 설정합니다.

controller.set_repeat_end(20); // 20초 위치를 종료 위치로 설정

Parameters:

• position Integer (Optional) 종료 위치값 입니다.

  eturn:

• No return

unset_repeat()

설정된 구간반복을 해제합니다.

Parameters:

• No parameter

  eturn:

• No return

refresh_bookmark()

플레이어 내 bookmark 리스트를 새로 갱신합니다.

Parameters:

• No parameter

  eturn:

• No return

enable_fullscreen_button() V3 V4

플레이어 내부의 fullscreen button을 활성화시킵니다. (IE 10 이하는 웹브라우져에서 fullscreen 기능을 지원하지 않으므로, 해당 웹브라우져에선 자동적으로 fullscreen button이 비활성화된 상태로 표시됩니다.)

Parameters:

• No parameter

  eturn:

• No return

get_player_id() V2 V3

플레이어 고유 아이디를 반환합니다. 이 함수는 ready 이벤트가 호출되기 전까지는 null을 리턴합니다.

Parameters:

• No parameter

  eturn:

• String 플레이어 고유 아이디입니다.

get_hardware_id() V2 V3

하드웨어 고유 아이디를 반환합니다. 이 함수는 ready 이벤트가 호출되기 전까지는 null을 리턴합니다.

Parameters:

• No parameter

  eturn:

• String 하드웨어 고유 아이디입니다.

set_subtitle_visibility(visibility)

자막 출력을 설정합니다.

Parameters:

• visibility Boolean 출력 여부입니다.

  eturn:

• No return

get_video_info() Flash V4

미디어의 width, height, bitrate값을 반환합니다. 이 함수는 ready 이벤트가 호출되기 전까지는 null을 리턴합니다.

Parameters:

• No parameter

  eturn:

• Object width, height, bitrate를 property로 갖는 Object를 반환합니다.

이벤트 목록

loaded

플레이어 로딩이 완료되면 이벤트가 발생합니다.

ready

플레이어 로딩이 끝나고 재생 정보를 서버로부터 획득하였으며, 실제 재생준비가 완료된 시점입니다.

play

재생 시작시에 발생합니다. 초기 재생 시작을 제외하고 일시 멈춤 상태에서 다시 재생을 시작할때도 발생합니다.

progress

V3 V4

画面拡大モードを変更

Parameters:

• type String contain, fill, enlargementの中一つを適用することが可能

  • contain: 比率に合わせて埋める
  • fill: 画面全体に埋める
  • enlargement: 縦幅に合わせて埋める（左右にスクロール可能）

Return:

• No return

get_error_detail () V2 V3 V4

Errorが発生した場合、code, message, param値をオブジェクトでリターンする。param値はmessage以外にも追加で情報を転送する必要がある場合含まれます。

Parameters:

• No parameter

Return:

• Object Errorの詳細値をリターン {code, message, param}

set_vr_overlay (options) V3 V4

iOSデバイスはDeviceMotion権限を取得するためNative CodeであるDeviceMotionEvent.requestPermissionメソッドを呼び出す必要があります。
User Action (Touch)を必要とするため、iframeオブジェクト上にTouch Eventを受け取るための任意のオブジェクトが必要になります。
VG-Controller Client初期化してから該当メソッドを呼出すとVG-Controller Client 内部から自動でTouch Eventオブジェクトを生成し、権限を受け取る準備をします。

※iOS 13.4バージョンでは権限を取得してもDeviceMotionのrotationRate値が正常に適用されないエラーが判明されています。

  var controller = new VgControllerClient({
       target_window: player.contentWindow
  });
  controller.set_vr_overlay({
      target_element: document.getElementById('player').parentElement,
      permission_request_help_message: 'Custom Info Message'
  });

Parameters:

• options object

  • target_element (必須)
    
    • 任意のTouch Eventオブジェクトを生成するDom Elementです。ifrmaeオブジェクトの親Elementを指定してください。
    • 重要：iframeオブジェクトの親Elementはposition値がrelativeまたはabsoluteでなければなりません。
  • permission_request_help_message
    
    • 既にDeviceMotion Permissionを実行している場合にはブラウザデータ保存所に該当値が保存されます。Permissionをキャンセルした場合、キャンセル状態で保存されるため、requestPermissionを実行することができません。実行できない状況に対した説明文を設定してください。説明文を設定していない場合、以下のデフォルト内容が表示されます。
      
      • "動作と方向"へのアクセス権限がないためジャイロスコープが動作しません。設定 > Safari > 詳細 > Webサイトデータからデータを削除して再度お試しください。

Return:

• No return

set_custom_error (code, message, param) V3 V4

Playerのエラーメッセージを変更します。
メソッドの実行時点がエラーが起きている状態であれば、画面に表示されているエラーメッセージとparam値を入れ替えた内容で表示します。
メソッドの実行時点がエラーが起きていない状態であれば、該当エラーが発生した場合に入れ替えたエラーメッセージとparam値を表示することにします。
※Error code 値が変更の基準になるため、Error codeを正確に入力してください。

Parameters:

• code Integer エラーコード

• message String ユーザーエラーメッセージ

• param String ユーザー Param メッセージ

Return:

• No return

set_close_button (enable, fn) V4

Playerの右上に閉じるボタンを追加します。(Mobile player only)閉じるボタンがクリックされた際にCallback関数を実行します。※ready event 以降に呼出してください。

Parameters:

• enable Boolean 閉じるボタン配置有無

• fn Function 閉じるボタンクリックされた際に実行する関数

Return:

• No return

hide_controlbar_button (value) V4

コントロールバーから特定ボタン (fullscreen, setting)を除去します。fullscreenボタンを除去する場合、hide_control_bar(['fullscreen'])を呼出してください。※ready event 以降に呼出してください。

Parameters:

• value Array 除去するボタン (fullscreen, setting) 配列

Return:

• No return

set_chat_config (value) V4

チャットウィンドウに必要な情報を表示するcustomer_pageをTab page形で表示するように設定します。urlを入力してhtmlページにリンクしたり、html tagをそのまま入力することも可能です。※ready event 以降に呼出してください。

• ブラウザのセキュリティポリシーのため、urlは https のみ対応します。
• htmlを入力する場合、<script>tagは動作しません。

const config = {
	customer_page: [{
		title:'関連情報',
		url:'https://google.com',
		//html:'<h2 style="color:red">正しいHTMLの書き方</h2>'
	}]
};
controller.set_chat_config(config);

Parameters:

• value Object チャット設定 (Json object) 

Return:

• No return

hide_controlbar_button (value) V4

Android webview環境にて、チャットのキーボードが立ち上がる際にwebviewの位置がキーボードに合わせて動かないため正常に見えなくなるのでこの問題を修正するためにこのメソッドを呼出する必要があります。
height値は全体が見える状態（キーボードがない状態）を1.0とします。例えばキーボードが立ち上がって画面の40％が被られたと想定した場合には height = 0.6 を呼出して対応します。

Parameters:

• value Integer 画面対比キーボードの縦幅パーセンテージ

Return:

• No return

dispose () V3 V4

Playerオブジェクトを削除

Parameters:

• No parameter

Return:

• No return

イベントリスト

loaded

Playerの読込が完了するとイベントが発生します。

ready

Playerの読込が終わってから再生情報をサーバーから獲得して再生準備が完了された時点

play

再生開始の時に発生：一時停止状態から再度再生した際にも発生します。

progress

再生中に毎秒発生

controller.on('progress', function(percent, position, duration) {
	// 인자의 순서는 위와과 같습니다.
});

Parameters:

• percent Integer 진행 백분율입니다. 값의 범위는 0 <= percent <= 100 입니다.
• position Integer 현재 재생중인 위치의 값입니다. 초단위입니다.
• duration Integer 동영상의 전체 재생 길이입니다. 초단위입니다.

pause

일시 정지시에 발생합니다.

done

재생 완료시에 발생합니다. 재생 완료는 duration의 끝까지 모두 재생한 경우를 의미합니다.

muted Flash V3 V4

因子の順番は上記の通りになります。
});

V3, V4 Playerの場合、HTML5 Video Playerの構造上の都合のためprogressイベントが正確に1秒毎に発生しない可能性があります。 (0.1秒から最大0.5秒まで差が発生する可能性があります。)V3, V4 Playerにprogressイベントで作業する場合上記の内容に注意してください。

Parameters:

• percent Integer 進行率のパーセントとなります。範囲は 0 <=percent <=100となります。
• position Integer 現在再生中の位置値となります。単位：秒
• duration Integer コンテンツの長さとなります。 単位：秒

pause

一時停止した場合に発生

done

再生を完了した場合に発生：再生完了はdurationの最後の時点に到達した際に判別

muted Flash V3 V4

ミュート状態が変更された際に発生 (ミュートOn/Off 何れも発生)

controller.on('muted', function(is_muted) {
	// is_mutedがtrueはミュートOn, falseはミュートOff
});

V2 Playerの場合には現状mutedイベントは対応していません。ミュート状態になる場合volumechangeイベントが発生し、変更された音量を0で転送します。

Parameters:

• is_muted Boolean trueはミュートOn, falseはミュートOff

close V2

Playerが終了またはブラウザを閉じると発生

seeking V4

シークが始まると発生

seeked V4

シークが終わると発生

scalemodechange Flash

スケールモードが変更された際に発生します。

controller.on('mutedscalemodechange', function(is_mutedscalemode) {
	// is_muted가 true면 음소거, false면 해제입니다...
});

Parameters:

• is_muted Boolean true면 음소거, false면 음소거 해제입니다.

scalemodechange Flash

스케일모드가 변경시 발생합니다.Flash Playerのみ対応：パラメータは以下の中で決まります。

• letterbox, stretch, zoom, none

Parameters:

• scalemode String letterbox, stretch, zoom, none の中で一つ

topmostchange V2

ウィンドウの最上位配置設定が変更した際に発生

controller.on('scalemodechangetopmostchange', function(scalemodeis_topmost) {
	// ... is_topmostがtrueは最上位設定On, falseは最上位設定Off
});

V2 Player以外のPlayerではイベントが発生しません。

Parameters:

• scalemode String letterbox, stretch, zoom, none 가운데 하나입니다.

topmostchange V2

• is_topmost Boolean trueは最上位設定On, falseは最上位設定Off

screenchange

全体画面のOn/Offの際に発生

• IE10 以前のバージョンでenable_fullscreen_button()が有効化されている場合、fullscreen ボタンをクリックしても実際の動作はしませんがscreenchangeイベントはリターンされます。

  Code Block
  theme Midnight
  controller.on('

• screenchange', function(

• screen) { //

• ... });

  
  

화면 최상위 설정은 V2 Player에만 존재하는 기능입니다. 다른 Player에서는 이벤트를 발생시키지 않습니다.screen パラメータは2つの文字列を転送します。screen: windowed, fullscreen

Parameters:

• is_topmost Boolean true면 최상위 설정, false면 최상위 설정 해제입니다.

screenchange

전체, 일반화면 변경시 발생합니다.

• IE10 이하의 브라우져의 경우, enable_fullscreen_button()이 활성화 되어 있는 상태라면, fullscreen 버튼 클릭시 실제 fullscreen/windowed 전환이 이루어 지지는 않지만 screenchange 이벤트는 정상적으로 반환이 됩니다.screen String windowedは全体画面Off, fullscreenは全体画面On

volumechange

音量変更の際に発生

controller.on('

volumechange', function(

volume) {
	// 

volumeの範囲は 0 <= volume <= 100
});

screen 파라미터는 다음의 2가지 문자열 가운데 하나를 제공합니다. screen: windowed, fullscreen

Parameters:

• screen String windowed는 일반화면, fullscreen은 전체화면입니다.

volumechange

음량 변경시 발생합니다.Parameters:

• volume Integer 変更された音量：範囲は 0 <= volume <= 100

speedchange V2 V3 V4

倍速変更の際に発生：倍速最大値はPlayerの設定により変更

controller.on('volumechangespeedchange', function(volumespeed) {
	// volume의 범위는speed範囲は 0.5 <= volumespeed <= 1004
입니다.
});

Parameters:

• volume Integer 변경된 음량입니다. 범위는 0 speed String 変更された倍速：範囲は 0.5 <= volume speed <= 100 입니다4となります。Javascriptの特性で2.0は2に表記されるため、Integerタイプの代わりにStringタイプで転送

playbackrateschange V3 V4

倍速値グループが変更されると発生

controller.on('speedchangeplaybackrateschange', function(speedplayback_rates) {
	// speed의 범위는 0.5 <= speed
<= 4 입니다.	// playback_ratesは配列の文字列となり、単一または二重配列でリターン 
});

Parameters:

• speed String 변경된 배속입니다. 범위는 0.5 <= speed <= 4 입니다. Javascript 언어 특성상 2.0은 2로 표기 되기 때문에, Integer형 대신에 String형을 사용해 제공합니다.

videosettingchange V2

• playback_rates String 変更された倍速値グループの文字列

• 単一配列 : 倍速値リストが1列で表示 ex) [1, 2, 3]

• 二重配列 : 倍速値リストが複数列で表示 ex) [[0.5, 1, 1.5, 2], 2]

videosettingchange V2

映像設定変更の際に発生

controller.on('videosettingchange', function(videosetting) {
    // videosetting 파라미터는 다음의パラメータは次のObjectタイプ
형태로 표시되는 Object 타입입니다.
    //
    // {
        // "brightness": 0,
        // "contrast": 0,
        // "saturation": 0
    // }
});

비디오 속성 변경 기능은 V2 Player에만 존재하는 기능입니다. 다른 Player에서는 이벤트를 발생시키지 않습니다. 각 값의 범위는 모두 映像設定変更はV2 Playerのみ対応しています。他のPlayerではイベントが発生しません。範囲は全て -50 <= value <= 50의 범위를 갖습니다. 사용자가 별도로 지정하지 않았을 경우 기본값은 0 입니다.50となります。別途指定がなかった場合defaultは0となります。

Parameters:

• videosetting videosetting Object brightness(밝기明るさ), contrast(대비コントラスト), saturation(채도)를 property로 갖는 object입니다.色調)がpropertyになるobject

jumpstepchange

ff, rw 메소드를 통해 이동할 시간값 변경시 발생합니다.メソッドから移動時間値が変更された際に発生

controller.on('jumpstepchange', function(jumpstep) {
	// jumpstep은jumpstep 초단위입니다.単位：秒
});

Parameters:

• jumpstep Integer 변경된 이동할 시간값입니다. 초단위입니다.jumpstep Integer 変更された移動時間値 (単位：秒)

subtitlevisibilitychange V2 V3 V4

字幕表示状態が変更されると発生

hlsfragchange V4

hlsのfragが変更されると発生

html5_video_supported V3 V4

V3, V4 Player에서만 발생합니다. Player가 내부에서 HTML5 Video 재생기능을 사용할 수 있다고 판단하여 HTML5 Video Player를 로드할 경우 엔 true를, 전용 플레이어를 재생해야 한다고 판단할 경우엔 false를 리턴합니다. Playerのみ発生します。PlayerがHTML5 Video 再生機能が使用できる環境だと判断してV4(HTML5 Video Player)を読み込んだ場合にはtrue, V3を読み込む場合にはfalseをリターンします。 (http://caniuse.com/#feat=video 참조 参考)

Parameters:

• html5_video_supported Boolean Player가 HTML5 Player로 로드될 경우 true, 전용 플레이어로 로드될 경우는 false가 리턴됩니다.

error

• PlayerがV4(HTML5 Player)で読み込む場合true, V3を読み込む場合falseがリターン

error

Playerが再生エラーをリターンした際に発生

controller.on('error', function(error_code) {
	// ...
});

Parameters:

• error_code Integer Kollus Player 에러 코드입니다.code Integer Kollus Playerのエラーコード

device_orientation_changed v4

mobile deviceの縦/横が回転された際に発生

Parameters:

• orientation String 縦: Portrait 横: Landscape