속성 (Attributes)

차례

EDNETP_ATTR_VERSION (0)
EDNETP_ATTR_ERROR_CODE (1)
EDNETP_ATTR_STATE (2)
EDNETP_ATTR_MODE (3)
EDNETP_ATTR_CAMERA_TOTAL (4)
EDNETP_ATTR_CAMERA (5)
EDNETP_ATTR_DISPLAY_MODE (6)
EDNETP_ATTR_DISPLAY_RATIO (7)
EDNETP_ATTR_DISPLAY_ACCEL (8)
EDNETP_ATTR_DISPLAY_BORDER (9)
EDNETP_ATTR_MUTE (10)
EDNETP_ATTR_VOLUME (11)
EDNETP_ATTR_ALARM_TOTAL (12)
EDNETP_ATTR_AUDIO_TOTAL (13)
EDNETP_ATTR_AUDIO_NAME (14)
EDNETP_ATTR_STILL_IMAGE_DIR (15)
EDNETP_ATTR_STILL_IMAGE_NAME (16)
EDNETP_ATTR_BACKUP_DIR (17)

속성은 EDNETP_EVENT_ATTR 이벤트를 전송할 때 데이터 항목으로 사용하는 부분입니다. (이벤트 참고) 속성 종류는 정수형 값을 사용하고, (자바스크립트 웹 클라이언트 예제에 포함된 ednetp-const.js 파일에 정의되어 있습니다.) 속성 종류별로 사용하는 데이터는 문자열입니다. 하지만 이벤트의 인자로써 사용할 때의 데이터로서의 속성 종류와 데이터의 조합은 문자열 입니다.

EDNETP_ATTR_VERSION (0)

플러그인 라이브러리의 버전 정보를 확인하기 위해 사용합니다. 이 속성은 값을 읽을 수만 있으며, 데이터는 major_version:minor_version 형식으로, major_version는 주 버전 번호를 의미하며, minor_version은 부 버전 번호를 의미하는 정수 값입니다.

EDNETP_ATTR_ERROR_CODE (1)

마지막에 실행한 액션(action)의 에러 코드를 확인하기 위해 사용합니다. 이 속성은 값을 읽을 수만 있으며, 반환하는 값은 정수형 입니다.

EDNETP_ERROR_NONE (0)

에러가 발생하지 않은 상태

EDNETP_ERROR_RESOLVE (1)

호스트 주소를 얻지(resolve) 못했을 경우

EDNETP_ERROR_CONNECT (2)

호스트에 연결이 실패했을 경우

EDNETP_ERROR_LOGIN (3)

사용자 계정 / 비밀번호 등이 유효하지 않을 경우

EDNETP_ERROR_PERMISSION (4)

접속을 위한 적절한 권한이 없을 경우

EDNETP_ERROR_CONNECTION_LIMIT (5)

이미 너무 많이 연결해 있을 경우

EDNETP_ATTR_STATE (2)

네트워크 연결 상태를 확인하기 위해 사용합니다. 이 속성은 값을 읽을 수만 있으며, 반환하는 값은 정수형입니다. 가질 수 있는 네트워크 연결 상태 값은 다음과 같습니다.

EDNETP_STATE_OFFLINE (0)

호스트에 연결되지 않은 상태

EDNETP_STATE_RESOLVE (1)

호스트 주소를 얻는(resolve)하는 상태

EDNETP_STATE_CONNECT (2)

호스트에 연결 중인 상태

EDNETP_STATE_INIT (3)

세션키 처리 중인 상태

EDNETP_STATE_LOGIN (4)

세션키 처리 성공 후 로그인 시도 중인 상태입니다.

EDNETP_STATE_PREPARE (5)

로그인 성공 후 완전하게 연결되기 직전 준비 상태입니다.

EDNETP_STATE_ONLINE (6)

호스트에 연결된 상태입니다.

EDNETP_ATTR_MODE (3)

현재 동작 모드를 나타냅니다. 정수형으로 사용되며, '0'일 경우 라이브 모드, '1'일 경우 검색 / 재생 모드를 의미합니다.

EDNETP_ATTR_CAMERA_TOTAL (4)

호스트의 카메라 개수를 알기 위해서 사용합니다. 이 속성은 값을 읽을 수만 있으며, 반환하는 값은 정수형입니다.

EDNETP_ATTR_CAMERA (5)

현재 카메라에 해당하는 카메라 번호를 알려고 하거나, 특정 카메라 번호를 현재 카메라로 설정하려고 할 때 사용합니다. 이 속성은 값을 읽거나 설정할 수 있으며, 정수형 값을 사용합니다. 현재 카메라를 특정 카메라 번호로 설정할 때 카메라 번호는 0 부터 시작하기 때문에 설정할 카메라 번호는 호스트 카메라의 개수보다 작아야 합니다.

EDNETP_ATTR_DISPLAY_MODE (6)

