NACLIPS LOADER CLASS INTERFACE METHODS. |
cx_ncsloader(player_mode,mobile_mode)
|
Naclips Loader Constructor
|
player_mode |
str |
PC 환경에서 Player Mode / 'auto', 'html5', 'activex', 'plugin' / 'auto': HTML5가 지원하면 HTML5 Player를, 그렇지 않으면 Activex/Plugin Player를 실행. |
mobile_mode |
str |
모바일 환경에서 Player Mode / 'auto', 'html5', 'app' / 'auto': Android 환경일 경우 Naclips Player for Android를, 그렇지 않으면 HTML5 Player를 실행. |
|
activeSubtitleTrack(i_dx) |
나클립스 HTML5 Player에 추가된 자막목록에서 i_dx 번째 자막을 활성화 한다. |
i_dx |
number |
추가된 자막의 순서값 (0부터 시작됨). |
|
addMediaSrc(s_url, s_param) |
스트리밍할 미디어 파일을 미디어 리스트 추가한다. |
s_url |
str |
스트리밍 미디어 URL (ex: assp://127.1.1.3/media/samp.mp4) |
s_param |
str |
s_param 문자열은 서버의 Media Access 로그 파일에 기록된다. |
|
addMultiBpsMenu(s_title) |
다중 대역폭 스트리밍 메뉴명을 지정한다. |
s_title |
str |
메뉴명 |
Return |
number |
메뉴 리스트의 전체 메뉴 갯수. |
|
addParam(name,value) |
나클립스 플레이어의 프로퍼티(Property)를 지정된 값으로 초기화한다. |
name |
str |
초기화 할 프로퍼티(Property)의 이름 |
value |
variable |
지정된 프로퍼티(Property)의 초기값. |
|
addSubtitle(s_file, s_label, s_language, s_charset) |
나클립스 VOD 서버에 저장된 자막파일 URL을 HTML5 플레이어에 추가 한다. |
s_file |
str |
자막파일 URL(ex: /subtitle/demo.srt) |
s_label |
str |
나클립스 HTML5 플레이어에 표시될 자막 제목. (기본값:Korean) |
s_language |
str |
자막파일의 언어 종류. (기본값:ko) |
s_charset |
str |
자막파일의 Charcter Set. (기본값:UTF-8). |
|
burnPlayer (id_layer,i_w,i_h,id_player,docu) |
사용자의 OS, 웹브라우져 환경을 검사하고 나클립스 플레이어를 준비한다. |
id_layer |
str |
나클립스 플레이어가 로딩될 Layer ID. (Div Tag의 ID를 입력) |
i_w |
number |
나클립스 플레이어의 가로 픽셀값. |
i_h |
number |
나클립스 플레이어의 높이(세로 픽셀값). |
id_player |
str |
생성될 나클립스 플레이어의 Object ID 명 |
docu |
object |
나클립스 플레이어가 생성될 documet object. (ex: document, parent.document, top.document. / 생략시 기본값 : document) |
Return |
number |
1: 성공 / false: Unsupported / 음수: 나클립스 플레이어 생성중 에러발생. |
|
burnPlayerAudio(id_layer,id_player,docu) |
나클립스 오디오 플레이어를 준비한다. |
id_layer |
str |
나클립스 플레이어가 로딩될 Layer ID. (Div Tag의 ID를 입력) |
id_player |
str |
생성될 나클립스 플레이어의 Object ID 명 |
docu |
object |
나클립스 플레이어가 생성될 documet object. (기본값: document) |
Return |
number |
1: 성공 / false: Unsupported / 음수: 에러발생. |
|
changeMediaSrc (s_src,s_param) |
나크립스 플레이어의 스트미링 미디어 소스를 변경한다. |
s_src |
str |
스트리밍 소스 URL (ex: assp://vod.nexpply.co.kr/vod/a.mp4) |
s_param |
str |
서버의 Media Access 로그 파일에 기록될 파라메터 문자열 |
|
changeStyle(s_name,s_style) |
나클립스 HTML5 플레이어 스킨 이미지에 적용된 스타일을 변경한다. (Stylesheet 기본 설정값은 lib_naclips_style_xxxxx.js 파일에 정의 되어 있다.) |
s_name |
str |
스타일 명칭 |
s_style |
str |
변경될 스타일 스트링. |
Return |
number |
성공시 스타일 리스트의 변경된 스타일 인덱스 값 리턴 (스타일 리스트 미생성시 0 리턴) / 실패시 -1 리턴 |
Example |
gx_vodloader.changeStyle('sz_volume_f',"width:4px; height:14px;"); |
|
changeSubtitle(idx, s_file, s_label, s_language, s_charset) |
이미 추가되어 있는 자막파일 URL을 변경한다. |
idx |
number |
추가된 자막의 순서값 (0부터 시작됨). |
s_file |
str |
자막파일 URL(ex: /subtitle/demo.srt) |
s_label |
str |
나클립스 HTML5 플레이어에 표시될 자막 제목. (기본값:Korean) |
s_language |
str |
자막파일의 언어 종류. (기본값:ko) |
s_charset |
str |
자막파일의 Charcter Set. (기본값:UTF-8). |
|
clearMediaSrc() |
미디어 소스 리스트를 비운다. |
|
clearMultiBpsMenu(b_show_menu) |
다중 대역폭 스트리밍 메뉴 리스트를 초기화 한다. |
b_show_menu |
boolean |
true : 메뉴 삭제후 메뉴 리스트 Show / false : 메뉴 삭제후 메뉴 리스트 Hidden |
|
close() |
나클립스 ActiveX Player를 종료한다. |
|
enableExtender(b_enable) |
나클립스 익스텐더(Naclips Extender)를 활성화 하여, 동영상 녹화를 방지한다. |
b_enable |
boolean |
true: 나클립스 익스텐더 활성화 / false: 나클립스 익스텐더 비활성화 |
|
getActivatedSubtitleTrack() |
활성화된 자막의 순서 값을 가져온다. |
Return |
number |
활성화된 자막의 순서(index) 값 |
|
getAgentLang() |
사용자의 웹브라우저 기본언어 코드 쿼리. |
Return |
str |
사용자의 웹브라우저 기본언어 코드 (ex: ko, ja, en ...) |
|
getBrowser() |
웹브라우저 종류값을 가져온다. |
Return |
str |
ie:Internet Explorer / gc:Google Chrome / fx:Firefox / as:Apple Safari |
|
getDocWinSize(docu) |
HTML Document의 넓이, 높이 값을 가져온다. |
docu |
object |
Documet Object. |
Return |
variable |
{x:width, y:height} |
|
getLayerId() |
burnPlayer() 함수에서 입력된 Naclips Player Base Layer ID 쿼리. |
Return |
str |
Naclips Player Base Layer ID |
|
getMediaIdx() |
미디어 스트리밍 연속 재생시 현재 재생중인 미디어 소스 순서값을 가져온다. |
Return |
number |
재생중인 미디어 소스 순서값(index) |
|
getMultiBpsIdx() |
다중 대역폭 스트리밍시 현재 선택된 대역폭 순서값을 가져온다. |
Return |
number |
현재 선택된 대역폭 순서값(index) |
|
getProperty(s_name) |
나클립스 플레이어의 프로퍼티(Property)값을 가져온다. |
s_name |
str |
프로퍼티 명칭 (Property Name) |
Return |
variable |
지정된 프로퍼티의 값. |
|
getStreamingSpeed() |
인터넷 속도 체크 사용시, 체크된 네트워크의 초당 전송비트수(Bps)를 가져온다. |
Return |
dpouble |
초당 전송률(bps - BitsPerSecond) |
|
getSubtitleCount() |
장착된 자막들의 전체 갯수를 리턴한다. |
Return |
number |
나클립스 HTML5 플레이어에 정상적으로 로드된 자막 갯수 |
|
hiddenCtrlsOnInit(b_hide) |
나클립스 HTML5 플레이어가 생성될때 콘트롤 레이어를 감춘 상태로 시작한다. |
b_hide |
boolean |
true: hidden / false: show |
|
initVdoSpace() |
나클립스 플러그인 플레이어 작동시에만 효용성 있는 함수로서, 나클립스 비디오 평면을 초기화 한다. xvnt_EndInitEx() 이벤트 함수에서 실행하도록 한다. |
|
isMobile() / is_mobile() |
사용자의 디바이스 환경이 모바일 환경(Android, iOS)인지 검사한다. |
Return |
boolean |
true / false |
|
is_android() / is_ios() / is_ipad() / is_ipod_phone() / is_windows() |
사용자의 디바이스 및 OS 환경을 검사한다. |
Return |
boolean |
true / false |
|
loadPlayer() |
나클립스 플레이어를 웹페이지에 로딩한다. |
Return |
number |
1: 성공 / -1: VOD Query URL 값이 없습니다. / -2: VOD Query 객체를 생성하지 못하였습니다. / 0: 미디어 소스를 로딩하지 못하였습니다. |
|
next() |
연속 재생시 다음 미디어 소스를 재생한다. |
|
pause() |
스트리밍 재생 잠시 멈춤. |
|
play() |
스트리밍 재생 시작. |
|
previous() |
연속 재생시 이전 미디어 소스를 재생한다. |
|
resize(i_w,i_h) |
나클립스 플레이어의 가로,세로 크기를 변경한다. |
i_w |
number |
나클립스 플레이어의 넓이값 (가로 픽셀값) |
i_h |
number |
나클립스 플레이어의 높이값 (세로 픽셀값). |
|
rightVolIcon(b_right) |
볼륨 아이콘을 왼쪽에 위치 할것인지, 오른쪽에 위치 할것인지 설정. |
b_right |
boolean |
true: 오른쪽에 위치 / false : 왼쪽에 위치 |
|
runCheckSpeed(i_kbytes,i_secs,s_server) |
네트워크 속도 측정을 시작한다. |
i_kbytes |
number |
네트워크 속도 체크를 위하여 서버에서 전송받을 데이터량(Kbyte) |
i_secs |
number |
전송받을 최대 시간(초). 이 시간을 초과하면 속도 측정을 종료한다. |
s_server |
str |
속도 측정을 할 서버 URL (생략시 스트리밍 미디어 소스 URL) |
Example |
gx_vodloader.runCheckSpeed(5*1024,3); 3초 안에 5MByte 수신. |
|
runMethod(s_name, arg1,arg2,arg3,arg4) |
나클립스 플레이어의 메서드(Method)를 실행한다. |
s_name |
str |
실행할 메서드의 이름(Method Name) |
arg1 |
variable |
메서드의 첫 번째 인자값. (생략가능) |
arg2 |
variable |
메서드의 두 번째 인자값. (생략가능) |
arg3 |
variable |
메서드의 세 번째 인자값. (생략가능) |
arg4 |
variable |
메서드의 네 번째 인자값. (생략가능) |
Return |
variable |
메서드의 실행 결과값. |
|
setBackgroundAudio(s_url, i_ogn_volume) |
BGM(Background Audio) 스트리밍을 설정한다. |
s_url |
str |
스트리밍 미디어 URL (ex: assp://192.168.1.1:80/audio/samp.m4a) |
i_ogn_volume |
number |
원본 동영상의 볼륨(0 ~ 100) |
|
setBackgroundAudioOption(s_name, v_val) |
BGM(Background Audio) 스트리밍 옵션값을 설정한다. |
s_name |
str |
옵션 명 (Option Name)
origin_volume: 원본 영상 파일의 오디오 볼륨값을 설정. (0 ~ 100).
repeat: Background Audio 재생을 반복할 것인지 설정. (true/false)
sync_video: 영상파일과 재생 동기화 할것인지 설정. (true/false)
|
v_val |
variable |
옵션 값 (Option Value) |
|
setBackgroundMessage(s_play, s_stop) |
나크립스 HTML5 비디오 플레이어로 오디오 파일(M4A)을 스트리밍 재생할때 백그라운드 메세지 문자열을 설정한다. |
s_play |
str |
재생시 메세지 (기본값: 'Now Playing Audio..') |
s_play |
str |
멈춤시 메세지 (기본값: '') |
|
setBaseLeft(i_left) |
나클립스 플레이어의 AboutBox 또는 MessageBox 출력시, 나클립스 HTML5 플레이어의 왼쪽 여백값을 지정한다. |
i_left |
number |
나클립스 HTML5 플레이어의 왼쪽 여백 픽셀값. |
|
setInitPos(i_init_pos) |
미디어 스트리밍 재생시 지정된 시간 부터 재생을 시작한다. |
i_init_pos |
number |
시작 시간(초 단위) |
|
setMultiBpsIdx(i_dx) |
다중 대역폭 스트리밍 재생시, 스트리밍 재생할 대역폭을 선택하다. |
i_dx |
number |
선택할 다중 대역폭 순서값(index) |
|
setNaexCheckInterval(i_check_delay,i_check_maximum) |
나클립스 익스텐더 사용시, 익스텐더 프로그램의 실행여부 체크 간격 지정 |
i_check_delay |
number |
체크 간격 (기본값 : 0.5초 / 단위 : 밀리초) |
i_check_maximum |
number |
체크 횟수 (기본값 10) |
Example |
gx_vodloader.setNaexCheckInterval(0.3*1000,10); //0.3초 간젹으로 10회 검사. (setNaexCheckInterval 함수 미실행시, 0.5초 간격으로 10회 검사로 기본설정 되어 있음) |
|
setProperty(s_name,value) |
나클립스 플레이어의 프로퍼티(Property)값을 입력한다. |
s_name |
str |
프로퍼티 명칭 (Property Name) |
value |
variable |
입력될 프로퍼티의 값. |
Return |
boolean |
true: 성공 / false : 입력 실패 |
|
setShowSubtitle(b_show) |
자막의 출력여부를 설정한다. |
b_val |
boolean |
true(show) / false(hidden) (기본값 : true) |
|
setShowUnsupportSubtitle(i_val) |
HTML5 자막 기능이 지원되지 않는 웹브라우저에서 메세지 박스 출력 여부 결정. |
b_val |
boolean |
true / false (기본값 : true) |
|
setSubtitleClearOnChangeMedia(b_clear) |
스트리밍 동영상 소스 변경시, 이미 불러온 자막을 비울것인지 결정한다. |
b_clear |
boolean |
true / false (기본값 : true) |
|
setSubtitleDisablingLabel(s_label) |
나클립스 HTML5 플레이어의 자막메뉴에서 "자막 감추기" 메뉴의 제목을 지정. |
s_label |
str |
"자막 감추기" 메뉴의 라벨명 (기본값 : None) |
|
setSubtitleFontSizeRatio(i_val) |
자막 텍스트의 폰트 사이즈 축소 배율값을 지정한다. |
i_val |
number |
축소배율값. 자막 Font Size = (HTML5 Player 높이 픽셀값)/축소배율값 이다. (기본값:20 => 자막폰트 사이즈는 플레이어 높이값의 1/20.) / 전체화면일때 30 |
|
setSubtitlePaddingBottom(i_val) |
나클립스 HTML5 플레이어 자막의 아래 여백값을 지정한다. |
i_left |
number |
아래 여백 픽셀값.(기본값 : 8) |
|
setSubtitleParser2Br(b_val) |
줄바꿈 문자를 <BR> 태그로 자동으로 바꿈. |
b_val |
boolean |
true / false (기본값 : true) |
|
setThumbSrcIdx(i_dx) |
멀티 대역폭 재생시 썸네일 이미지 디렉토리 순서값(index) 지정. |
i_dx |
number |
썸네일 이미지 디렉토리 순서값(index) / setThumbSrcIdx 함수 미 실행시, 썸네일 이미지 디렉토리 순서값은 0으로 세팅퇴어 있음. |
|
setTrimming(i_begin, i_end) |
트리밍 플레이 영역을 설정한다. |
i_begin |
number |
시작 시간 (초단위) |
i_end |
number |
종료 시간 (초단위) |
|
setTrimmingOption(s_name, v_val) |
트리밍 플레이 옵션 설정. |
s_name |
str |
옵션 명 (Option Name)
reset_on_next: 다음 영상 재생시 트리밍 플레이 리셋 (true/false)
|
v_val |
variable |
옵션 값 (Option Value)
|
|
setWatermark(s_img_url, s_text, i_position) |
워터마킹 플레이 설정. |
s_img_url |
str |
워터마크 이미지 URL. |
s_text |
str |
워터마크 클릭시 이벤트로 전송될 문자열 |
i_position |
number |
워터마크 위치값. (0:top-center, 1:top-right, 2:middle-right, 3:bottom-right, 4:bottom-center, 5:bottom-left, 6:middle-left, 7:top-left, 8:middle-center) |
Example |
gx_vodloader.setWatermark('/image/wmark.png','',7); 또는 gx_vodloader.setWatermark('http://nexpoly.com/image/wmark.png','http://www.nexpoly.co.kr',1); |
|
setWatermarkOption(s_name, v_vara, v_varb) |
워터마크 옵션 설정. |
s_name |
str |
옵션 명 (Option Name)
margin : 워터마크와 비디오화면 경계선 사이의 간격. (단위: Pixel)
size : 워터마크 이미지의 가로, 세로 픽셀값을 지정하여 이미지를 확대하거나 축소한다. -1 지정시 원본 이미지 크기로 지정된다. (단위: Pixel / 기본값 : -1)
position : 워터마크 위치를 변경한다. (위치정보 - setWatermark 메서드 참조)
url : 워터마크 이미지 URL을 지정하여, 워터마크 이미지를 변경한다.
|
v_vala |
variable |
첫 번째 옵션 값 (Option Value)
|
v_valb |
variable |
두 번째 옵션 명 (Option Value)
|
|
showCloseBtn(b_show) |
모바일용 나클립스 HTML5 플레이어에서 창닫기 버튼 보이기/감추기 설정. |
b_show |
boolean |
true(show) / false(hidden) (기본값 : false) |
|
showCtrlIcon(s_name, b_show) |
플레이어 스킨 콘트롤 아이콘 보이기/감추기 설정. |
s_name |
str |
아이콘 이름 (play, volume, multibps, jamak, repeat, speed, full) |
b_show |
boolean |
true(show) / false(hidden) |
|
showCtrlThumbs(b_show) |
썸네일 이미지와 플레이어 콘트롤 레이어 보이기/감추기 설정. |
b_show |
boolean |
true(show) / false(hidden) |
|
showPlayer(b_show) |
나클립스 플레이어를 보이게 하거나 감춘다. |
b_show |
boolean |
true(show) / false(hidden) |
|
showWatermark(b_show) |
워터마크 보이기/감추기 설정. |
b_show |
boolean |
true(show) / false(hidden) |
|
supportHtml5() |
HTML5 지원가능 여부 쿼리. |
Return |
boolean |
true: 지원 / false: 미지원. |
|
unload() |
나클립스 HTML5 플레이어를 닫는다. (페이지 전환 또는 웹브라우저 종료시 에는 자동으로 종료됨) |
|