| NACLIPS HTML5 UPLOADER CLASS INTERFACE METHODS. |
|
cx_nuploader5(id_form)
|
Naclips HTML5 Uploader Constructor
|
| id_form |
element |
업로드용 Form Tag HTML Element |
|
| abortUpload() |
진행중인 업로드 프로세스를 중지 및 취소한다. |
|
| getBytesTotal() |
업로드 하기위해 선택한 파일(들)의 전체 바이트수를 가져온다. |
| Return |
number |
파일(들)의 전체 바이트수 |
|
| getBytesUploaded() |
업로드 완료한 파일(들)의 전체 바이트수를 가져온다. |
| Return |
number |
파일(들)의 전체 바이트수 |
|
| getDragFiles() |
드래그 앤 드롭(Drag & Drop)한 파일 객체를 가져온다. |
| Return |
object |
드래그 앤 드롭(Drag & Drop)한 파일 객체 |
|
| getEncResCount() |
업로드 완료후, 인코딩 예약된 멀티미디어 파일의 갯수를 가져온다. |
| Return |
object |
인코딩 예약된 멀티미디어 파일의 갯수 |
|
| getRemainMsec() |
업로드 완료까지 남은 시간의 예상값을 밀리초 단위로 가져온다. |
| Return |
object |
업로드 완료까지 남은 시간의 밀리초 단위값 |
|
| getRes(i_dx) |
업로드 완료한 파일의 결과값을 가져온다. |
| i_dx |
number |
파일의 순서값 (index) |
| Return |
struct |
결과값은 구조체 형태인데 구조체의 요소들은 아래와 같다.
{ s_local_fn(로컬 파일명), s_server_fn(서버에 저장된 원본 파일명), i_file_size(원본 파일크기), i_enc_seq(인코딩 예약 순서값),
i_enc_key(인코딩 예약 키), s_enc_res(인코딩 결과값), s_enc_fn(인코딩 출력된 파일명) }
|
|
| getResCount() |
업로드 완료한 파일의 갯수를 가져온다. |
| Return |
number |
업로드 완료한 파일의 갯수 |
|
| getUploadBitsPerSec() |
파일 업로드 초당 비트수(bits per second) : bps 단위. |
| Return |
number |
파일 업로드 초당 비트수 |
|
| getUploadSpeed() |
파일 업로드 초당 바이트수(bytes per second) : cps 단위. |
| Return |
number |
파일 업로드 초당 바이트수 |
|
| isSupportHtml5() |
사용자의 웹브라우져가 나클립스 HTML5 업로드 처리가 가능한지 HTML5 지원여부를 체크 한다. |
| Return |
boolean |
HTML5 업로드 지원여부 |
|
| removeEncodingParam(s_name) |
지정된 인코딩 설정값을 제거한다. |
| s_name |
string |
인코딩 설정 항목명 |
Return |
boolean |
true: 제거 성공 / false: 제거 실패. |
|
| runUpload(x_form_data) |
지정된 Form Tag Element의 Form Data(파일 객체 포함)를 업로드 한다. |
| x_form_data |
object |
Form Data Object(미 지정시 cx_nuploader5 클래스 생성자에서 지정된 Form Tag가 적용됨) |
| Return |
boolean |
업로드 성공 여부 |
|
| runUploadEx(id_form,id_file,ob_src_form) |
Method 내부에서 새로 생성한 Form Data 객체를 통하여 서버로 파일 및 Form data를 업로드 한다. (drag & drop 파일 선택시 사용) |
| id_form |
string |
Method 내부에서 새로 생성할 Form Data 객체의 ID 명.(3번째 파라메터 ob_src_form 객체를 복제하여 새로운 Form Data 객체를 생성.) |
| id_file |
string |
드래그 앤 드롭한 파일이 저장될 소스 Form Data 객체(3번째 파라메터 Object)의 File Input Tag Element 의 ID 값. |
| ob_src_form |
object |
Method 내부에서 새로 생성할 Form Data 객체의 복제 원본 Form Data Tag Element 객체 |
|
| runningNow() |
현재 업로드 진행여부를 확인한다. |
| Return |
boolean |
업로드 진행중 여부. |
|
| setAuthVars(s_1st_param, s_2nd_param, s_3rd_param, s_return) |
나클립스 업로드 인증 사용시 인증 파라메터 값을 세팅한다. |
| s_1st_param |
string |
첫 번째 인증 파라메터 값 |
s_2nd_param |
string |
두 번째 인증 파라메터 값 |
| s_3rd_param |
string |
세 번째 인증 파라메터 값 |
s_return |
string |
업로드 인증 체크 결과값. |
|
| setDragFiles(ob_files) |
드래그 앤 드롭(Drag & Drop)한 파일 객체를 저장한다. |
| ob_files |
object |
드래그 앤 드롭(Drag & Drop)한 파일 객체 |
|
| setEncoding(i_valu) |
업로딩 완료후, 나클립스 인코더 서버와 연동하여 멀티미디어 파일의 인코딩 여부를 세팅한다. |
| i_valu |
number |
0: disable encoding / 1: enable encoding / 2: forceful encoding |
|
| setEncodingParam(s_name,x_valu) |
인코딩 설정값을 세팅한다. |
| s_name |
string |
인코딩 설정 항목명 |
x_valu |
variable |
인코딩 설정값 |
| Example |
gx_nuploader.setEncodingParam('enc_video_cdc','x264');
gx_nuploader.setEncodingParam('enc_video_height',720);
gx_nuploader.setEncodingParam('enc_video_bitrate','1500,1000');
gx_nuploader.setEncodingParam('enc_audio_bitrate','256,128');
gx_nuploader.setEncodingParam('enc_video_height','1080,720');
|
인코딩 설정 항목 참고(Encoding Option List)
- 미지정 인코딩 설정 항목은 나클립스 인코더 서버엔진의 인코딩 설정파일(nexenc.conf)의 설정값을 따름.
thumbnails_directory,
title_thumbnail_prefix,
title_thumbnail_idx,
enc_audio_source,
enc_audio_trim,
enc_water_mark_enable,
enc_water_mark_image,
enc_water_mark_position,
enc_water_mark_padding,
enc_media_format, enc_video_cdc, enc_audio_cdc, enc_video_bitrate, enc_video_fps, enc_video_aspect_ratio, enc_base_direction, enc_video_width, enc_video_height, enc_video_resize_style, enc_audio_bitrate, enc_audio_sample_rate, enc_audio_mode, enc_audio_volume (황토색으로 표기된 인코딩 설정 항목에 대한 설명은 나클립스 인코더 서버 인코더 설정파일(conf/nexenc.conf) 참고 요망)
|
|
| setUploaderURL(s_url) |
파일이 업로드될 서버 및 업로드 디렉토리 지정 |
| s_url |
string |
upload url (ex: '192.168.0.100:4659/upload/2018') |
|
| NACLIPS HTML5 UPLOADER CLASS INTERFACE EVENTS. |
| naclips_upload_process_event | |
|
업로드 진행 상태가 변경될때 발생한다. |
| detail.form_id |
Uploading Form data Tag Element's ID |
detail.event_id |
event-name ('start', 'progress', 'load', 'error', 'abort') |
| detail.s_option |
optional string value |
detail.i_option |
optional numeric value |
| detail.x_uploader |
해당 이벤트를 발생시킨 나클립스 업로더 클래스 객체(2개 이상의 나클립스 업로더 클래스 객체를 생성하였을 경우 사용됨) |
|
| naclips_upload_speed_event | |
|
파일 업로드시, 0.5초 간격으로 업로드 속도를 계산하여 발생 |
| detail.form_id |
Uploading Form data Tag Element's ID |
detail.send_bytes |
전송 완료한 바이트수 |
| detail.cps |
초당 바이트 전송률(Character Per Second) |
detail.bps |
초당 비트 전송률(Bit Per Second) |
| detail.passed_msec |
업로드 시작후 경과 시간(밀리초 단위) |
detail.remain_msec |
업로드 완료까지 남은 시간(밀리초 단위 / 예상값) |
|
