66
6. API for Sending JPEG/Audio from VN-E4 via UDP _
6.2. List of APIs
(1) Sending JPEG from VN-E4 via RTP/UDP
Format
/api/send?from=video&from.input=data1&from.framesize=data2&from.framerate
=data3&to=network&to.ip=data4&to.port=data5&to.session_id=data6
Example
/api/send?from=video&from.input=1&from.framesize=qvga&from.framerate=15&
to=network&to.ip=225.0.1.1&to.port=20000&to.session_id=12345678
from.input
Specify the video input channel.(1~4)
from.framesize
Specify the frame size. (qvga / vga)
from.framerate
Specify the JPEG frame rate. Selection range is as follows. For a frame rate lower than 1fps, use -. For
example, select -2 for 1/2fps.
VN-E4 and VN-E4U (NTSC)
30, 15, 10, 7.5, 6, 5, 3, 2, 1, 0, -2, -3, -5, -10, -15, -20, -30, -60
VN-E4E (PAL)
25, 12.5, 8.3, 6.25, 5, 4.1, 3, 2, 1, 0, -2, -3, -5, -10, -15, -20, -30, -60
Only 1 frame of the JPEG data will be sent when this is specified as 0.
to.ip
Specify the destination IP address.
to.port
Specify the destination port number.
to.session_id
Specify the client IP number. VN-E4 will register this number and accept the client with the same API (stop).
session_id=* that the stop command supports will not be accepted.
Interpretation
Send JPEG from VN-E4 via RTP/UDP. JPEG data with a 12-byte RTP header will be sent out repeatedly.
Allowed users
admin, operator
Example of Response
HTTP/1.1 200 OK<CRLF>
Date: Fri, 13 MAY 2005 07:33:12 GMT<CRLF>
Server: VN-E4 API Server/1.0.0<CRLF>
Connection: Keep-Alive<CRLF>
content-type: text/plain<CRLF>
Connection: Keep-Alive<CRLF>
Keep-Alive: timeout=5, max=5<CRLF>
x-vne4_response:
from=video&from.input=1&from.framesize=qvga&from.framerate=15&to=network&
to.ip=225.0.1.1&to.port=20000&to.session_id=12345678<CRLF><CRLF>
200 OK<CRLF>
Restrictions
The total number of RTP/UDP that may be sent by VN-E4 is 10 streams (including both JPEG and audio). A
"503 Service Unavailable" message will be returned in the body of the response when an 11th RTP/UDP
sending request is received.
Example of response when an 11th sending request is received:
HTTP/1.1 200 OK<CRLF>
Date: Fri, 13 MAY 2005 07:33:12 GMT<CRLF>
Server VN-E4 API Server/1.0.0<CRLF>
Connection: Keep-Alive<CRLF>
content-type: text/plain<CRLF>
Connection: Keep-Alive<CRLF>
Keep-Alive: timeout=5, max=5<CRLF>
x-vne4_response:
from=video&from.input=1&from.framesize=qvga&from.framerate=15&to=network&
to.ip=225.0.1.1&to.port=20000&to.session_id=12345678<CRLF><CRLF>
503 Service Unavailable<CRLF>
6.2. List of APIs