화면에서 보여주는 가로, 세로의 카메라의 개수를 알려고 하거나, 원하는 가로, 세로의 카메라 개수로 화면에서 보여주도록 설정하려고 할 때 사용합니다. 이 속성은 값을 읽거나 설정할 수 있으며 문자열 값을 사용합니다. 사용하는 문자열 값은 ROWxCOL 형식으로 각각의 ROW는 가로의 카메라 개수를, COL은 세로 카메라 개수를 의미하는 정수 값이며, 영문 소문자 x를 이용해서 조합합니다. 가로, 세로 카메라 개수는 각각 0보다 커야하며 8보다 작아야 합니다.

EDNETP_ATTR_DISPLAY_RATIO (7)

화면의 비율을 알려고 하거나, 원하는 비율로 화면을 설정하려고 할 때 사용합니다. 이 속성은 값을 읽거나 설정할 수 있으며 정수 값을 사용합니다. 사용할 수 있는 비율 값은 다음과 같습니다.

EDNET_PLUGIN_DISPLAY_RATIO_NORMAL (0)

현재 화면의 비율에 맞게 조정함을 의미합니다.

EDNET_PLUGIN_DISPLAY_RATIO_4_3 (1)

4:3 비율을 의미합니다.

EDNET_PLUGIN_DISPLAY_RATIO_ORIGINAL (2)

영상의 원본 비율을 의미합니다.

EDNETP_ATTR_DISPLAY_ACCEL (8)

영상을 표시할 때 하드웨어의 가속 기능을 사용하는지 여부를 알려고 하거나, 사용 여부를 설정하려고 할 때 사용합니다. 현재 지원하지 않는 기능입니다.

EDNETP_ATTR_DISPLAY_BORDER (9)

화면 테두리 색상 정보를 알려고 하거나, 화면 테두리 색상을 설정하려고 할 때 사용합니다. 이 속성은 값을 읽거나 설정할 수 있으며 문자열 값을 사용합니다. 값은 size:bg_color:selected_color 형식을 가집니다. size는 테두리 두께를 의미하며 0보다 큰 정수형입니다. bg_color는 배경 색상을 의미하며 selected_color는 선택한 부분의 색상을 의미합니다. 이 색상값은 #RRGGBB 형식의 문자열 입니다. RR은 빨강을, GG는 초록을, BB는 파랑을 의미하는 16진수 값입니다.

EDNETP_ATTR_MUTE (10)

음소거 상태 여부를 알려고 하거나, 음소거 여부를 설정하려고 할 때 사용합니다. 이 속성은 값을 읽거나 설정할 수 있으며 정수 값을 사용합니다. 0은 음소거를 사용하지 않음을 의미하며, 1은 음소거를 사용함을 의미합니다.

EDNETP_ATTR_VOLUME (11)

소리 크기를 알려고 하거나, 소리 크기를 설정하려고 할 때 사용합니다. 값은 volume 형식으로, 0 부터 128 사이 값을 볼륨 값으로 사용합니다.

EDNETP_ATTR_ALARM_TOTAL (12)

호스트의 알람 개수를 알기 위해서 사용합니다. 이 속성은 값을 읽을 수만 있으며, 반환하는 값은 정수형입니다.

EDNETP_ATTR_AUDIO_TOTAL (13)

호스트의 오디오 채널 개수를 알기 위해서 사용합니다. 이 속성은 값을 읽을 수만 있으며, 반환하는 값은 정수형입니다. 오디오 채널은 비디오 채널과 달리 없을 수도 있기 때문에 비디오 채널의 개수와 오디오 채널의 개수는 서로 다를 수 있습니다.

EDNETP_ATTR_AUDIO_NAME (14)

오디오 채널 이름을 알려고 하거나, 오디오 채널 이름을 설정하려고 할 때 사용합니다. 이 속성은 값을 읽거나 설정할 수 있으며 문자열 값을 사용합니다.

EDNETP_ATTR_STILL_IMAGE_DIR (15)

그림파일을 저장할 디렉토리를 알려고 하거나, 저장할 디렉토리를 설정 할 때 사용합니다. 사용하는 문자열 값은 drive:directory 형식으로 드라이브명과 디렉토리의 절대경로를 나타냅니다. 기본으로 설정되있는 디렉토리는 바탕화면입니다.

EDNETP_ATTR_STILL_IMAGE_NAME (16)

그림파일의 이름 형식을 알려고 하거나, 설정하려고 할 때 사용합니다. 사용하는 문자열 값은 filename_format 으로 %h(호스트명), %c(카메라번호), %d(날짜), %t(시간) 과 같은 형식을 사용하여 파일 이름을 나타낼 수 있습니다. 기본으로 설정되있는 파일이름 형식은 %h-%c-%d-%t 입니다.

EDNETP_ATTR_BACKUP_DIR (17)

백업파일을 저장할 디렉토리를 알려고 하거나, 설정하려고 할 때 사용합니다. 사용하는 문자열 값은 drive:directory 형식으로 드라이브명과 디렉토리의 절대경로를 나타냅니다. 기본으로 설정되있는 디렉토리는 바탕화면입니다.