GET http://IP-Address:port/prefix/live/media/snapshot/{VIDEOSOURCEID}

{VIDEOSOURCEID} – 세 부분으로 구성된 소스 엔드포인트 ID (비디오 카메라 목록 및 정보 가져오기 참조). 예를 들어, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


파라미터필수설명

w

h

No

w – 프레임 너비, h – 프레임 높이

만약 h와 w 값이 원본 프레임의 크기보다 크다면, 프레임은 원본 크기로 수신됩니다.

너비와 높이를 축소하는 것은 2배, 4배, 8배 등으로만 가능합니다. 지정된 크기가 원본 프레임 크기의 1/2, 1/4 등과 일치하지 않으면, 지정된 값에 가까운 원본 프레임 크기로 나누어 떨어지는 크기로 프레임이 수신됩니다.


crop_x

crop_y

crop_width

crop_height


No

crop_x – 왼쪽 상단 코너로부터의 수평 들여쓰기. 가능한 값은 0에서 1까지이며, 기본값은 0입니다.

crop_y – 왼쪽 상단 코너로부터의 수직 들여쓰기. 가능한 값은 0에서 1까지이며 기본값은 0입니다.

crop_width – 원본 이미지 너비의 비율. 가능한 값은 0에서 1까지이며 기본값은 1입니다.

crop_height – 원본 이미지 높이의 비율. 가능한 값은 0에서 1까지이며 기본값은 1입니다.


기본적으로 스냅샷 업데이트 주기는 30초입니다. 이 값을 변경하려면 NGP_SNAPSHOT_TIMEOUT 시스템 변수를 생성하고 필요한 값을 밀리초 단위로 설정해야 합니다. (부록 9. 시스템 변수 생성 참조).

요청 예시:

원본 해상도로 스냅샷을 받으려면: GET http://IP-Address:port/prefix/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0.

640*480 해상도로 스냅샷을 받으려면: GET http://IP-Address:port/prefix/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480.

스냅샷의 오른쪽 하단 부분을 받으려면: GET http://IP-Address:port/prefix/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?crop_x=0.5&crop_y=0.5&crop_width=0.5&crop_height=0.5.

640*480 해상도로 스냅샷의 오른쪽 하단 부분을 받으려면: GET http://IP-Address:port/prefix/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480&crop_x=0.5&crop_y=0.5&crop_width=0.5&crop_height=0.5.