|
NACLIPS UPLOADER SERVER Ver 2.0 :: ACTIVEX / PLUG-IN CONTROL INTERFACE
|
NACLIPS UPLOADER CONTROL'S METHODS. |
CancelProcess() |
현재 처리중인 작업을 취소한다. |
Return |
boolean |
성공시 true, 실패시 false 리턴. |
|
ConnectServ( ) |
나클립스 업로더 서버에 수동으로 접속한다. 나클립스 업로더 클라이언트는 기본적으로 서버접속이 필요한 경우 내부적으로 자동 접속한다. |
Return |
long |
접속 결과값을 리턴. (성공시 1리턴 / 에러시 1이 아닌 에러코드 리턴) |
|
ControlFile(short siCmd, str FileName) |
전송 완료후, 서버에 저장된 임시파일을 완료하거나 파일을 삭제한다.
|
Return |
long |
접속 결과값을 리턴. (성공시 1리턴 / 에러시 1이 아닌 에러코드 리턴) |
siCmd |
short |
0(complete) - 서버에 저장된 임시파일을 완료한다. (마지막 업로드한 파일) / 1(complete) - 서버에 저장된 임시파일을 완료한다. (FileName에 지정된 파일)
-1(delete) - 서버에 저장된 파일을 삭제한다. (FileName에 지정된 파일)
|
FileName |
str |
서버에 저장된 파일명
|
|
DisableFileSlot(short idx) |
다중 파일 업로드 시, idx 번째 파일슬롯을 비활성 한다. 비활성화된 FileSlot의 파일에 대해서는 Encoding 및 Uploading 작업이 수행되지 않는다.
|
Return |
short |
결과값. true:성공 / false:실패 |
idx |
short |
파일 슬롯 번호.
|
|
EncodeFileEx(short siCmd) |
클라이언트 PC의 원본 동영상 파일을 인코딩 한다.
EncodeFileEx 함수는 별도의 프로세스로 실행된다.
그러므로 최종 실행 결과값은 'StatusChange' 이벤트를 통해 알 수 있다.
|
Return |
long |
양수 - 인코딩 수행됨. / check mode일 경우 인코딩 필요한 이유 코드.
0 - 인코딩 필요 없음.
음수 - 인코딩 실패(에러 발생).
|
siCmd |
short |
0(check) - 동영상 인코딩이 필요한지 검사해 본다.
1(auto) - 인코딩 작업이 필요한 파일인 경우 인코딩 과정 수행.
2(enforce) - 강제적으로 인코딩 작업을 수행.
|
|
EncodeFile(short siCmd) |
클라이언트 PC의 원본 동영상 파일을 인코딩 한다. 인코딩 작업시, 별도의 팝업 윈도우를 생성하여 인코딩 진행률을 표시한다. 작업이 종료후 리턴되는 결과값으로 인코딩 결과를 알 수 있다.
|
Return |
long |
양수 - 인코딩 수행됨. / check mode일 경우 인코딩 필요한 이유 코드.
0 - 인코딩 필요 없음.
음수 - 인코딩 실패(에러 발생).
|
siCmd |
short |
0(check) - 동영상 인코딩이 필요한지 검사해 본다.
1(auto) - 인코딩 작업이 필요한 파일인 경우 인코딩 과정 수행.
2(enforce) - 강제적으로 인코딩 작업을 수행.
|
|
ForceClose( ) |
나클립스 업로더 콘트롤을 강제적으로 닫는다. 웹브라우저를 닫거나 다른 페이지로 이동하는 것과 같은 효과가 있다. |
Return |
boolean |
무조건 true값 리턴. |
|
GenThumbEx(short idx) |
idx번째 파일의 썸네일 이미지를 생성한다. 이 함수는 서버로 파일이 저장된 후 수행 가능하다. GenThumbEx 함수는 별도의 프로세스로 실행된다. 그러므로 정확한 실행 결과값은 'StatusChange' 이벤트를 통해 알 수 있다. GenThumbEx 함수 실행시 바로 리턴 되는 값은 썸네일 생성 프로세스의 실행 여부 값이다.
|
Return |
short |
1 - 썸네일 생성 프로세스가 정상적으로 실행됨.
2 - 이미 프로세스가 실행중일때.
-1 - 생성될 썸네일 갯수가 0 (ThumbCount Property 참조)
-2 - NexTube 서버 접속정보가 없을때(NexTube Property 참조)
-3 - 썸네일 이미지를 생성할 동영상 파일이 없을때
-4 - 지정된 파일이 서버로 업로드 되지 않았을때
|
idx |
short |
파일 순서값.
첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
-1 값이 지정될 경우 업로드한 모든 영상파일의 썸네일 생성한다.
|
|
GetServFileName(short idx) |
idx번째 파일의 서버에 저장된 파일명을 가져온다.
|
Return |
str |
서버에 저장된 파일명.
|
idx |
short |
원본 파일 순서값. 첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
|
|
GetSourceFileFlag(short idx) |
idx번째 원본 파일의 상태값(Flag 값)을 가져온다.
|
Return |
short |
원본 파일의 상태값(Flag 값)
0:default/ 1:미디어 파일로 체크됨/ 2:인코딩 필요없음/
3:인코딩 완료됨/ 4:원본 파일이 업로드됨/ 5:인코딩된 파일이 업로드 됨
|
idx |
short |
원본 파일 순서값. 첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
|
|
GetSourceFilePath(short idx) |
idx번째 원본 파일의 Path를 가져온다.
|
Return |
str |
원본 파일의 Path 문자열
|
idx |
short |
원본 파일 순서값. 첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
|
|
LoadMediaHeader(short idx) |
idx번째 파일을 분석하여 동영상 헤더 정보를 읽어온다.
읽어온 미디어 헤더 정보는 Src*, Dst* Property 인터페이스를 통해 가져올 수 있다.
|
Return |
short |
0: 다른 프로세스가 처리중 이거나, 분석할 파일이 없을때.
1: 원본 영상 파일만 분석됨 / 2: 인코딩된 파일만 분석됨.
3: 원본 파일과 인코딩된 파일이 모두 분석됨.
-1: 해당 파일이 없을때.
|
idx |
short |
원본 파일 순서값. 첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
|
|
RemoveLocalCacheEx(short idx) |
서버에 업로드하기 위해 인코딩 생성된 클라이언트 PC의 임시파일을 삭제한다.
|
Return |
short |
idx 값이 -1일 경우 삭제된 임시 파일 갯수를 리턴.
idx 값이 -1보다 클경우,
1 - 임시파일 삭제 성공
-1 - 임시파일 삭제중 에러 발생(파일 삭제 에러)
-2 - 삭제할 파일이 존재하지 않습니다.
|
idx |
short |
파일 순서값. 첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
-1일 경우 리스트의 인코딩된 모든 파일의 임시파일을 삭제한다.
|
|
ResetControl() |
모든 처리 프로세스틀 Stop하고 나클립스 업로더 콘트롤 파일을 초기 상태(파일을 불러오기 전 상태)로 되돌린다.
만약 서버에 파일을 Upload 하였다면 서버에 Upload한 파일도 삭제된다. (AutoDelIncompleted Property가 1로 세팅되고 SessionComplete Property가 1로 세팅되지 않았을 경우)
|
Return |
|
리턴값 없음 |
|
SelectFile( ) |
원본 동영상 파일을 선택할수 있도록 파일선택창을 나타나게 한다. |
Return |
str |
파일명 리턴. 선택된 파일이 없으면 빈값(null)리턴. |
|
SetTitleImage(short idx, str ThumbnailPath) |
ThumbnailPath에 지정된 썸네일 이미지 파일을 idx번째 동영상 파일의 Title 이미지로 Nextube 서버에 저장한다. |
Return |
short |
1: 정상적으로 처리됨.
0: 처리불가. 서버파일이 저장되지 않았거나, ThumbnailPath값 없음.
-1 - 썸네일 파일이 존재하지 않음.
-2 - 썸네일 파일을 생성할 수 없음.
-3 - 대표 이미지 파일을 Nextube 서버에 저장 할 수 없음
|
idx |
short |
동영상 파일 순서값.
첫번째 파일의 순서값은 0이다. 단일 파일일때 값은 0이다.
|
ThumbnailPath |
str |
Title 이미지로 저장할 Thumbnail Image File path.
ThumbnailPath값은 StatusChange 이벤트에서 추출한다.
|
|
UploadFileEx(short siEncOpt) |
UploadFile함수의 확장함수이다. 여러 파일을 한꺼번에 업로드 할 수 있다. UploadFileEx 함수는 별도의 프로세스로 실행된다.
그러므로 정확한 실행 결과값은 'StatusChange' 이벤트를 통해 알 수 있다. UploadFile함수 실행시 바로 리턴 되는 값은 Upload 프로세스의 실행 여부 값이다.
|
Return |
short |
1 - Upload 프로세스가 정상적으로 실행됨.
2 - 이미 프로세스가 실행중이거나 다른 실행 프로세스가 진행 중일때.
-1 - 나클립스 업로더 서버로의 접속 에러.
|
idx |
short |
0(false) - 인코딩 작업없이 파일 업로딩.
1(auto ) - 원본파일 검사후, 필요시 인코딩 작업수행후 파일 업로딩.
2(force) - 강제적으로 인코딩 작업수행후 파일 업로딩.
|
|
UploadFile(short siEncOpt) |
파일 업로드 함수이다. 단일 파일 업로드만 가능하며, 필요시 소스 동영상 파일의 인코딩 작업후 인코딩 변환된 파일을 업로드 한다.
업로드 작업시, 별도의 팝업 윈도우를 생성하여 업로드 진행률을 표시한다. 작업이 종료후 리턴되는 결과값으로 업로드 결과를 알 수 있다.
|
Return |
short |
양수 - 파일 업로드 성공.
0 - 이미 업로드 진행중이거나, 업로드 취소됨.
음수 - 파일 업로드 실패.
|
idx |
short |
0(false) - 인코딩 작업없이 파일 업로딩.
1(auto ) - 원본파일 검사후, 필요시 인코딩 작업수행후 파일 업로딩.
2(force) - 강제적으로 인코딩 작업수행후 파일 업로딩.
|
|
UploadFileSource(str FilePathOnServer) |
선택된 원본파일을 인코딩 하지 않고 바로 업로드하는 함수이다. UploadFileSource 함수는 별도의 프로세스로 실행된다.
그러므로 정확한 실행 결과값은 'StatusChange' 이벤트를 통해 알 수 있다. UploadFileSource함수 실행시 바로 리턴 되는 값은 Upload 프로세스의 실행 여부 값이다.
|
Return |
short |
1 - Upload 프로세스가 정상적으로 실행됨. / 0 - 업로드 또는 인코딩 프로세스가 실행중이거나 작업이 중지 되었을때 / 음수 - Upload 프로세스 실패.
-1: 선택된 파일이 없음. / -2: 선택된 파일명이 잘못되었음.
-3: 서버 파일명이 정해지지 않았을 경우. 변환파일을 업로드 완료 해야함. / -4: 서버 파일명이 잘못되었을 경우.
|
FilePathServer |
str |
업로드 서버에 저장될 파일 경로(File Path)
FilePathOnServer 파라메터 예제:
UploadFile,UploadFileEx 함수에 저장된 서버의 파일명이 /video/enc/AI6FJS0.mp4 파일이고 선택된 원본영상의 파일명이 video.AVI 이라면,
파라메터가 "" 이면 서버에 저장될 파일명은 /video/enc/AI6FJS0.avi 이다.
파라메터가 "server.avi" 이면 서버에 저장될 파일명은 /video/enc/server.avi 이다.
파라메터가 "/video/source" 이면 서버에 저장될 파일명은 /video/source/AI6FJS0.avi 이다.
파라메터가 "/video/source/server.avi" 이면 서버에 저장될 파일명은 /video/source/server.avi 이다.
파라메터가 "/video/source/server.wmv" 이면 서버에 저장될 파일명은 /video/source/server.wmv/AI6FJS0.avi 이다.
=> 서버 영상파일 확장자가 원본영상의 확장자와 다르면 디렉토리로 인식.
|
NACLIPS UPLOADER CONTROL'S PROPERTIES. |
|
|
Name |
Description |
Type |
Get |
Set |
Init |
기본값 |
AllFormatExt |
동영상 파일 선택시 모든형식의 파일을 선택 가능하도록 할것인지 여부. |
short |
O |
X |
O |
0 |
AutoCompleteFn |
업로드 완료시 임시파일명 실제파일명을 자동변경. 이 값이 Off이면 ControlFile Method를 통해 수동으로 파일명을 완성 하여야 한다. |
short |
O |
X |
O |
0 |
AutoConnection |
ActiveX 콘트롤 로드시 자동 서버 접속 여부 |
short |
O |
X |
O |
0 |
AutoDelIncompleted |
이 값을 1로 설정할 하면, SessionComplete Property 값이 1로 세팅 되지 않을경우 나클립스 업로더 콘트롤이 닫힐때 서버에 업로드된 파일이 자동으로 삭제된다.
파일 업로드후 DB에 파일정보를 기록하면서 SessionComplete Property 값을 1로 세팅하여 업로드된 파일의 삭제를 막을 수 있다.
이 Property는 파일정보가 DB에 기록되지 않은상태로 서버에 저장된 파일을 막기 위해 사용한다. (SessionComplete Property 참조)
|
short |
O |
O |
O |
0 |
AutoTitleIdx |
썸네일 이미지 생성시 자동으로 생성할 타이틀 이미지의 순서값. 첫번째 순서값은 1 이다. (0: 자동생성 안함) |
short |
O |
O |
O |
0 |
Autorain |
오토레인 모듈 업데이트 서버 접속 IP주소 |
str |
O |
X |
O |
|
DstAudioBitsRate |
최종 영상파일의 오디오 비트레이트(kbps 단위) |
short |
O |
X |
X |
|
DstAudioBrMode |
최종 영상파일의 오디오 비트레이트 모드
0:cbr(Constant Bit Rate) 1:abr(Average Bit Rate)
|
short |
O |
X |
X |
|
DstAudioCDC |
최종 영상파일의 오디오 압축방식
|
str |
O |
X |
X |
|
DstAudioCH |
최종 영상파일의 오디오 채널 수
|
short |
O |
X |
X |
|
DstAudioSampRate |
최종 영상파일의 오디오 샘플링 비율(Hz 단위)
|
long |
O |
X |
X |
|
DstDuration |
최종 영상파일의 재생 시간(초 단위 시간)
|
long |
O |
X |
X |
|
DstFileBitsRate |
최종 영상파일의 파일 비트레이트(kbps 단위)
|
long |
O |
X |
X |
|
DstFileCtime |
최종 영상파일의 파일생성 시각
|
str |
O |
X |
X |
|
DstFileMtime |
최종 영상파일의 파일변경 시각
|
str |
O |
X |
X |
|
DstFileName |
최종 영상파일의 파일명
|
str |
O |
X |
X |
|
DstFileSize |
최종 영상파일의 파일 크기
|
double |
O |
X |
X |
|
DstMediaType |
최종 영상파일의 동영상 형식
WMA_MEDIA 0x01 / WMV_MEDIA 0x02 / AVI_MEDIA 0x03 / MPG_MEDIA 0x04 / MP3_MEDIA 0x05
MP4_MEDIA 0x06 / OGG_MEDIA 0x07 / OGM_MEDIA 0x08 / MKV_MEDIA 0x09 / M4A_MEDIA 0x0A / M4V_MEDIA 0x0B / FLV_MEDIA 0x0C
|
short |
O |
X |
X |
|
DstNdxes |
최종 영상파일의 프레임 인덱스 갯수(AVI, WMV only)
|
short |
O |
X |
X |
|
DstVideoBitsRate |
최종 영상파일의 비디오 비트레이트(kbps 단위)
|
short |
O |
X |
X |
|
DstVideoBrMode |
최종 영상파일의 비디오 비트레이트 모드
STREAM_CBR 1 / STREAM_VBR 2
|
short |
O |
X |
X |
|
DstVideoCDC |
최종 영상파일의 비디오 압축 형식
|
str |
O |
X |
X |
|
DstVideoFps |
최종 영상파일의 초당 프레임수
|
double |
O |
X |
X |
|
DstVideoHeight |
최종 영상파일의 비디오 영상의 높이값
|
short |
O |
X |
X |
|
DstVideoWidth |
최종 영상파일의 비디오 영상의 넓이값
|
short |
O |
X |
X |
|
EnableMenuCmd |
팝업메뉴에서 동영상 파일 인코딩 및 업로딩 가능 여부
|
short |
O |
X |
O |
0 |
EncAspect |
커스텀 인코딩 활성시, 비디오 인코딩 비율 옵션
0:original aspect ratio/ 1: 4:3/ 2: 16:9/ 3: custom
|
short |
O |
O |
O |
0 |
EncAudioBitsrateIdx |
인코딩시, 오디오 비트레이트 지정 (0:48, 1:64, 2:128, 3:192, 4:256, 5:320, 6:480, 7:520, 8:640, 9:720, 10:840 kbps)
|
short |
O |
O |
O |
0 |
EncBaseDirection |
영상의 인코딩 비디오 비율 조절시 기준값. 예를들어 이 값이 1이면 EncHeight 값을 기준으로 사이즈 변경됨(1:세로 기준, 0:가로 기준)
|
short |
O |
O |
O |
-1 |
EncCust |
커스텀 인코딩 여부. 비 활성시 나클립스 업로더 서버의 인코딩 설정에 따름. (0:disable, 1:enable)
|
short |
O |
O |
O |
0 |
EncExOptions |
인코딩시, 인코딩 추가 옵션.
|
str |
O |
O |
O |
|
EncFlv |
FLV 포맷 동영상파일의 강제 인코딩 여부
|
short |
O |
O |
O |
0 |
EncFormat |
인코딩될 파일의 포맷 지정. mp4 또는 avi
|
short |
O |
O |
O |
0 |
EncHeight |
커스텀 인코딩 활성시, 인코딩 영상의 비디오 높이
|
short |
O |
O |
O |
0 |
EncOgm |
OGM 포맷 동영상파일의 강제 인코딩 여부
|
short |
O |
O |
O |
0 |
EncReason |
마지막으로 인코딩한 파일이나 인코딩 체크한 동영상의 인코딩 이유
(EncodeFile Method 참조)
|
short |
O |
X |
X |
0 |
EncResize |
커스텀 인코딩 활성시, 영상의 넓이 또는 높이 변경시 여백처리 방법
(0: 잘라냄 / 1: 늘림 / 2: black pad)
|
short |
O |
O |
O |
0 |
EncServAspect |
서버에 설정된 비디오 인코딩 비율 옵션
|
short |
O |
X |
X |
|
EncServHeight |
서버에 설정된 인코딩 영상의 비디오 높이
|
short |
O |
X |
X |
|
EncServResize |
서버에 설정된 영상의 넓이 또는 높이 변경시 여백처리 방법(0: 잘라냄 / 1: 늘림)
|
short |
O |
X |
X |
|
EncServWidth |
서버에 설정된 인코딩 영상의 비디오 넓이
|
short |
O |
X |
X |
|
EncVCDC |
커스텀 인코딩 활성시, 비디오 압축방식(x264/ h264/ mp4v/ xvid/ dx50)
|
str |
O |
O |
O |
|
EncVideoBitsrate |
커스텀 인코딩 활성시, 비디오 압축비율(kbps 단위)
|
str |
O |
O |
O |
|
EncWidth |
커스텀 인코딩 활성시, 인코딩 영상의 비디오 넓이
|
short |
O |
O |
O |
|
FileTrunkSize |
업로드할 파일 목록의 최대 파일 갯수를 지정한다. 이 값이 1보다 클 경우, 파일 드래그 앤 드롭(Drag & Drop)시 여러개 파일 선택이 활설화 된다. 파일을 드래그 앤 드롭하거나 SelectFile() Method로 파일을 불러올때, 불러온 파일들은 FileTrunkSize 갯수 만큼만 파일 리스트 버퍼에 쌓인다.
|
short |
O |
O |
O |
1 |
FnPrefix |
서버에 저장될 동영상 파일의 프리픽스
|
str |
O |
O |
O |
_xfiupx |
GrantParam1 |
웹연동 사용자 인증을 위한 첫번째 파라메터
|
str |
X |
O |
O |
|
GrantParam2 |
웹연동 사용자 인증을 위한 두번째 파라메터
|
str |
X |
O |
O |
|
GrantParam3 |
웹연동 사용자 인증을 위한 세번째 파라메터
|
str |
X |
O |
O |
|
GrantReturn |
웹연동 사용자 인증 성공시 리턴되는 값
|
str |
X |
O |
O |
|
GuageBackRGB |
콘트롤 게이지 배경색
|
str |
O |
X |
O |
#ffffff |
GuageCount |
콘트롤 게이지의 썸네일 박스 갯수
|
short |
O |
X |
O |
24 |
GuageForeRGB |
콘트롤 게이지 전경색(썸네일 박스의 색)
|
str |
O |
X |
O |
e9e9e9 |
GuageHighEncRGB |
인코딩 할때, 콘트롤 게이지 하이라이트색.
|
str |
O |
X |
O |
b0ea00 |
GuageHighRGB |
업로드 할때, 콘트롤 게이지 하이라이트색
|
str |
O |
X |
O |
b0ea00 |
GuageRectRGB |
콘트롤 게이지 썸네일 박스 테두리 색
|
str |
O |
X |
O |
959595 |
IsWorking |
인코딩, 업로딩 또는 썸네일링 작업중이면 1을, 그렇지 않으면 0을 리턴한다.
|
short |
O |
X |
X |
|
Language |
나클립스 업로더 콘트롤의 언어체계를 설정한다. 0:한글 / 1:영어
|
short |
O |
O |
O |
|
LastProcessingIdx |
마지막으로 처리된 미디어 파일의 Sequence Index(순서)값을 가져온다. 첫번째 파일의 순서값은 0이다.
|
short |
O |
X |
X |
|
MultiUpload |
연속 업로딩 여부, 하나의 파일을 업로딩 완료후, 다른 파일을 새로 선택하여 업로드 가능하게 할것인지 여부.(배치 처리로 여러개 파일을 연속적으로 자동 업로드 되는 것이 아님)
|
short |
O |
O |
O |
0 |
NexfiStr |
나클립스 업로더 서버의 URL
Ex - xftp://vod.nexpoly.com/
|
str |
O |
X |
O |
|
NexTube |
넥스튜브 컨텐츠 서버의 URL
Ex - cssp://image.nexpoly.com/
|
str |
O |
X |
O |
|
ProductName |
나클립스 업로더 제품 이름(프로그램 명)을 가져온다.
|
str |
O |
X |
X |
X |
RejectCommand |
이 값을 1로 설정할 경우, 업로딩, 인코딩등 파일 처리 명령을 무효화 시킨다. 파일 처리의 중복을 막을 경우 사용한다.
|
short |
O |
O |
X |
0 |
ServerBytesNow |
파일 업로드시 참조되는 값으로, 현재 서버에 전송된 바이트수
|
long |
O |
X |
X |
|
ServerBytesTotal |
파일 업로드시 참조되는 값으로, 서버에 전송될 파일의 전체 바이트수
|
long |
O |
X |
X |
|
SessionComplete |
사용자가 웹브라우져를 닫거나 다른 페이지로 넘길때, 서버에 저장된 파일정보가 DB에 저장되지 않았다면 서버에 저장된 파일은 Garbage 파일이 될 수 있다.
AutoDelIncompleted Property 값이 1로 세팅되면 이런 파일을 나클립스 업로더 콘트롤이 Unload될때 자동으로 삭제해 준다. (AutoDelIncompleted Property 참조)
만약 정상으로 파일정보를 DB에 기록하였거나 기록할 이전 단계에서 SessionComplete Property 값을 1로 세팅하여 서버에 저장된 파일의 삭제를 막는다.
|
short |
O |
O |
X |
0 |
ShowErrorBox |
에러메세지 창의 Pop-Up 여부를 설정한다. |
short |
O |
O |
O |
1 |
SkinURL |
드래그 앤 드롭(Drag & Drop)할 영역의 백그라운드 이미지. BMP이미지 포맷을 ZIP파일로 압축하여 웹서버에 업로드후, URL 문자열 형태로 설정한다. 예) http://www.nexpoly.com/drag_skin.zip#Version=1,0,0,1
|
str |
X |
X |
O |
|
SourceFileCount |
불러온 미디어 파일의 갯수를 가져온다. |
short |
O |
X |
X |
0 |
SrcAudioBitsRate |
원본 영상파일의 오디오 비트레이트(kbps 단위) |
short |
O |
X |
X |
|
SrcAudioBrMode |
원본 영상파일의 오디오 비트레이트 모드
0:cbr(Constant Bit Rate) 1:abr(Average Bit Rate)
|
short |
O |
X |
X |
|
SrcAudioCDC |
원본 영상파일의 오디오 압축방식
|
str |
O |
X |
X |
|
SrcAudioCH |
원본 영상파일의 오디오 채널 수
|
short |
O |
X |
X |
|
SrcAudioSampRate |
원본 영상파일의 오디오 샘플링 비율(Hz 단위)
|
long |
O |
X |
X |
|
SrcDuration |
원본 영상파일의 재생 시간(초 단위 시간)
|
long |
O |
X |
X |
|
SrcFileBitsRate |
원본 영상파일의 파일 비트레이트(kbps 단위)
|
long |
O |
X |
X |
|
SrcFileCtime |
원본 영상파일의 파일생성 시각
|
str |
O |
X |
X |
|
SrcFileMtime |
원본 영상파일의 파일변경 시각
|
str |
O |
X |
X |
|
SrcFileName |
원본 영상파일의 파일명
|
str |
O |
X |
X |
|
SrcFileSize |
원본 영상파일의 파일 크기
|
double |
O |
X |
X |
|
SrcMediaType |
원본 영상파일의 동영상 형식
WMA_MEDIA 0x01 / WMV_MEDIA 0x02 / AVI_MEDIA 0x03 / MPG_MEDIA 0x04 / MP3_MEDIA 0x05
MP4_MEDIA 0x06 / OGG_MEDIA 0x07 / OGM_MEDIA 0x08 / MKV_MEDIA 0x09 / M4A_MEDIA 0x0A / M4V_MEDIA 0x0B / FLV_MEDIA 0x0C
|
short |
O |
X |
X |
|
SrcNdxes |
원본 영상파일의 프레임 인덱스 갯수(AVI, WMV only)
|
short |
O |
X |
X |
|
SrcVideoBitsRate |
원본 영상파일의 비디오 비트레이트
|
short |
O |
X |
X |
|
SrcVideoBrMode |
원본 영상파일의 비디오 비트레이트 모드
STREAM_CBR 1 / STREAM_VBR 2
|
short |
O |
X |
X |
|
SrcVideoCDC |
원본 영상파일의 비디오 압축 형식
|
str |
O |
X |
X |
|
SrcVideoFps |
원본 영상파일의 초당 프레임수
|
double |
O |
X |
X |
|
SrcVideoHeight |
원본 영상파일의 비디오 영상의 높이값
|
short |
O |
X |
X |
|
SrcVideoWidth |
원본 영상파일의 비디오 영상의 넓이값
|
short |
O |
X |
X |
|
TempPrefix |
나클립스 업로더 서버에 설정된 임시파일 프리픽스. GenThumb Method의 파라메터로 이 값이 입력된다.(GenThumb Method 참조)
|
str |
O |
X |
X |
|
ThumbCount |
생성할 썸네일 이미지 갯수 (최대 6개 까지만 보임)
|
short |
O |
X |
O |
0 |
TopProgress |
진행바(Progressive Bar)의 위치를 지정한다. 값이 1이 설정될경우 진행바의 위치는 'Drag & Drop Background' 이미지 보다 위쪽에 위치 한다. 0이 설정될 경우 진행바가 아래쪽에 위치한다.
|
short |
O |
X |
O |
0 |
UpdateSupport |
오토레인 업데이트 서버를 통한 프로그램 모듈 자동 업데이트 여부
|
short |
O |
X |
O |
1 |
UserGranted |
웹연동 인증을 통해 나클립스 업로더 서버로 부터 인증되었는지 여부 리턴.
1: 인증됨 / 0: 인증되지 않음
|
short |
O |
X |
X |
|
bg_color |
플러그인의 바탕색 (Plug-in Only)
|
short |
X |
X |
O |
#ffffff |
NACLIPS UPLOADER CONTROL'S EVENTS. |
ReadyToRun() |
나클립스 업로더 콘트롤이 사용가능한 상태일때 발생. 이 이벤트 발생전에 나클립스 업로더 ActiveX 콘트롤은 자동 서버접속 및 프로그램 모듈 업데이트 작업을 수행한다. |
|
StatusChange(short MajorCode, short Ending, short Result, short MinorShort, long MinorLong, BSTR MinorStr) |
나클립스 업로더 콘트롤의 모든 상태변화를 캐스트 한다.
Major 코드 / 엔딩 / 결과 파라메터 값으로 현재 업로더의 현재 상태를 알 수 있다. 예를 들어 이 이벤트가 발생했을때, Major 코드가 0x04(NFXSTS_ENCOMDIA)이며, 엔딩 코드가 1이고 결과 코드가 1이라면 인코딩 작업이 성공적으로 완료되었다는 것을 이벤트로 발생시킨 것이다.
|
MajorCode |
short |
Major 상태 코드
0x01(NFXSTS_UPDATEPK) - 프로그램 모듈 업데이트
0x02(NFXSTS_CONNSERV) - 나클립스 업로더 서버 접속
0x03(NFXSTS_INDXMDIA) - 동영상 정보 분석
0x04(NFXSTS_ENCOMDIA) - 원본 동영상 인코딩
0x05(NFXSTS_UPLOADFI) - 최종 동영상 업로드
0x06(NFXSTS_THUMBWND) - 썸네일 이미지 생성
0x07(NFXSTS_COMPLTFI) - 세션 작업 완료(임시파일 완성)
0x08(NFXSTS_MULTIENC) - 멀티 인코딩 (여러개 파일이 인코딩 될때)
0x09(NFXSTS_MULTIFUP) - 멀티 업로딩 (여러개 파일이 업로딩 될때)
0x0A(NFXSTS_THUMBGEN) - 썸네일 이미지 생성.
0x0B(NFXSTS_CANCELPS) - 진행중인 작업이 취소됨.
0x0C(NFXSTS_UPFISORC) - 원본소스 파일 업로드.
|
Ending |
short |
종료 코드 (0:시작 , 1:종료) |
Result |
short |
결과 코드 (0:실패 , 1:성공) |
MinorShort |
short |
Minor 상태 코드 Short Type. Major 상태 코드의 값에 따라...
0x03(NFXSTS_INDXMDIA)이면, MinorShort 값이 0보다 클경우 분석된 파일 갯수다.
0x04(NFXSTS_ENCOMDIA)이면, MinorShort 값은 인코딩 완료한 파일의 갯수 이다.
0x05(NFXSTS_UPLOADFI)이면, MinorShort 값이 1이면 UploadFileEx 함수를, 0이면 UploadFile함수를 사용중이다.
0x06(NFXSTS_THUMBWND)이면, MinorShort 값이 0보다 작을경우, 썸네일 생성 에러코드 값이다.
0x07(NFXSTS_COMPLTFI)이면, MinorShort 값은 ControlFile 메서드 실행시 입력된 siCmd 파라메터 값이다.
0x08(NFXSTS_MULTIENC)이면, MinorShort 값은 인코딩 완료한 파일의 갯수 이다.
0x0A(NFXSTS_THUMBGEN)이면, MinorShort 값은 불러온 파일들의 순서 값이다.
|
MinorLong |
long |
Minor 상태 코드 Long Type. Major 상태 코드의 값에 따라...
0x04(NFXSTS_ENCOMDIA)이면, MinorLong 값은 마지막으로 인코딩 처리된 파일의 순서값이다.
0x05(NFXSTS_UPLOADFI)이면, MinorLong 값은 마지막으로 업로딩 처리된 파일의 순서값이다.
0x0A(NFXSTS_THUMBGEN)이면, MinorLong 값은 마지막으로 생성된 썸네일 이미지의 순서값이다.
|
MinorStr |
str |
Minor 상태 설명 String Type. Major 상태 코드의 값에 따라...
0x04(NFXSTS_COMPLTFI)이면, MinorStr값은 ControlFile 메써드 실행시 처리된 파일명.
0x04(NFXSTS_THUMBGEN)이면, MinorStr값은 생성된 썸네일 이미지의 파일명 이다.
|
|
EncodingGuage(long Elapsed, long Remain, long Total, short Percent) |
동영상을 인코딩 할때 발생하는 이벤트로, 인코딩 진행 상태를 리턴한다. |
Elapsed |
long |
인코딩 소요 시간 (초단위) |
Remain |
long |
계산된 남은 시간 (초단위) |
Total |
long |
계산된 인코딩 전체 소요시간(소요시간 + 남은시간) |
Percent |
short |
인코딩 진행 백분율 |
|
PacketSend(long SentBytes, long Elepsed, short ChangedSec) |
최종 동영상을 업로드 할때 발생하는 이벤트로, 나클립스 업로더 서버에 전송된 바이트값을 리턴한다. |
SentBytes |
long |
전송된 바이트 수 |
Elepsed |
long |
전송 시작후 지난 시간 |
ChangedSec |
short |
이전에 이 이벤트가 발생한 후 초단위 시간이 변하였는지 여부.
이 값이 1일 경우에만 문서상의 전송량을 업데이트 한다면 1초마다 전송 바이트수를 업데이트 하게 된다.
|
|
ErrorRaised(short div, short code, BSTR description) |
에러가 발생하였을 경우 일어나는 이벤트. |
div |
short |
Autorain 에러 여부.
1: Autorain 모듈 업데이트 중 에러 / 0: 나클립스 업로더 에러
|
code |
short |
에러 코드 |
description |
str |
에러 설명 |
| 경기도 고양시 덕양구 삼원로 83, 1030호(원흥동, 광양프런티어밸리6차 지식산업센터) 넥스폴리테크놀러지. | TEL: 031) 963-9035. Copyright (C) 2024 Nexpoly Technology Inc. All rights reserved.
|
|