URL Command List For SC8131 VVTK
URL Command List For SC8131 VVTK
Deleted: 9
Deleted: 16
www.vivotek.com
URL Command Document for All Series
Deleted: 2014
VIVOTEK may make changes to specifications and product descriptions at any time, without notice.
The following is trademarks of VIVOTEK INC., and may be used to identify VIVOTEK products only: VIVOTEK. Other
product and company names contained herein may be trademarks of their respective owners.
No part of this publication may be reproduced or utilized in any form or by any means, electronic or mechanical,
including photocopying and microfilm, without permission in writing from VIVOTEK INC.
Revision History
Deleted: 15
1.0b 2016/03/21 Evan Chen 1. Fixed typo
1.0c 2016/04/28 Evan Chen, 1. Add setting WebSocket port number Deleted: 1.
Eric Fang 2. Modify contents Formatted: List Paragraph,
Numbered + Level: 1 + Numbering
Style: 1, 2, 3, … + Start at: 1 +
Alignment: Left + Aligned at: 0 cm
+ Indent at: 0.63 cm
Deleted: 2.
Deleted: FD8171
Deleted: 3. Remove¶
(1) mpeg4¶
4. Modify ¶
(5M, 2M)¶
server can be easily integrated through URLs. This document provides the supersets of URL commands for
VIVOTEK products.
This section specifies the external HTTP-based application programming interface. The HTTP-based camera
interface provides the functionality to request a single image, to control camera functions (PTZ, output relay etc.),
and to get and set internal parameter values. The image and CGI-requests are handled by the built-in Web server.
2. Style Convention
In URL syntax and in descriptions of CGI parameters, a text within angle brackets denotes a content that is to be
replaced with either a value or a string. When replacing the text string, the angle brackets shall also be replaced.
An example of this is the description of the name for the server, denoted with <servername> in the URL syntax
description below, which is replaced with the string myserver in the URL syntax example, also below.
URL syntax is written with the word “Syntax:" written in bold face followed by a box with the reference syntax as
seen below. The name of the server is written as <servername>. This is intended to be replaced with the name of
the actual server. This can either be a name, e.g., "mywebcam" or "thecam.adomain.net" or the associated IP
Syntax:
http://<servername>/cgi-bin/viewer/video.jpg
Description of returned data is written with "Return:" in bold face followed by the returned data shown in a box.
All data is returned as HTTP formatted, i.e., starting with the string HTTP and line separated with a Carriage Return
Return:
URL syntax examples are written with "Example:" in bold face followed by a short description and a light grey box
CGI parameters are written in lower-case and as one word without any underscores or other separators. When the
CGI request includes internal camera parameters, these parameters must be written exactly as they are named in
the camera or video server. The CGIs are organized in functionally-related directories under the cgi-bin directory.
Syntax:
http://<servername>/cgi-bin/<subdir>[/<subdir>...]/<cgi>.<ext>
[?<parameter>=<value>[&<parameter>=<value>...]]
4. Security Level
0 anonymous Unprotected.
dido, videoin 2. Can control DI/DO, PTZ of the camera. Deleted: camctrl
4 [operator] anonymous, viewer, Operator access rights can modify most of the camera’s
dido, camctrl, operator parameters except some privileges and network options.
6 [admin] anonymous, viewer, Administrator access rights can fully control the camera’s
admin
interfaces.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/anonymous/getparam.cgi?[<parameter>]
[&<parameter>…]
http://<servername>/cgi-bin/viewer/getparam.cgi?[<parameter>]
[&<parameter>…]
http://<servername>/cgi-bin/operator/getparam.cgi?[<parameter>]
[&<parameter>…]
http://<servername>/cgi-bin/admin/getparam.cgi?[<parameter>]
[&<parameter>…]
Where the <parameter> should be <group>[_<name>] or <group>[.<name>]. If you do not specify any
parameters, all the parameters on the server will be returned. If you specify only <group>, the parameters of the
When querying parameter values, the current parameter values are returned.
A successful control request returns parameter pairs as follows:
Return:
Content-Type: text/html\r\n
Context-Length: <length>\r\n
\r\n
<parameter pair>
<parameter>=<value>\r\n
[<parameter pair>]
http://192.168.0.123/cgi-bin/admin/getparam.cgi?network_ipaddress
Response:
Content-Type: text/html\r\n
Context-Length: 33\r\n
\r\n
network.ipaddress=192.168.0.123\r\n
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/anonymous/setparam.cgi? <parameter>=<value>
[&<parameter>=<value>…][&update=<value>][&return=<return page>]
http://<servername>/cgi-bin/viewer/setparam.cgi? <parameter>=<value>
http://<servername>/cgi-bin/operator/setparam.cgi? <parameter>=<value>
each group).
return <return page> Redirect to the page <return page> after the parameter is
(Note: The return page can be a general HTML file (.htm, .html)
Return:
Content-Type: text/html\r\n
Context-Length: <length>\r\n
\r\n
<parameter pair>
<parameter>=<value>\r\n
[<parameter pair>]
Only the parameters that you set and are readable will be returned.
Request:
http://myserver/cgi-bin/admin/setparam.cgi?network_ipaddress=192.168.0.123
Response:
Content-Type: text/html\r\n
Context-Length: 33\r\n
\r\n
network.ipaddress=192.168.0.123\r\n
7. Available parameters on the server
Valid values:
string[<n>] Text strings shorter than ‘n’ characters. The characters “,’, <,>,& are invalid.
string[n~m] Text strings longer than `n’ characters and shorter than `m’ characters. The
domain name[<n>] A string limited to a domain name shorter than ‘n’ characters (eg.
www.ibm.com).
email address [<n>] A string limited to an email address shorter than ‘n’ characters (eg.
mac address A string limited to contain a MAC address without hyphens or colons.
Disable].
<value2>,
<value3>,
integer primary key SQLite data type. A 32-bit signed integer. The value is assigned a unique
text SQLite data type. The value is a text string, stored using the database
NOTE: The camera should not be restarted when parameters are changed.
7.1 system
Group: system
(get/set)
hostname string[64] SC8131 1/6 Host name of server Deleted: Mega-Pixel Network
(Network Camera, Camera
Wireless Network Camera,
Video Server,
led indicators.
>
Kwajalein
Island, Samoa
San_Francisco,
Vancouver
Time, Denver
-281: GMT-07:00 Arizona
Santiago
-140: GMT-03:30
Newfoundland
Buenos Aires,
Georgetown, Greenland
Cape_Verde_IS.
0: GMT Casablanca,
Dublin,
Budapest, Bern
Minsk
Petersburg, Nairobi
Muscat, Baku,
Tbilisi, Yerevan
Ekaterinburg, Islamabad,
Karachi, Tashkent
Sri Jayawardenepura
Yakutsk
Darwin
Canberra, Melbourne,
Marshall Is.
-241,-200,
-201,-160,
-140,-120,
-80,-40,0,
40,41,80,
81,82,83,
120,140,
380,400,48
integer> is non-negative.
with other
“restoreexceptXYZ”
commands. When
combined results.
with other
“restoreexceptXYZ”
commands. When
combined results.
with other
“restoreexceptXYZ”
commands. When
combined results.
with other
“restoreexceptXYZ”
commands. When
combined results.
7.1.1 system.info
Subgroup of system: info (The fields in this group are unchangeable.)
NAME VALUE DEFAULT SECURITY DESCRIPTION
(get/set)
modelname string[40] SC8131 0/7 Internal model name of the Deleted: IB8381
server (eg. IP7139)
extendedmodelname string[40] SC8131 0/7 ODM specific model name of Deleted: IB8381
server (eg. DCS-5610). If it
“modelname”
address>
format:
<MODEL-BRAND-VERSION>
server.
dependent
>
server.
xcount-1)>
7.1.2 system.location
Subgroup of system: location
(get/set)
id of this camera
deviceid string[256] 0 1/6 Location information: Device
id of this camera
Formatted: Normal
7.1.3 system.mvaas
Subgroup of system: mvaas Formatted: Normal
(get/set)
7.2 status
Group: status
(get/set)
(capability.ndi > 0)
(capability.ndo > 0)
connections.
push server
connections.
1 => Active
(capability.nvi > 0)
(get/set)
status)
(get/set)
status)
7.5 security
Group: security
(get/set)
digital output
(capability.ndo > 0)
(capability.ptzenabled > 0
or capability.eptz > 0)
management server
server password
user_i<2~20>_pass password[64] <blank> 7/6 User password Deleted: 1
user_i0_privilege view, admin 6/7 Root privilege
operator,
admin
admin
admin
7.6 network
Group: network
(get/set)
preproces <positive <blank> 6/6 An 32-bit integer, each bit can be set separately as
s integer> follows:
service;
may fail.
settings.
Ex:
”/cgi-bin/admin/setparam.cgi?
network_preprocess=9&network_http_port=555
6& network_rtp_videoport=20480”
pppoe
<product
dependent>
resetip <boolean> 1 6/6 1 => Get ipaddress, subnet, router, dns1, dns2
and dns2.
address> dependent>
address>
address>
address>
address>
address>
address>
7.6.1 802.1x
Subgroup of network: ieee8021x (capability.protocol.ieee8021x > 0)
(get/set)
eap-tls
TLS)
certificate_time String[20] 0 6/7 Certificate installed time. Deleted: 0~20
Represented in EPOCH
certificate_size String[20] 0 6/7 Certificate file size (in bytes) Deleted: 0~20
privatekey_exist <boolean> 0 6/6 Private key installed flag (for
TLS)
Represented in EPOCH
7.6.2 QOS
Subgroup of network: qos_cos (capability.protocol.qos.cos > 0)
(get/set)
dependent>
(get/set)
(capability.naudio > 0)
7.6.3 IPV6
Subgroup of network: ipv6 (capability.protocol.ipv6 > 0)
address setting.
7.6.4 FTP
Subgroup of network: ftp
(get/set)
7.6.5 HTTP
Subgroup of network: http
(get/set)
65535
digest
s0_accessname string[32] video.mjpg 1/6 HTTP server push access name for
stream 1.
(capability.protocol.spush_mjpeg
0)
s1_accessname string[32] video2.mjpg 1/6 HTTP server push access name for
<product stream 2.
dependent> (capability.protocol.spush_mjpeg
1)
s2_accessname string[32] video3.mjpg 1/6 Http server push access name for
<product stream 3
dependent> (capability.protocol.spush_mjpeg
=1 and capability.nmediastream >
2)
viewing.
7.6.6 HTTPS
Subgroup of network: https (capability.protocol.https > 0)
(get/set)
65535
7.6.7 RTSP
Subgroup of network: rtsp (capability.protocol.rtsp > 0)
(get/set)
65535 (capability.protocol.rtsp=1)
viewing.
basic, (capability.protocol.rtsp=1)
digest
stream1.
(capability.protocol.rtsp=1
and capability.nmediastream
> 0)
stream2.
(capability.protocol.rtsp=1
and capability.nmediastream
> 1)
stream3
(capability.protocol.rtsp=1
and capability.nmediastream
> 2)
7.6.7.1 RTSP multicast
(get/set)
239.128.1.99
For n=1,
239.128.1.100,
and so on.
s1:5564
s2:5568
dependent> S2:5570
(get/set)
(get/set)
videoport 1025 ~ 65535 5556 6/6 Video channel port for RTP.
(capability.protocol.rtp_unicast=1)
audioport 1025 ~ 65535 5558 6/6 Audio channel port for RTP.
(capability.protocol.rtp_unicast=1)
7.6.10 PPPoE
Subgroup of network: pppoe (capability.protocol.pppoe > 0)
(get/set)
(get/set)
(capability.protocol.websocket =1)
Formatted: Normal
7.7 IP Filter
Group: ipfilter
(get/set)
address.
concurrent streaming
connection(s).
0 => allow
1 => deny
(Single address:
<ip address>
Network address:
<ip address /
network mask>
Range
address:<start ip
address - end ip
address>)
(get/set)
(capability.videoin.type=2)
value.
and gbain.
1 => color
1(support)
1(support)
1(support)
480
<product
dependent>
(get/set)
(capability.videoin.type=2)
rbgain balance.
indoor=1
outdoor=2
piris_position 1~100 1 1/4 Position of piris
compensation
value.
1 => color
support), 1(support)
external camera; 0
(external), 1(built-in)
1(support)
1(support)
1(support)
1(support)
video.
<product
dependent>
0: rectified
1: side by side
2: single eye
3: depth
3000, 4000
s<0~(m-1)>_h264_ratecont cbr, vbr cbr 1/4 cbr, constant bitrate Deleted: s0:
rolmode vbr, fix quality
Deleted: , smart¶
smart , smart stream
s1: cbr, vbr, smart¶
s<0~(m-1)>_h264_quant 1~5, 3 1/4 Quality of video when
s2: cbr, vbr
99, 100 choosing vbr in
“ratecontrolmode”.
input setting.
quality.
input.
(s<0~(m-1)>_h264_quant
= 99)
(s<0~(m-1)>_h264_quant
= 100)
“ratecontrolmode”.
tream_foreground_quant =
99)
(s<0~(m-1)>_h264_smarts
tream_background_quant =
99)
quality.
s<0~(m-2)>_h264_smartstr 0~368, 0~288 (150,110) 7/7 Left-top corner coordinate of Deleted: 1/4
eam_win_i<0~2>_home the window.
s<0~(m-2)>_h264_smartstr 0~400, 0~320 (100x75) 7/7 Width and height of the Deleted: 1/4
eam_win_i<0~2>_size window.
<product dependent>
input setting.
quality.
input.
(s<0~(m-1)>_mjpeg_quan
t = 99)
(s<0~(m-1)>_mjpeg_quan
t = 100)
s<0~(m-1)>_mjpeg_bitrate 20000~40000 s0: 1/4 Set bit rate in bps when Deleted: 1
000 20000000 choosing cbr in
s1: “ratecontrolmode”.
20000000 Deleted: 1
s1:
framerate
s2:
imagequali
ty Deleted: framerate
wdrc_mode 0~3 0 0/7 WDR enhanced.
Deleted: 1
0: off
Deleted: 4
1: auto
2: always on
2: high
Deleted: ¶
7.8.1.1 Alternative video input profiles per channel ...
In addition to the primary setting of video input, there can be alternative profile video input setting for each
(get/set)
policy schedule schedule 1/4 The mode which the profile is Deleted: day,¶
applied to. night,¶
begintime hh:mm 18:00 1/4 Begin time of schedule mode.
Deleted: night
endtime hh:mm 06:00 1/4 End time of schedule mode.
rbgain balance.
value.
control setting.
control setting.
outdoor
2: always on
2: high
Group: videoinpreview
(get/set)
outdoor
2: high
Group: ircutcontrol
7.10 Image setting per channel (capability.nvideoinprofile > 0)¶
Group: image_c<0~(n-1)> for n channel products NAME
...
NAME VALUE DEFAULT SECURITY DESCRIPTION
Deleted: 1
(get/set)
Formatted Table
brightnesspercent 0~100 0 4/4 Adjust brightnesspercent of
image
percentage when
saturation=100
percentage when
sharpness=100
1:enable
setting
profile_i0_policy schedule schedule 4/4 The mode which the profile is Deleted: day,¶
applied to. night,¶
profile_i0_begintime hh:mm 18:00 4/4 Begin time of schedule mode.
Deleted: night
profile_i0_endtime hh:mm 06:00 4/4 End time of schedule mode.
image
of image
1:enable
Deleted: profile_i0_wdrcstrengt
h
...
Deleted: 2
7.11 Image setting for preview
Group: imagepreview_c<0~(n-1)> for n channel products
(get/set)
mode settings.
mode settings.
when saturation=100
mode settings.
mode settings.
when sharpness=100
1:enable
Group: imagepreview
(get/set)
rbgain
setting.
setting.
Deleted: 3
7.12 Exposure window setting per channel
Group: exposurewin_c<0~(n-1)> for n channel products
(get/set)
mode auto, custom, blc auto 4/4 The mode indicates how to decide
the exposure.
exclusive window.
1: Indicate inclusive.
window.
win_i<0~9>_size (0~400, 0~320) (100x75) 4/4 Width and height of the window.
(get/set)
i<0~(m-1)>_mode auto, custom, blc auto 4/4 only one exposure window.
exclusive window.
0: Indicate exclusive.
i<0~(m-1)>_win_i<0~9>_policy 0~1 0 4/4
1: Indicate inclusive.
DyndnsCustom, (dynamic)
CustomSafe100 =>
stname
customsafe100)
Deleted: 8
7.14 Express link
Group: expresslink
(get/set)
state onlycheck, badnetwork 6/6 Camera will check the status of network
checkonline,
badnetwork
url string[64] NULL 6/6 The url user define to link to camera Deleted: 3
Deleted: 9
7.15 UPnP presentation
Group: upnppresentation
NAME VALUE DEFAULT SECURITY DESCRIPTION
(get/set)
presentation service.
Deleted: 20
7.16 UPnP port forwarding
Group: upnpportforwarding
(get/set)
forwarding service.
used internally.
Deleted: 21
7.17 System log
Group: syslog
(get/set)
1025~65535
importance of the
information:
0: LOG_EMERG
1: LOG_ALERT
2: LOG_CRIT
3: LOG_ERR
4: LOG_WARNING
5: LOG_NOTICE
6: LOG_INFO
7: LOG_DEBUG
setting.
0: disable
1: Show log of parameter
internal.
Deleted: 22
7.18 SNMP
Group: snmp (capability.snmp > 0)
(get/set)
for enable
for enable
password
Deleted: 23
7.19 Layout configuration
Group: layout (New version)
om
vivotek logo
logo
1 -> Visible
themes.
4: Custom definition.
d area.
configuration area.
Deleted: 4
7.20 Privacy mask
Group: privacymask_c<0~(n-1)> for n channel product
(get/set)
(get/set)
integer>
<positive
integer>
<positive
integer>
<positive
integer>
<positive
integer>
integer>
integer>
integer>
<positive
integer>
nmediastream <positive 3 0/7 Number of media stream per channels. Deleted: nvideoout
...
integer>
integer>
<positive
integer>
integer>
0(external), 1(built-in)
support), 1(support)
support), 1(support)
1(external)
event/control transfer.
joystick <boolean> 0 0/7 Indicate whether to support joystick control. Deleted: 1
protocol_https < boolean > 1 0/7 Indicate whether to support HTTP over SSL.
n integer> connections.
_ multicast.
scalable
_ multicast.
backchannel
MJPEG.
2 => CMOS
videoin_c0_nmode <Integer> 1 0/7 Indicate how many video modes supported Deleted: 2
by this channel.
ec positive stream.
focus, etc.
-: N/A
name
>_binning mode.
0: No binning
1: 2x2 binning
available 1280x480
Deleted: 1920
videoin_c0_mode0_nre <positive 3 0/7 Available resolutions list.
Deleted: 7
solution integer>
videoout_codec <a list of the ntsc 0/7 Available codec list. esolution
...
available codec
types
separated by
commas)
<product
dependent>
cancellation.
microphone input.
audio_extmic <boolean> 1 0/7 Indicate whether to support external
microphone input.
input.
audio_extmic.)
output.
audioin_codec aac4, g711, aac4, g711, 0/7 Available codec list for audio input.
g726 g726
<product
dependent>
<product
dependent>
and /cgi-bin/viewer/camctrl.cgi
UART transfer.
Both
802.11b+.
wireless_s802dot11g <boolean> 0 0/7 Indicate whether to support wireless
802.11g.
802.11n.
network
ble supported.
supported.
<positive
integer>
<positive
integer>
recording.
recording.
(TCVV<->TCXX is excepted)
integer>
eptz 0, <positive 0 0/7 A 32-bit integer, each bit can be set Deleted: 3
integer> separately as follows:
integer>
analysis
caching stream.
detection.
media_totalspace <positive 35000 0/7 Available memory space (KB) for media.
integer>
media_snapshot_sizep <positive 1250 0/7 Maximum size (KB) of one snapshot image.
ersecond integer>
ze integer>
ngth integer>
Deleted: 9
image_ c0_wdrc <boolean> 1 0/7 Indicate whether to support WDR enhanced.
reduction.
c0_remotefocus
Deleted: ¶
Group: event_customtaskfile_i<0~2>
(get/set)
entry.
Deleted: 7
7.23 Event setting
Group: event_i<0~2>
(get/set)
tampering,
triggerstatus String[40] trigger 6/6 The status for event trigger.
Deleted: ¶
exttriggerstatus String[40] <blank> 6/6 The status for event trigger. “tampering” = Tamper
detection.
exttriggerstatus3 String[40] <blank> 6/6 The status for event trigger. Deleted: ¶
di 0~3 1 6/6 Indicate the source id of di trigger.
Deleted: "volalarm" = Audio
This field is required when trigger
detection¶
condition is “di”.
"pir" = Passive infrared sensor
One bit represents one digital input.
trigger¶
The LSB indicates DI 0.
(capability.npir>0)
mdwin 0~7 0 6/6 Indicate the source window id of
motion detection.
condition is “md”.
detection is enabled.
vi 0~7 0 6/6 Indicate the source id of vi trigger.
condition is “vi”.
0: not select
1: select
0: not select
1: select
condition is “seq”.
bit1 = Friday
bit2 = Thursday
bit3 = Wednesday
bit4 = Tuesday
bit5 = Monday
bit6 = Sunday
66.
always on)
>_enable output.
>_duration in seconds.
action_goto_enable <Boolean> 0 6/6 Enable/disable ptz goto preset
action_goto_name string[40] <blank> 6/6 Specify the preset name that ptz goto
SD card.
network is disconnected.
nable
Deleted: 8
7.24 Server setting for event action
Group: server_i<0~4>
(get/set)
Deleted: 9
7.25 Media setting for event action
Group: media_i<0~4> (media_freespace is used internally.)
(get/set)
videoclip,
recordmsg
media_i0=> Snapshot1_
media_i1=> Snapshot2_
media_i2=> Snapshot3_
media_i3=> Snapshot4_
media_i4=> Snapshot5_
0 = Do not add.
images.
recording in seconds.
seconds.
videoclip_maxsize 50 ~ 8192 500 6/6 Maximum size of one video clip file in
Kbytes.
Deleted: 30
7.26 Recording
Group: recording_i<0~1>
(get/set)
schedule
on.
scheduled.
server (server_i0~i4).
bit1 = server_i1.
bit2 = server_i2.
bit3 = server_i3.
bit4 = server_i4.
value is 21.
bit1 = Friday
bit2 = Thursday
bit3 = Wednesday
bit4 = Tuesday
bit5 = Monday
bit6 = Sunday
66.
always on)
cyclesize 200~ 100 6/6 The maximum size for cycle recording
recording size.
0~4 data.
card).
storage.
Deleted: 31
7.27 HTTPS
Group: https (capability.protocol.https > 0)
(get/set)
HTTP.
policy <Boolean> 0 6/6 If the value is 1, it will force
HTTPS connection
certificate manually.
0 = Not installed
1 = Active
information.
certificate information.
certificate information.
organizationname string[64] VIVOTEK Inc. 6/6 Organization name in the Deleted: Vivotek.Inc
certificate information.
unit string[64] VIVOTEK Inc. 6/6 Organizational unit name in the Deleted: Vivotek.Inc
certificate information.
com information.
Deleted: 32
7.28 Storage management setting
Currently it’s for local storage (SD, CF card)
(get/set)
be deleted.
autocleanup_maxage 1~ 7 6/6 To specify the expired days for Deleted: <positive integer>
automatic clean up.
Deleted: 33
7.29 Region of interest
Group: roi_c<0~(n-1)> for n channel product, and m is the number of streams which support ROI.
(capability.eptz > 0)
(get/set)
Deleted: 4
7.30 ePTZ setting
Group: eptz_c<0~(n-1)> for n channel product. (capability.eptz > 0)
(get/set)
Group: eptz_c<0~(n-1)>_s<0~(m-2)> for n channel product and m is the number of streams which support
patrolseq string[120] <blank> 1/4 The patrol sequence of ePTZ. All the
separated by ","
than by setparam.cgi.)
preset.
than by setparam.cgi.)
preset_i<0~19>_size <window size> <blank> 1/7 Width and height of the preset.
than by setparam.cgi.)
modules. Deleted: 0
uploading VADP
modules.
should be saved to SD
upload it.
Group: vadp_module_i<0~(n-1)>
(get/set)
to the module_order.
module_i1~9: <blank>
http://www.vivotek.com
Deleted: 7
7.32 Seamless recording setting
Group: seamlessrecording (capability.localstorage.seamless > 0)
(get/set)
recording.
“manageable” indicates
disable seamless
recording.
connected seamless
streaming.
seamless recording is
or not at present.
(Read only)
streaming ID.
(Read only)
guid<0~2>_id.
(Read only)
Deleted: 8
7.33 Genetec info
Group: genetec
(get/set)
omnicast
omnicast
NAME
...
8. Useful Functions
Drive the Digital Output (capability.ndo > 0)
Note: This request requires Viewer privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/dido/setdo.cgi?do1=<state>[&do2=<state>]
[&do3=<state>][&do4=<state>]
Where state is 0 or 1; “0” means inactive or normal state, while “1” means active or triggered state.
Example: Drive the digital output 1 to triggered state and redirect to an empty page.
http://myserver/cgi-bin/dido/setdo.cgi?do1=1
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/dido/getdi.cgi?[di0][&di1][&di2][&di3]
Return:
Content-Type: text/plain\r\n
Content-Length: <length>\r\n
\r\n
[di0=<state>]\r\n
[di1=<state>]\r\n
[di2=<state>]\r\n
[di3=<state>]\r\n
Request:
http://myserver/cgi-bin/dido/getdi.cgi?di1
Response:
Content-Type: text/plain\r\n
Content-Length: 7\r\n
\r\n
di1=1\r\n
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/dido/getdo.cgi?[do0][&do1][&do2][&do3]
Return:
Content-Type: text/plain\r\n
Content-Length: <length>\r\n
\r\n
[do0=<state>]\r\n
[do1=<state>]\r\n
[do2=<state>]\r\n
[do3=<state>]\r\n
Request:
http://myserver/cgi-bin/dido/getdo.cgi?do1
Response:
Content-Type: text/plain\r\n
Content-Length: 7\r\n
\r\n
do1=1\r\n
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/viewer/video.jpg?[channel=<value>][&resolution=<value>]
[&quality=<value>][&streamid=<value>]
If the user requests a size larger than all stream settings on the server, this request will fail.
resolution>
dependent>
The server will return the most up-to-date snapshot of the selected channel and stream in JPEG format. The size
and quality of the image will be set according to the video settings on the server.
Return:
Content-Type: image/jpeg\r\n
Account Management
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/admin/editaccount.cgi?
method=<value>&username=<name>[&userpass=<value>][&privilege=<value>]
[&privilege=<value>][…][&return=<return page>]
method Add Add an account to the server. When using this method, the
Delete Remove an account from the server. When using this method,
edit Modify the account password and privilege. When using this
userpass <value> The password of the new user to add or that of the old user to
Return <return page> Redirect to the page <return page> after the parameter is
System Logs
Note: This request require Administrator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/admin/syslog.cgi
Return:
Content-Type: text/plain\r\n
\r\n
<system log information>\r\n
Upgrade Firmware
Note: This request requires Administrator privileges.
Method: POST
Syntax:
http://<servername>/cgi-bin/admin/upgrade.cgi
Post data:
\r\n
Server will accept the file named <file name> to upgrade the firmware and return with <return page> if indicated.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/camctrl/eCamCtrl.cgi?channel=<value>&stream=<value>
(Move the center of image to the coordination (x,y) based on resolution or videosize.)
[ [&speedpan=<value>][&speedtilt=<value>][&speedzoom=<value>][&speedapp=<value>] ] – Set
speeds
[&return=<return page>]
Example:
http://myserver/cgi-bin/camctrl/eCamCtrl.cgi?channel=0&stream=0&move=right
http://myserver/cgi-bin/camctrl/eCamCtrl.cgi?channel=0&stream=1&vx=2&vy=2&vz=2
http://myserver/cgi-bin/camctrl/eCamCtrl.cgi?channel=0&stream=1&x=100&y=100&
videosize=640x400&resolution=640x400&stretch=0
PARAMETER VALUE DESCRIPTION
up Move up.
zooming wide or tele Zoom without stopping for larger view or further view with zs
vy <integer>
videosize <window size> The size of plug-in (ActiveX) window in web page
stretch <boolean> 0 indicates that it uses resolution (streaming size) as the range
return <return page> Redirect to the page <return page> after the parameter is
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/camctrl/eRecall.cgi?channel=<value>&stream=<value>&
recall=<value>[&return=<return page>]
recall Text string less than 40 One of the present positions to recall.
characters
return <return page> Redirect to the page <return page> after the parameter is
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/operator/ePreset.cgi?channel=<value>&stream=<value>
[&addpos=<value>][&delpos=<value>][&return=<return page>]
40 characters>
delpos <Text string less than Delete preset location from the preset list.
40 characters>
return <return page> Redirect to the page <return page> after the parameter is
IP Filtering
Note: This request requires Administrator access privileges.
Method: GET/POST
http://<servername>/cgi-bin/admin/ipfilter.cgi?type[=<value>]
http://<servername>/cgi-bin/admin/ipfilter.cgi?method=add<v4/v6>&ip=<ipaddress>[&index=<value>]
[&return=<return page>]
http://<servername>/cgi-bin/admin/ipfilter.cgi?method=del<v4/v6>&index=<value>[&return=<return
page>]
return <return page> Redirect to the page <return page> after the parameter is
http://<servername>/cgi-bin/admin/ipfilter.cgi?type[=<value>]
http://<servername>/cgi-bin/admin/ipfilter.cgi?method=add<v4/v6>&ip=<ipaddress>[&index=<value>]
[&return=<return page>]
http://<servername>/cgi-bin/admin/ipfilter.cgi?method=del<v4/v6>&index=<value>[&return=<return
page>]
return <return page> Redirect to the page <return page> after the parameter is
Method: GET/POST
Syntax:
http://<servername>/<network_rtsp_s<0~m-1>_accessname>
“network_accessname_<0~(m-1)>” is the accessname for stream “1” to stream “m”. Please refer to the
When using scalable multicast, Get SDP file which contains the multicast information via HTTP.
Syntax:
http://<servername>/<network_http_s<0~m-1>_accessname>
For RTSP (MP4), the user needs to input the URL below into an RTSP compatible player.
rtsp://<servername>/<network_rtsp_s<0~m-1>_accessname>
For details on streaming protocol, please refer to the “control signaling” and “data format” documents.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/viewer/senddata.cgi?
number>
data <hex decimal The <hex decimal data> is a series of digits from 0 ~ 9, A ~ F.
data>]
flush yes,no yes: Receive data buffer of the COM port will be cleared before
read.
read 1 ~ 128 The data length in bytes to read. The read data will be in the
return page.
Return:
Content-Type: text/plain\r\n
\r\n
Syntax:
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=<cmd_type>[&<parameter>=<value>…]
Command: search
Ex. mediaType=’motion’
Ex. mediaType=’videoclip’
Ex. resolution=’800x600’
1: file is locked.
Indicate the event trigger time. (not the file created time)
operation.
23:59:59’ is to search for records from the start of Jan 1st 2008
matched records.
Moreover, to search for a specific time period, you can use “TO” connector.
Ex. To search records triggered by motion or di or sequential and also triggered between 2008-01-01 00:00:00 and
2008-01-01 23:59:59.
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=search&triggerType=’motion’+OR+’di’+OR+’seq’&trigge
Command: delete
Ex. label=1
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=delete&label=1&label=4&label=8
Command: update
Ex. label=1
Ex. Update records whose key numbers are 1 and 5 to be locked status.
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=update&isLocked=1&label=1&label=5
Ex. Update records whose key numbers are 2 and 3 to be unlocked status.
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=update&isLocked=0&label=2&label=3
Command: queryStatus
Ex. retype=javascript
Ex. Query local storage status and call for javascript format return message.
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=queryStatus&retType=javascript
Method: GET
Syntax:
http://<servername>/cgi-bin/admin/setvi.cgi?vi0=<value>[&vi1=<value>][&vi2=<value>]
[&return=<return page>]
return <return page> Redirect to the page <return page> after the request is
page.
Examples:
setvi.cgi?vi0=0(10000)1(15000)0(20000)1
No multiple duration.
setvi.cgi?vi3=0
setvi.cgi?vi=1
No VI index is specified.
503 The resource is unavailable, ex. Virtual input is waiting for next state.
Examples:
setvi.cgi?vi0=0(15000)1
setvi.cgi?vi0=1
timeshift_enable=1, timeshift_c<n>_s<m>_allow=1)
Note: This request requires Viewer access privileges.
Syntax:
http://<servername>/<network_http_s<m>_accessname>?maxsft=<value>[&tsmode=<value>&reftime
=<value>&forcechk&minsft=<value>]
For RTSP (MP4 and H264), the user needs to input the URL below into an RTSP compatible player.
rtsp://<servername>/<network_rtsp_s<m>_accessname>?maxsft=<value>[&tsmode=<value>&reftime
=<value>&forcechk&minsft=<value>]
maxsft <positive 0 Request cached stream at most how many seconds ago.
integer>
for 10 seconds.
streams.)
reftime mm:ss The time Reference time for maxsft and minsft.
camera receives (This provides more precise time control to eliminate the
rtsp://10.0.0.1/live.sdp?maxsft=10&reftime=12:30
forcechk N/A N/A Check if the requested stream enables timeshift, feature
minsft <positive 0 How many seconds of cached stream client can accept at
integer> least.
(Used by forcechk)
400 Bad Request Request is rejected because some parameter values are illegal.
415 Unsupported Media Type Returned, if forcechk appears, when minsft is not achievable or the
Syntax:
http://<servername>/videoany.mjpg?codectype=mjpeg[&resolution=<value>&mjpeg_quant=<value>&
mjpeg_qvalue=<value>&mjpeg_maxframe=<value>]
For RTSP (H264), the user needs to input the URL below into an RTSP compatible player.
rtsp://<servername>/liveany.sdp?codectype=h264[&resolution=<value>&h264_intraperiod=<value>&
h264_bitrate=<value>& h264_maxframe=<value>]
<product dependent>
dependent>
setting.
is equal to 0, 99)
mjpeg_maxframe 1~25 (5M mode) 30 Set maximum frame rate in fps (for
h264_intraperiod 250, 500, 1000, 2000, 3000, 1000 Intra frame period in milliseconds.
4000
“h264_ratecontrolmode”.
setting.
equal to 0, 99)
h264_bitrate 20~40000000 8000000 Set bit rate in bps when choosing cbr
in “h264_ratecontrolmode”.
h264_maxframe 1~25 (5M mode) 25 Set maximum frame rate in fps (for
Remote Focus
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/admin/remotefocus.cgi?function=<value>[&direction=<value>]
[&position=<value>][&steps=<value>][&iris]
motor
motor
focal length
length
Edge.
backward
"function=getstatus"
backward.
"function=getstatus"
Method: GET
Syntax:
http://<servername>/cgi-bin/admin/exportDst.cgi
http://<servername>/cgi-bin/admin/export_language.cgi?currentlanguage=<value>
system_info_language_i0 ~ system_info_language_i19.
http://<servername>/cgi-bin/admin/export_backup.cgi?backup
Upload Files
Note: This request requires Administrator privileges.
Method: POST
Syntax:
http://<servername>/cgi-bin/admin/upload_dst.cgi
Post data:
\r\n
http://<servername>/cgi-bin/admin/upload_lan.cgi
Post data:
\r\n
<multipart encoded form data>
http://<servername>/cgi-bin/admin/upload_backup.cgi
Post data:
\r\n
Server will accept the file named <file name> to upload this one to camera.