Loading page 2...
Loading page 3...
Loading page 4...
VIVOTEK
User's Manual - 5
Package Contents
■ SD9394
■ Wall Mount Bracket / Screws / waterproof round cap
■ Screws and anchors / Alignment Sticker / T10 and T25 L-wrench
■ Quick Installation Guide
■ RJ45 Ethernet penetration cap, Terminal blocks for DI/DO, audio, and AC/DC/GND wires.
Symbols and Statements in this Document
i
INFORMATION:
provides important messages or advices that might help prevent inconvenient
or problem situations.
NOTE
: Notices provide guidance or advices that are related to the functional integrity of the
machine.
Tips
: Tips are useful information that helps enhance or facilitae an installation, function, or
process.
WARNING: or IMPORTANT:
: These statements indicate situations that can be dangerous or
hazardous to the machine or you.
Electrical Hazard
: This statement appears when high voltage electrical hazards might occur
to an operator.
IMPORTANT:
WARNING:
These devices(IR LED) emit highly concentrated infrared light, which view angle(range) is
smoothly varied depending on operation mode.
To avoid risk of eye injury, please do
not look directly at the LEDs at a near distance and remember to use the
camera live view to check if the IR illumination is active!
Use appropriate shielding or eye protection.
赤外線の警告を追加した方が良い
1. 本製品は赤外線を放射します
2. 適切な遮蔽物または眼を保護する器具を使用してください
Below are the requirements for powering the the speed dome:
Power source Power Consumption
AC 24V & DC 48V Max. 51W ( Heater & Fan on );Max 45W ( Heater & Fan o )
High power PoE
(IEEE 802.3 BT
class 6)
Max. 51W ( Heater & Fan on );Max 45W ( Heater & Fan o ), using VIVOTEK's AP-
GIC-011A-095
■ The DI/DO and audio wires are user-supplied and separately purchased.
■ An M20 waterproof cable gland can be necessary and is user-supplied.
VIVOTEK
6 - User's Manual
NOTE:
Camera Hardware Preventative Maintenance:
1. Visual inspection of all major components including accessories, cabling and connections
where accessible for signs of deterioration or damage.
2. Check and clean cameras, lenses and housings inside and out as needed.
• Please do not scratch, damage, or leave fingerprints on the dome/front cover and/or lens
because this may decrease image quality.
• For general cleaning of dirty areas, it is suggested to use compressed air to remove dust
and/or other debris in order not to damage the on-board components.
• In order to clean oil stains, it is recommended to use a spray-type decomposing cleaner
(absolutely avoid reciprocating wipes on the surface). After the oil has decomposed, spray
it with water, dry with air, and/or absorb water with a cotton cloth or a soft cloth (dab, please
avoid wiping).
• Do not use harsh detergents, gasoline, benzene or acetone, etc. to clean as they may
deform or cause damage to the product. Also, excessive cleaning could damage the surface.
3. Check images for correct eld of view (pan, tilt and zoom focus) and adjust as necessary.
4. Check and replace the Micro SD memory card as needed.
• Stop edge recording before removing the Micro SD memory card.
• Make sure that the Micro SD memory card is right side up and do not insert it with force,
otherwise it may be damaged.
• When it is raining or the humidity is high, insertion or ejection of the Micro SD memory card
is not recommended.
5. Disassembly of the dome/front cover carries the risk of internal dew condensation, so please
remember to replace the desiccant bags on the inside of the cameras before reassembly.
6. Check that the camera view has not been blocked by obstacles and that you can see the
property perimeter clearly.
7. Make sure the interiors of cameras and accessories, like mounting kits and/or enclosures,
are clean and dry.
8. Make sure cameras are securely attached to the wall/ceiling/mounting kits.
IMPORTANT:
1. Please contact VIVOTEK's certied dealers for power adapters.
2. Installation and maintenance service should only be performed by qualied technicians.
3. If powered by a power adapter, the adapter should be properly grounded.
4. The power cord must be connected to a socket or outlet with a ground connection.
VIVOTEK
User's Manual - 7
IMPORTANT:
1. The product must be installed and protected in a location that is not easily accessible, and
is away from impacts or heavy vibration. For example, at the location where the surveillance
cameras are looking down or installed at high positions such as on a wall, or at least 3 meters
above the ground.
2. The camera should be installed at least 10 centimeters away from the eave of a building.
3. If powered by a power adapter, the adapter should be properly grounded.
4. Maintenance and repair work must always be carried out by qualied technical personnel.
5. Disconnect power from the unit when performing a maintenance task.
6. Please contact VIVOTEK's certied dealers for power adapters.
IMPORTANT:
1. The camera is only to be connected to PoE networks without routing to outside plants.
2. For PoE connection, use only UL listed I.T.E. with PoE output.
1. La caméra ne doit être raccordée qu’à des réseaux PoE, sans routage vers des installations
extérieures.
2. Pour les raccordements PoE, utilisez uniquement un équipement de TI homologué UL, avec
une sortie PoE.
Use the camera only with a DC power supply that is UL listed, and limited power source (LPS)
certied. The power supply should bear the UL listed and LPS marks. The power supply should
also meet any safety and compliance requirements for the country of use.
n’utilisez la caméra qu’avec un bloc d’alimentation CC homologué UL, ainsi qu’avec
une alimentation limitée (LPS) certifiée. Le bloc d’alimentation doit porter les indications
d'homologation UL et LPS. Il doit également répondre aux exigences en matière de sécurité et
de conformité relatives au pays d’utilisation.
IMPORTANT:
The product shall be grounded properly with a screw type of 3.5mm min. for protective
earthing terminal, and connected using a green-yellow protective earthing conductor with 20
AWG min.
Loading page 8...
Loading page 9...
VIVOTEK
User's Manual - 10
Inner View
DI/DO
NL 3.5
IN1 IN2
GND
ALARM IN
COM NCNO
ALARM OUT
AC/DC & GND
Ethernet
AC/DC/GND
I/O combo connector
Ethernet port
Loading page 11...
Loading page 12...
Loading page 13...
VIVOTEK
14 - User's Manual
4. Disassemble the wall-mount bracket using the T25 wrench.
1. IO wires are user-supplied.
2. Avoid touching the circuit boards to prevent
damage by electro static discharge.
3. Use CAT5e, CAT6 cables only.
NOTE:
T25
5. Route your I/O combo and Ethernet cables through the drill hole. Secure the bracket to wall
using the included screws.
VIVOTEK
User's Manual - 15
6. Mount the bracket arm to the bracket by sliding the rivets on the sides through the small
openings at the bottom. The bracket should hole the arm in place. Tighten the 2 screws at the
top.
7. Remove the silicon seals from the bracket. Remove the tip of the silicon seal. Insert the RJ45
connector of your Ethernet cable into the penetration cap.
5 ~ 8mm
VIVOTEK
16 - User's Manual
8. Insert and pass the cable through the silicon seal.
If grommets are damaged, replace them with new ones.
9. When installing the silicon grommet, make sure the cable is slightly pulled back to the outside.
Do not leave the rim of the seal jammed in the inside of the seal. You can temporarily ignore
this until you are ready to mount the camera.
8cm
VIVOTEK
User's Manual - 17
10.Install the silicon seal to the original opening on the bracket.
Optional, separately-purchased IO CABLE AO-008
If you purchased the I/O combo cable, the cable will come with the silicon seal.
VIVOTEK
18 - User's Manual
11. If you need to connect DI/DO devices or AC/DC power source, pass the wires through the
gommet.
Wire gauge:
0.7~1.2mm
AWG: 19~16
AC/DC wires
VIVOTEK
User's Manual - 19
12. Before you install the camera and if you prefer onboard storage, open the panel cap on the
back of the camera.
13. Install a MicroSD card if preferred.
1
2
3
4
5
6
1. PWR LED
2. Network LED
3. Restore default
4. Debug serial port
5. MicroSD socket
6. USB
256
GB
10
I
1
USB: reserved
T10
VIVOTEK
20 - User's Manual
14. Connect power or I/O wires to the terminal blocks.
NL 3.5
IN1 IN2
GND
ALARM IN
COM NCNO
ALARM OUT
OUT GND
IN
AUDIO
AB
RS485
Ground
AC/DC
No polarity
When installing the camera, connect the safety tether wire rst.
VIVOTEK
User's Manual - 21
15. Install the camera to the wall bracket by aligning with the alignment mark on the bracket.
x3
1
2
16. Turn the camera clockwise until the second alignment mark on the left aligns with that on the
bracket. Secure the connection by fastening 3 screws from the top.
VIVOTEK
22 - User's Manual
17. Connect the Ethernet cable and the DI/DO and AC/DC terminal blocks to the top of camera.
DI/DO
NL 3.5
IN1 IN2
GND
ALARM IN
COM NCNO
ALARM OUT
AC/DC & GND
Ethernet
T25
18. Install the top cover of the wall-mount bracket.
VIVOTEK
User's Manual - 23
19. Remove the protective sheet in front of the lens.
VIVOTEK
24 - User's Manual
An example is shown below using VIVOTEK’s AT-CAB cabinet.
Camera ground wire
Connect the ground wire to the copper screw hole on the cabinet door.
Connect all ground wires (including those from the surge protectors) to one position on the
cabinet door, to the terminal block, and then to the external ground.
Loading page 25...
VIVOTEK
26 - User's Manual
AM-118
AM-116/117
3/4”
AM-529
The camera can also be mounted through a
pendant mount combination as shown below.
The rest of the installation prcedure is the same
as described above.
Pendant Mount
VIVOTEK
User's Manual - 27
Mechanical Dimensions
Shown below are the dimensions of the wall mount bracket and its mounting holes:
You can nd the installation instructions on VIVOTEK’s website for other options such as para-
pet mount: http://www.vivotek.com/web/product/accessories.aspx
Loading page 28...
Loading page 29...
VIVOTEK
30 - User's Manual
General Connection
LC
AC-to-DC power
100~240 VAC IN
48 ~ 56V DC
Chassis Ground
+
-
+
-
AC-to-DC power
100~240 VAC IN
When using a non-PoE switch
Use a High Power PoE power injector (separately purchased) capable of 60W output or higher
to connect between the Network Camera and a non-PoE switch. Sucient power is required for
low temperature conditions when the onboard heater is activated.
Non-PoE Switch
High Power PoE
Power Injector
Connect the power wires to a DC 48V power adaptor (user-supplied). The DC 48V adapter
can drive the camera and the onboard heater.
You can connect both power sources for redundancy in power supply.
Power over Ethernet (High Power PoE)
AC 24V 2.3A
Adapter (Separately
purchasedied)
UPoE Switch (60W output)
and / or
Internet connection with static IP
Choose this connection type if you are required to use a static IP for the Network Camera.
Please refer to LAN on page 95 for details.
Internet connection via PPPoE (Point-to-Point over Ethernet)
Choose this connection type if you are connected to the Internet via a DSL Line. Please refer to
PPPoE on page 96 for details.
Loading page 31...
VIVOTEK
User's Manual - 32
0002D1730202
IB8360-W 192.168.4.151 00-02-D1-73-02-02
CC9381-HV
Network Camera
Model No: SDXXXX
Made in Taiwan
This device complies with part 15 of the FCC rules. Operation is subject to the following two conditions:
(1)This device may not cause harmful interference, and
(2) this device must accept any interference received, including interference that may cause undesired operation.
Pat. 6,930,709
MAC:0002D1730202
R o HS
22-3. The program will search for all VIVOTEK network devices on the same LAN.
22-4. After a brief search, the installer window will prompt. Click on the MAC and model
name that matches the one printed on the product label. You can then double-click on
the address to open a management session with the Network Camera.
Forceful Password Conguration
23. The first time you log in to the camera, the firmware will prompt for a password
conguration for security concerns.
23-1. Since your camera is used for the rst time, there is no password.
22-2. Enter the combination of alphabetic and numeric characters to fulll the password
strength. requirement. The default name for the camera administrator is “root”, and can
not be changed.
VIVOTEK
User's Manual - 33
Some, but not all special ASCII characters are supported: !, $, %, -, ., @, ^, _, and ~.
You can use them in the password combination.
23-3. Another prompt will request for the password you just congured. Enter the password
and then you can start congure your camera and see the live view.
VIVOTEK
34 - User's Manual
Cybersecurity
Once you open the web console, enter
Configuration
>
Applications
>
Package
management
, and click on Trend Micro IoT Security. Turn on the protection to fend o cyber
attacks.
In here, you can let the camera automatically update the virus codes or manually update the
virus codes.
VIVOTEK
User's Manual - 35
Ready to Use
1. A browser session to the Network Camera should prompt as shown below.
2. You should be able to see live video from your camera. You may also install the 32-channel
VSS recording software from VIVOTEK's website in a deployment consisting of multiple
cameras. For its installation details, please refer to its related documents.
•
Currently the Network Camera utilizes a
32-bit ActiveX plugin
. You CAN NOT open a
management/view session with the camera using a 64-bit IE browser.
•
If you encounter this problem, try execute the Iexplore.exe program from C:\Windows\
SysWOW64. A 32-bit version of IE browser will be installed.
•
On Windows 7, the 32-bit explorer browser can be accessed from here: C:\Program Files
(x86)\Internet Explorer\iexplore.exe
•
If you experience compatibility issues between the plug-in control, you may try to uninstall
the Camera Stream Controller located in: C:/Program Files (x86)/Camera Stream Controller.
IMPORTANT:
VIVOTEK
36 - User's Manual
Accessing the Network Camera
This chapter explains how to access the Network Camera through web browsers, RTSP players,
3GPP-compatible mobile devices, and VIVOTEK recording software.
Using Web Browsers
Use the Shepherd software to access the Network Cameras on LAN.
If your network environment is not a LAN, follow these steps to access the Netwotk Camera:
1. Launch your web browser (e.g., Edge, or Chrome).
2. Enter the IP address of the Network Camera in the address eld. Press
Enter
.
3. Live video will be displayed in your web browser.
4. If it is the rst time installing the VIVOTEK network camera, an information bar will prompt as
shown below. Follow the instructions to install the required plug-in on your computer.
30x
VLC player supports H.265/H.264/MPEG-4/MJPEG, and all audio codecs supported by VIVOTEK’s cam-
eras.
NOTE:
Loading page 37...
VIVOTEK
38 - User's Manual
Using RTSP Players
To view the streaming media using RTSP players, you can use one of the following players that
support RTSP streaming.
VLC media player
VLC media player
mpegable Player
pvPlayer
As most ISPs and players only allow RTSP streaming through port number 554, please set the
RTSP port to 554. For more information, please refer to RTSP Streaming on page 103.
For example:
4. The live video will be displayed in your player.
For more information on how to configure the RTSP access name, please refer to RTSP
Streaming on page 103 for details.
rtsp://192.168.5.151:554/live1s1.sdp
1. Launch the RTSP player.
2. Choose File > Open URL. A URL dialog box will pop up.
3. The address format is rtsp://<ip address>:<rtsp port>/<RTSP streaming access name for
stream1 or stream2>
Loading page 39...
VIVOTEK
40 - User's Manual
Using VIVOTEK Recording Software
The VSS recording software allows simultaneous monitoring and video recording for multiple
Network Cameras. Please install the recording software; then launch the program to add the
Network Camera to the Channel list. For detailed information about how to use the recording
software, please refer to the user’s manual of the software or download it from http://www.
vivotek.com.
Tips:
1. If you encounter problems with displaying live view or the onscreen plug-in control, you may try
to remove the plug-ins that might have been installed on your computer. Remove the following
folder: C:\Program Files (x86)\Camera Stream Controller\.
2. If you forget the root (administrator) password for the camera, you can restore the camera
defaults by pressing the reset button for longer than 5 seconds.
3. If DHCP is enabled in your network, and the camera cannot be accessed, run the Shepherd
utility to search the network. If the camera has been congured with xed IP that does not
comply with your local network, you may see its default IP 169.254.x.x. If you still cannot nd
the camera, you can restore the camera to its factory defaults.
4. If you change your network parameters, e.g., added a connection to a LAN card, re-start the
Shepherd utility.
VIVOTEK
User's Manual - 41
Main Page
This chapter explains the layout of the main page. It is composed of the following sections:
VIVOTEK INC. Logo, Host Name, Camera Control Area, Configuration Area, and Live Video
Window.
Live View Window
Host Name
VIVOTEK INC.
Logo
Camera Control
Area
Resize Buttons
Configuration
Area
Mouse and Screen Control
PTZ control mode: Click on Image (on IE only)
In addition to the use of a joystick, mouse control is also supported by the web session. You can click
on any spot on the screen to move camera's eld of view to that direction. To pan 360 degrees, you can
click and hold down the left mouse button when clicking a PTZ button. The same applies to arrow keys,
Zoom, and Focus buttons on the PTZ panel.
Zoom In
Zoom Out
Click and hold down the
button to continue turning
Click to bring to
center of view
Note that if your screen control malfunctions, it is possible that the CPU of your current view station can
not cope with the HD video feeds or that an incompatibility issue occurred with the ActiveX control plug-
ins.
VIVOTEK
42 - User's Manual
The Joystick mode simulates joystick control using your mouse. Click, hold down mouse button, and
drag your mouse target cursor to the direction you want, the lens will move to that direction. You can click
and hold down the mouse button to continue scanning.
When you drag your cursor across the screen, you can see a draw line on screen. The longer the line,
the faster the moving speed. The shorter the line (closer to the center point), the slower the move.
center point
Lens move
direction
Slow
Fast
PTZ control mode: Joystick
Click and drag a region of interest on the live view. The speed dome will move to that region and
zoom in to ll the same proportion of view into its view cell. If you draw a small region, the speed
dome will zoom in on the scene. The smaller the region, the larger the zoom-in ratio.
When drawing a region of interest, click and drag from the upper left over a diagonal line to the
bottom right.
PTZ control mode: Area zoom
Object
of your interest
Auto Tracking
VIVOTEK
User's Manual - 43
Left
Down
Zoom Out
Focus Near
Start to Auto Patrol
Start to Auto Pan
Stop Auto Panning/patrolling/tracking
Return to Home Position
Right
Up
Zoom In
Focus Far
Auto Focus
VIVOTEK INC. Logo
Click this logo to visit the VIVOTEK website.
Host Name
The host name can be customized to t your needs. For more information, please refer to System on page 53.
Camera Control Area
Profile mode:
3 pre-configured streaming profiles are provided through here: Max. view, Recording
view, Live view. Each mode features a different stream source (channel), resolution, multicast, and
metadata conguration.
The proles can be congured in
Conguration
>
Media
>
Media proles
.
Manual triggers: Manual triggers can be turned on/o by users from the main page. The manual triggers
can be associated with the Event settings, and, as the result, can be used to perform recording actions,
sending notications, and so on. See Event settings on page 138.
Digital Output: Click to turn the digital output device on or o.
Preset with Smart tracking: You can enable the Smart Tracking with presets you have congured in the
Smart Tracking package. There will not be presets if you have not configured the VCA rule or Smart
Tracking in the package. Please refer to Smart Tracking user documentation for more information.
PTZ control mode: Refer to the previous pages for the usable PTZ modes.
Pan: Click this button to start the auto pan (360° continuous rotation).
Stop: Click this button to stop the Auto Pan, Auto Patrol, and Auto Tracking functions.
Patrol: Once the Administrator has determined the list of preset positions (including the zoom-in action
on a particular position), click this button to command the camera to patrol among those positions on
the Patrol List. The Network Camera will patrol continuously. For more information, please refer to PTZ
control on page 131.
PTZ Control Panel:
Loading page 44...
VIVOTEK
User's Manual - 45
Resize Buttons
:
Click the Auto button, the video cell will resize automatically to t the monitor.
Click 100% is to display the original homepage size.
Click 50% is to resize the homepage to 50% of its original size.
Click 25% is to resize the homepage to 25% of its original size.
Preset
If you have PTZ preset positions, these positions will be available in the Preset menu. Please refer to
page 131 for more information.
Live Video Window
■ The following window is displayed when the video mode is set to H.265 / H.264:
Video Title: The video title can be congured. For more information, please refer to Video settings on
page 67.
H.265/H.264 Protocol and Media Options: The transmission protocol and media options for H.265 /
H.264 video streaming. For further conguration, please refer to Client Settings on page 47.
Time: Display the current time. For further configuration, please refer to Media > Image > General
settings on page 67.
Title and Time: The video title and time can be stamped on the streaming video. For further conguration,
please refer to Media > Image > General settings on page 67. The zoom ratio is also displayed with the
title bar.
Video and Audio Control Buttons: Depending on the Network Camera model and Network Camera
conguration, some buttons may not be available.
2.0x Title 2019/03/05 10:39:08
Video 17:08:56 2016/03/10
Title and Time
2016/03/10 17:08:56
Time
Video (TPC-AV)
H.265/H.264 Protocol and Media Options
Video Title
Video and Audio Control Buttons
VIVOTEK
46 - User's Manual
Snapshot: Click this button to capture and save still images. The captured images will be displayed in
a pop-up window. Right-click the image and choose
Save Picture As
to save it in JPEG (*.jpg) or BMP
(*.bmp) format.
Pause: Pause the transmission of the streaming media. The button becomes the Resume button after
clicking the Pause button.
Stop: Stop the transmission of the streaming media. Click the Resume button to continue transmission.
Start MP4 Recording: Click this button to record video clips in MP4 le format to your computer. Press
the Stop MP4 Recording button to end recording. When you exit the web browser, video recording stops
accordingly. To specify the storage destination and le name, please refer to MP4 Saving Options on
page 48 for details.
Volume: When the Mute function is not activated, move the slider bar to adjust the volume on the local
computer.
Mute: Turn o the volume on the local computer. The button becomes the Audio On button after clicking
the Mute button.
Talk: Click this button to talk to people around the Network Camera. Audio will project from the external
speaker connected to the Network Camera. Click this button again to end talking transmission.
Mic Volume: When the Mute function is not activated, move the slider bar to adjust the microphone
volume on the local computer.
Mute: Turn off the Mic volume on the local computer. The button becomes the Mic On button after
clicking the Mute button.
Full Screen: Click this button to switch to full screen mode. Press the “Esc” key to switch back to normal
mode.
VIVOTEK
User's Manual - 47
■ The following window is displayed when the video mode is set to MJPEG:
Video Title: The video title can be congured. For more information, please refer to Media > Image on
page 67.
Time: Display the current time. For more information, please refer to Media > Image on page 67.
Title and Time: Video title and time can be stamped on the streaming video. For more information, please
refer to Media > Image on page 67
.
Video Control Buttons: Depending on the Network Camera model and Network Camera conguration,
some buttons may not be available.
Snapshot: Click this button to capture and save still images. The captured images will be displayed in
a pop-up window. Right-click the image and choose
Save Picture As
to save it in JPEG (*.jpg) or BMP
(*.bmp) format.
Start MP4 Recording: Click this button to record video clips in MP4 le format to your computer. Press
the Stop MP4 Recording button to end recording. When you exit the web browser, video recording stops
accordingly. To specify the storage destination and le name, please refer to MP4 Saving Options on
page 48 for details.
Full Screen: Click this button to switch to full screen mode. Press the “Esc” key to switch back to normal
mode.
VIVOTEK
48 - User's Manual
Client Settings
(Only available on Edge IE mode)
This chapter explains how to select the stream transmission mode and saving options on the
local computer. When completed with the settings on this page, click
Save
on the page bottom
to enable the settings.
H.265/H.264 Protocol Options
Depending on your network environment, there are four transmission modes of H.265 or H.264
streaming:
UDP unicast: This protocol allows for more real-time audio and video streams. However, network
packets may be lost due to network burst trac and images may be broken. Activate UDP connection
when occasions require time-sensitive responses and the video quality is less important. Note that each
unicast client connecting to the server takes up additional bandwidth and the Network Camera allows up
to ten simultaneous accesses.
UDP multicast: This protocol allows multicast-enabled routers to forward network packets to all clients
requesting streaming media. This helps reduce the network transmission load of the Network Camera
while serving multiple clients at the same time. Note that to utilize this feature, the Network Camera must
be configured to enable multicast streaming at the same time. For more information, please refer to
RTSP Streaming on page 104.
TCP: This protocol guarantees the complete delivery of streaming data and thus provides better video
quality. The downside of this protocol is that its real-time eect is not as good as that of the UDP protocol.
HTTP: This protocol allows the same quality as TCP protocol without needing to open specic ports for
streaming under some network environments. Users inside a firewall can utilize this protocol to allow
streaming data through.
VIVOTEK
User's Manual - 49
Two way audio
Half duplex: Audio is transmitted from one direction at a time, e.g., from a PC holding a web console with
the camera.
Full duplex: Audio is transmitted in both directions simultaneously.
MP4 Saving Options
Users can record live video as they are watching it by clicking the button - Start MP4 Recording - on
the main page. Here, you can specify the storage destination and le name.
Folder: Specify a storage destination for the recorded video les.
File name prex: Enter the text that will be appended to the front of the video le name.
Add date and time sux to the le name: Select this option to append the date and time to the end of the
le name of the recorded videos.
Local Streaming Buer Time
In a busy network, fluctuations in available bandwidth can occur. Video streaming may lag and may
not proceed very smoothly. If you enable this option, video streams from the camera will be temporarily
stored on the computer’s cache memory for a configurable period of time (seconds or milliseconds)
before being played on a web session. This will help you see the streaming more smoothly. If you enter
3,000 Millisecond, the streaming will delay for 3 seconds.
CLIP_20210328-180853
Date and time suffix
The format is: YYYYMMDD_HHMMSS
File name prefix
Loading page 50...
VIVOTEK
User's Manual - 51
Buttons Conguration
In the Joystick Settings window, you can use the combinations of pull-down menus, Actions and Button
number, to assign joystick buttons with dierent functions. The number of buttons may dier from the
joystick you attached.
Please follow the steps below to congure your joystick buttons:
1. Select the number of the button you want to congure from its pull-down list.
For example: Assign
Preset 1
(move to preset 1 position) to Button 1.
2. Select an action from the Actions menu. Click
Assign
to associate the button with an action.
3. Your conguration will be automatically saved.
4.
To disable an assignment, select the number of a button, and then click the Delete button. The
associated action will then be cleared.
5. Repeat the above process to assign actions to other buttons.
When done, simply close the conguration
window.
VIVOTEK
52 - User's Manual
• If you want to assign Preset actions to your joystick, the PTZ preset locations should be congured in
advance.
• If your joystick is not working properly, it may need to be calibrated. Click the Calibrate button to open
the Game Controllers window located in Microsoft Windows control panel and follow the instructions for
trouble shooting.
NOTE:
• The joystick will appear in the Game Controllers list in the Windows Control panel. If you want to check
out for your devices, go to the following page:
Start
->
Control Panel
->
Game Controllers
.
• Follow the onscreen instructions to calibrate your joystick.
VIVOTEK
User's Manual - 53
Conguration
Click
Configuration
on the main page to enter the camera setting pages. Note that only
Administrators can access the configuration page. Please refer to page 116 Security > User
Account for how to congure access rights for dierent users.
Configuration List
Firmware Version
Navigation Area
Each function on the conguration list will be explained in the following sections.
Navigation Area provides an instant switch among
Home
page (the monitoring page for live viewing),
Conguration
page, and multi-language selection.
Loading page 54...
Loading page 55...
VIVOTEK
56 - User's Manual
Western Argentina Summer Time (WARST) is 3 hours behind the prime meridian all year.
There is a dummy fall-back transition on December 31 at 25:00 daylight saving time (i.e., 24:00
standard time, equivalent to January 1 at 00:00 standard time), and a simultaneous spring-
forward transition on January 1 at 00:00 standard time, so daylight saving time is in eect all
year and the initial WART is a placeholder.
The format is TZ = local_timezone,date/time,date/time.
Here, date is in the Mm.n.d format, where:
Mm (1-12) for 12 months
n (1-5) 1 for the rst week and 5 for the last week in the month
d (0-6) 0 for Sunday and 6 for Saturday
CST6CDT is the name of the time zone
CST is the abbreviation used when DST is o
6 hours is the time dierence from GMT
CDT is the abbreviation used when DST is on
,M3 is the third month
.2 is the second occurrence of the day in the month
.0 is Sunday
/2 is the time
,M11 is the eleventh month
.1 is the rst occurrence of the day in the month
.0 is Sunday
/2 is the time
The minimum specier is down to the hour.
VIVOTEK
User's Manual - 57
System > Homepage layout
This section explains how to set up your own customized homepage layout.
General settings
This column shows the settings of your hompage layout. You can manually select the background and
font colors in Theme Options (the second tab on this page). The settings will be displayed automatically
in this Preview eld. The following shows the homepage using the default settings:
■ Hide Powered by VIVOTEK: If you check this item, such wording will be removed from the homepage.
Logo graph
Here you can change the logo at the top of your homepage.
Follow the steps below to upload a new logo:
1. Click
Custom
and the Browse eld will appear.
2. Select a logo from your les.
3. Click
Upload
to replace the existing logo with a new one.
4. Enter a website link if necessary.
5. Click
Save
to enable the settings.
Customized button
Deselect the checkbox if you do not need the Manual trigger buttons on the main page.
VIVOTEK
58 - User's Manual
Theme Options
Here you can change the color of your homepage layout. There are three types of preset patterns for you
to choose from. The new layout will simultaneously appear in the
Preview
led. Click
Save
to enable the
settings.
Font Color of the
Video Title
Background Color of
the Video Area
Frame Color
Background Color of the
Control Area
Font Color of the
Configuration Area
Background Color of the
Configuration Area
Preset patterns
Font Color
VIVOTEK
User's Manual - 59
■ Follow the steps below to congure a customized homepage:
1. Click
Custom
on the left column.
2. A double-click on the color selection area (the right hand side column) will bring up a color palette
window.
3. The palette window will pop up as shown below.
4. Drag the slider bar and click on the left square to select a desired color.
5. The selected color will be displayed in the corresponding elds and in the
Preview
column.
6. Click
Save
to enable the settings.
Below are the options for system integrators or VARs. You can use the checkboxes to replace
VIVOTEK’s company logo, the embedded website address or the slogan “Powered by VIVOTEK.“ When
done, use the Save button to complete the conguration.
1
2
3
4
Color Selector
Custom
Pattern
VIVOTEK
60 - User's Manual
System > Logs
This section explains how to configure the Network Camera to send the system log to the
remote server as backup.
Log server settings
Follow the steps below to set up the remote log:
1. Select
Enable remote log
.
2. In the IP address text box, enter the IP address of the remote server.
2. In the port text box, enter the port number of the remote server.
3. When completed, click
Save
to enable the setting.
You can congure the Network Camera to send the system log le to a remote server as a log backup.
Before utilizing this feature, it is suggested that the user install a log-recording tool to receive system log
messages from the Network Camera. An example is Kiwi Syslog Daemon. Visit http://www.kiwisyslog.
com/kiwi-syslog-daemon-overview/.
System log
This column displays the system log in a chronological order. The system log is stored in the Network
Camera’s buer area and will be overwritten when the number of events reaches a preset limit.
VIVOTEK
User's Manual - 61
Access log
Access log displays the access time and IP address of all viewers (including operators and
administrators) in a chronological order. The access log is stored in the Network Camera’s buer area
and will be overwritten when reaching a certain limit.
Server with
VAST Recording Software
Internet
VIVOTEK Network Cameras
3G Cell phone
Cell phone
Short message
EmailGSM
Modem
HTTP
Digital output
VIVOCloud
PTZ
Deterrent
FTP
You can install the included VSS recording software, which provides an Event Management
function group for delivering event messages via emails, GSM short messages, onscreen event
panel, or to trigger an alarm, etc. For more information, refer to the VSS User Manual.
VIVOTEK
62 - User's Manual
VADP log
VADP log contains the information for the onboard VADP packages, including memory usage, module
load and unload information.
Set Parameter log
VADP log contains the history of changes made to system parameters such as recording, imaging
parameters, and all other parameters.
VIVOTEK
User's Manual - 63
System > Parameters
The View Parameters page lists the entire system’s parameters in an alphabetical order. If you
need technical assistance, please provide the information listed on this page.
System > Audit Log
The Audit Log lists the administrative activities, such as user log in, parameter changes,
conguration acts, etc.
Loading page 64...
Loading page 65...
Loading page 66...
VIVOTEK
User's Manual - 67
The following message is displayed when attempting to upload an incorrect le format.
Export language file: Click to export language strings. VIVOTEK provides nine languages: English,
Deutsch, Español, Français, Italiano,
日本語,
Português,
簡体中文
,
繁體中文,
and
Ρусский
.
Update custom language le: Click
Browse…
and specify your own custom language le to upload.
Export conguration le: Click to export all parameters for the device and user-dened scripts.
Update conguration le: Click
Browse…
to update a conguration le. Please note that the model and
rmware version of the device should be identical to those specied for the conguration le. If you have
set up a xed IP or other special settings for your device, it is not suggested to update a conguration
le.
Export server status report: Click to export the current server status report, such as time, logs,
parameters, process status, memory status, le system status, network status, kernel message..., and so
on.
Tips:
• If a firmware upgrade is accidentally disrupted, say, by a power outage, you still have a last resort
method to restore normal operation. See the following for how to bring the camera back to work:
Applicable scenario:
(1) Power disconnected during rmware upgrade.
(2) Unknown reason causing abnormal LED status, and a Restore cannot recover normal working
condition.
You can use the following methods to activate the camera with its backup rmware:
(1) Press and hold down the reset button for at least one minute.
(2) Power on the camera until the Red LED blinks rapidly.
(3) After boot up, the firmware should return to the previous version before the camera hanged.
(The procedure should take 5 to 10 minutes, longer than the normal boot-up process). When this
process is completed, the LED status should return to normal.
VIVOTEK
68 - User's Manual
Media > Image
This section explains how to configure the image settings of the Network Camera. It is
composed of the following four columns: General settings, Picture settings, Exposure, and
Privacy mask.
General settings
Video title
Show_timestamp and video title in videos_and_snapshots: Enter a name that will be displayed on the
title bar of the live video as the picture shown below.
Video Title
Title and Time
Video 17:08:56 2019/03/09
2019/03/09 17:08:56
Position of timestamp and video title on image: Select to display time stamp and video title on the top or
at the bottom of the video stream.
Timestamp and video title font size: Select the font size for the time stamp and title.
Video font (.ttf): You can select a True Type font le for the display of textual messages on video.
Color: Select to display color or black/white video streams.
Power line frequency: Set the power line frequency consistent with local utility settings to eliminate image
flickering associated with fluorescent lights. Note that after the power line frequency is changed, you
must disconnect and reconnect the power cord of the Network Camera in order for the new setting to
take eect.
Video orientation: Flip - vertically reflect the display of the live video; Mirror - horizontally reflect the
display of the live video. Change the settings if the Network Camera is installed in a dierent orientation
(which is rare for a speed dome) to correct the image orientation.
Loading page 69...
Loading page 70...
Loading page 71...
VIVOTEK
72 - User's Manual
Exclude x
Tips:
If there is an object in close proximity, the IR lights reected
back from it can mislead the Smart IR’s calculation of light
level. To solve this problem, you can place an “Exposure
Exclude” window on an unavoidable object in the Exposure
setting window. See page 74 for how to do it.
You can also congure the “Exposure Exclude” window in
a night mode “Prole” setting so that your day time setting
is not aected.
x
Exclude
VIVOTEK
User's Manual - 73
Image settings
On this page, you can tune the White balance and Image adjustment settings.
White balance: Adjust the value for the best color temperature.
■ Select one of the white balance modes:
1.
Outdoor
(system default): Using this mode enables the camera to capture images with natural white
balance observable in the morning.
2.
Indoor
: 3,200K base mode, suitable for indoor applications.
■ Fix current value: This option is available when the tuning the white balance. When selected, the
camera will use the current color temperature setting. Note that you should use the Save button below
to preserve current conguration. Otherwise, the white balance mode will return to Auto after you leave
the conguration page.
■ Manual: In the manual mode, you can manually tune the R gain and Blue gain values by dragging the
slide bars. Index numbers will be shown on the right hand side while changes in image is immediately
displayed.
Image Adjustment
■ Brightness: Adjust the image brightness level, which ranges from -5 to +5.
■ Contrast: Adjust the image contrast level, which ranges from -5 to +5.
■ Saturation: Adjust the image saturation level, which ranges from 0% to 100%.
■ Sharpness:
Adjust the image sharpness level, which ranges from
0% to 100%
.
Sensor Setting 1:
For normal situations
■ Gamma curve:
Adjust the image sharpness level, which ranges from 0.45 to
1, from Detailed to
Contrast
. You may let rmware
Optimize
your display or select the
Manual
mode, and pull the slide bar
pointer to change the preferred level of Gamma correction towards higher contrast or towards the higher
luminance for detailed expression for both dark and lighted areas of an image.
This option is disabled when the WDR feature is enabled.
VIVOTEK
74 - User's Manual
Defog: Defog helps improve the visibility quality of captured image in poor weather conditions such as
smog, fog, or smoke.
Note that the
Preview
button has been cancelled, all changes made to image settings is directly shown
on screen. You can click
Restore
to recall the original settings without incorporating the changes. When
completed with the settings on this page, click
Save
to enable the setting. You can also click on
Prole
mode
to adjust all settings above in a pop-up window for special lighting conditions during a specic
period of time in a day.
Enable 3D Noise reduction
■ Check to enable noise reduction in order to reduce noises and ickers in image. This applies to the
onboard 3D Noise Reduction feature. Use the pull-down menu to adjust the reduction strength. Note
that applying this function to the video channel will consume system computing power.
3D Noise Reduction is mostly applied in low-light conditions. When enabled in a low-light condition
with fast moving objects, trails of after-images may occur. You may then select a lower strength level
or disable the function.
Electronic image stabilizer
Select the checkbox to enable the Electronic image stabilization (EIS) function at installation sites where
vibration is expected, such as a train station.
Sensor Setting 2:
For customized situations such as
night mode.
Scene mode: deblur
■ When enabled, shutter time will be fixed to 1/120 second to reduce image smear. This feature is
designed to apply with human movement at the pace of 1.4~2.2m/s. The deblur function is related to
Motion detection where motion-alerted pixels need to be suppressed in order to increase the accuracy
of motion detection. In certain conditions, shadows or light changes can all cause false alarms in
motion detection.
The deblur function uses the same detection window as that of the Motion detection.
Highlight mask: Firmware detects strong light sources and compensates on aected spots to enhance
the overall image quality. For example, the maksing helps reduce the glares produced by spotlights or
headlights.
VIVOTEK
User's Manual - 75
Exposure
On this page, you can set the Exposure level, Max gain,Exposure mode, and IR cut lter related settings.
Detailed congurations will be automatically adjusted since the sensor library will automatically adjust the
value according to the ambient light.
Sensor Setting 1:
For normal situations
Sensor Setting 2:
For special situations
The inclusive window refers to the “weighted window“; the exclusive window refers to “ignored
window“. It adopts the weighted averages method to calculate the value. The inclusive windows
have a higher priority. You can overlap these windows, and, if you place an exclusive window
within a larger inclusive window, the exclusive part of the overlapped windows will be deducted
from the inclusive window. An exposure value will then be calculated out of the remaining of the
inclusive window.
Include
Exclude
Weighted region
Ignored region
Include
Exclude
VIVOTEK
76 - User's Manual
- Shutter Priority:
When selected, the
Exposure time
slide bar will appear, allowing you to select an
exposure time ranging from 1/10,000, to 1/1 second. Once a xed value is selected, system rmware
will automatically tune the gain and iris settings to match an optimal exposure level.
- Iris Priority:
When selected, the
Iris adjustment
slide bar will appear, allowing you to select
an aperture size ranging from F14 to F1.6. Once a fixed value is selected, system firmware will
automatically tune the gain and exposure time to match an optimal exposure level.
The value is
measured in the F-number as the ratio of the focal length to the lens diameter. Iris size is inversely
proportional to the F-number; therefore, the smaller the F-number, the greater is the exposure ratio.
Smaller F-number (larger exposure ratio, largest size of lens aperture opening) is shown on the right of
the slide bar.
- Quality Priority:
When selected, the embedded mapping table of aperture size and depth of eld will
apply when operating with the auto focus mechanism.
- Manual
: Select
Manual
to set a xed exposure time, iris, and gain. Then, tune the slide bar to set the
Exposure time, Iris adjustment, and Gain Control to the best image quality. A shorter exposure time
allows less amount of light to enter the sensor; while a higher gain control value generates certain
amount of noises.
Note the following when the
Manual
mode is selected:
1. The
Exposure level
bar will not be available.
2. The
IR cut lter
setting will switch to
Day Mode
. If it was previously congured into other modes,
the previous setting remains intact.
Exposure control:
■
Exposure level
: You can manually set the Exposure level, which ranges from -2.0 to +2.0 (dark
to bright). You can also select other values from the Exposure mode menus and select a preferred
scenario or manually congure the associated settings. You may prefer a shorter shutter time to better
capture moving objects, while a faster shutter reduces light and needs to be compensated by electrical
brightness gains.
■
Exposure mode
:
Select
Auto, Shutter Priority, Iris Priority, Quality Priority,
or
Manual
mode according to your needs.
- Auto:
System default, which automatically adjusts the iris, shutter speed, and gain for an optimmal
exposure level.
■ Center: Use the center portion of the screen to determine the exposure level.
■
HLC
: (Highlight Compensation). Firmware detects strong light sources and compensates on aected
spots to enhance the overall image quality. For example, the HLC helps reduce the glares produced by
spotlights or headlights.
■
BLC
(Back Light Compensation): This option will automatically add a “weighted region“ in the middle of
the window and give the necessary light compensation.
■
Auto
: Lets rmware automatically detect the exposure measurement.
Metering mode
:
Loading page 77...
VIVOTEK
78 - User's Manual
Please follow the steps below to set up a prole:
1. Select the
Enable to apply these settings at
checkbox.
2. Select the applicable Night mode or Schedule mode.
Please manually enter a range of time if you choose
Schedule mode.
When a span of time is congured using the Schedule
mode, you can configure the Day/Night setting for
controlling the behavior of the IR cut lter during that
time.
3. Configure Exposure control settings in the folowing
columns. Please refer to previous dicussions for
detailed information.
4. Click
Save
to enable the setting and click
Close
to exit
the window.
Exposure Prole: (Only available when the IR cut lter is not set to the Auto mode)
If you want to congure another sensor and exposure setting for an individual day/night/schedule mode,
please click
Prole mode
to open the Prole of exposure settings page as shown below.
Enable to apply these settings at:
Select the mode this prole to apply to the Night mode or Schedule
mode. Please manually enter a range of time if you choose Schedule mode. Then check
Save
to take
eect.
Exposure mode default gain
Auto 37
Shutter priority BLC - hidden Defog -
disabled
WDR Pro -
disabled
37
Iris priority BLC - hidden Defog -
disabled
WDR Pro -
disabled
37
Manual BLC - hidden Defog -
disabled
WDR Pro -
disabled
ICR mode -
Auto
0
Due to the imaging characteristics, some of the related imaging functions will be disabled when the
Exposure mode is changed. See the table below for details:
Loading page 79...
VIVOTEK
User's Manual - 80
Privacy mask
On this page, you can block out sensitive view areas to address privacy concerns.
■ To set the privacy mask windows, follow the steps below:
1. Click on the
Enable privacy mask
checkbox to enable this function.
2. Use mouse clicks on the screen to move to a place where you want to create a mask. You can also
use the PTZ panel to ne-tune the move to the target area.
3. Enter a name for the masking window. Click
Add
to create a new window.
4. Click on the
Modify
button and then use the mouse cursor to re-size the masking window, which is
recommended to be at least twice the size of the object (height and width) you want to cover. You can
select the Drawing mode as "Fixed in center" or "Drag to move."
• When using the
Fixed in center
mode, you can move to the area of your interest, and then
manually change the size and shape of the masking window.
• When using the
Drag to move
mode, you can move to an area of your interest using the PTZ
buttons above, and then click and drag to draw a masking window. The click to move maneuver
is not available when you select the Drag to move mode.
5. You can also change the color of the mask from the
Color
menu.
6. If preferred, move the eld of view to other places to create more privacy masks.
You may be prompted by the message when trying to create a privacy mask at angles between +70
°
and -70
°
.
VIVOTEK
User's Manual - 81
NOTE:
• The camera supports "
3D Privacy Mask
." Privacy masks should stay at the same positions
regardless of how the camera lens may move.
• When the "Enabled privacy mask" checkbox is deselected, no privacy masks will appear on screen.
• Up to
24
privacy mask windows can be congured over the camera's hemispheric coverage.
• If you want to delete a privacy mask window, select its name from the pull-down menu at the bottom,
and then click
Delete
to remove it.
Privacy mask
Current field of view
Privacy mask
Loading page 82...
VIVOTEK
User's Manual - 83
Take the following into consideration when using this feature:
1. Operational requirement: Identify a human or a human face.
2. Why human face? There are less variances in the size of a face than that for limbs and body. Human
face is normally 16cm wide.
3. The recommended pixel number is, 40 to 80 for facial identication; or 100 pixels per foot (30.48cm)
3-1. One example is a human face in retail.
3-2. Another example is a doorway:
If the requirement is 100 pixels per foot, to detect a person passing through a door, the camera
will have to cover 700 pixels throughout the length of a doorway. This application aims to identify a
subject passing through a specic area.
4. Other factors may include that a person will move in your area of interest: The face may not always
face the camera.
5. Details can be affected by weak lighting or the view angle. Therefore, higher the pixels, higher the
chance you can identify the subject.
6. The pixel calculator visual tool looks like the following.
1
2
With the visual tool, you can estimate a coverage area, the distance from the subject, and place a ruler
or an object of known size. You can then draw a calculator frame to cover the subject of your interest.
The calculated numbers will be listed at the lower screen. You will then understand if the current
setting fullls your requests for the number of pixels.
VIVOTEK
84 - User's Manual
Media > Video
Stream settings
This Network Camera supports multiple streams with frame sizes ranging from 384 x 216 to 1920 x 1080
pixels.
The denition of multiple streams:
Stream 1 : xed 3840 x 2160 max 30fps, default 3840 x 2160 15fps
Stream 2: max 3840 x 2160 max 30fps, default 1920 x 1080 30fps
Stream 3: max 1280 x 720 max 30fps, default 1280 x 720 30fps
VIVOTEK
User's Manual - 85
Click the stream item to display the detailed information. .
This Network Camera offers real-time H.265, H.264, and MJPEG compression standards (Multiple
Codec) for real-time viewing. If the
H.265 / H.264
mode is selected, the video is streamed via RTSP
protocol. There are several parameters through which you can adjust the video performance:
►
Video quality and fixed quality refers to the
compression rate
, so a lower value will produce higher
quality.
►
Converting high-quality video may significantly increase the CPU loading, and you may encounter
streaming disconnection or video loss while capturing a complicated scene. In the event of occurance,
we suggest you customize a lower video resolution or reduce the frame rate to obtain smooth video.
NOTE:
Loading page 86...
VIVOTEK
User's Manual - 87
P I P P P P P P P P P P P P P P P P P P P I
P I P P P P P P P I P P P P P P P I
Static scene
Activities
P P P
Dynamic Intra Frame w/
static scenes
Dynamic Intra Frame w/
activities in scenes
With the H.265 codec in an optimal scenario and when the Dynamic Intra frame and the Smart Stream
function are applied, an 80% of bandwidth saving can be achieved compared with using H.264 without
enabling these bandwidth-saving features.
f1 f1 f1
f1
f5 f5 f5 f5 f9
f1 f1
f3
f4 f5 f6 f7 f8 f9
Motions Occur.
By queuing the old frames from a static scene, both the computing eorts and the size of P frames are
reduced. It is benecial for keeping up with the frame rate requirements.
A default frame dierence threshold, 1%, is embedded in rmware for returning from Smart FPS to
normal encoding when motions occur.
■ Smart FPS
In a static scene, the algorithm puts old frames in queue when no motions occur in scene. When
motions occur, the encoding returns to normal to deliver real-time streaming.
VIVOTEK
88 - User's Manual
Comparing with Smart Stream II, Smart Stream III has two more configurable options: Smart Q, and
Smart FPS.
NOTE:
• Smart codec: Smart codec effectively reduces the quality of the whole or the non-
interested areas on a screen and therefore reduces the bandwidth consumed.
You can manually specify the video quality for the foreground and the background areas.
Select an operation mode if Smart codec is preferred.
-
Auto tracking
: The Auto mode configures the whole screen into the non-interested
area. The video quality of part of the screen returns to normal when one or more
objects move in that area. The remainder of the screen where there are no
moving objects (no pixel changes) will still be transmitted in low-quality format.
-
Manual
: The Manual mode allows you to congure 3 ROI windows (Region of Interest,
with Foreground quality) on the screen. Areas not included in any ROI windows
will be considered as the non-interested areas. The details in the ROI areas will
be transmitted in a higher-quality video format.
As illustrated below, the upper screen may contain little details of your interest,
while the sidewalk on the lower screen is included in an ROI window.
X
ROI_0
X
ROI_0
ROI
non-interested
VIVOTEK
User's Manual - 89
ROI: higher-quality
non-ROI: lower-quality
As the result, the lower screen is constantly displayed in high details, while the
upper half is transmitted using a lower-quality format. Although the upper half is
transmitted using a lower quality format, you still have an awareness of what is
happening on the whole screen.
-
Hybrid
: The major dierence between the “Manual” mode and the “Hybrid” mode
is that:
In the “
Hybrid
“ mode, any objects entering the non-interested area will
restore the video quality of the moving objects and the area around them.
The video quality of the associated non-interested area is immediately
restored to normal to cover the moving objects.
In the “
Manual
” mode, the non-interested area is always transmitted using
a low-quality format regardless of the activities occurring inside.
You should also select the Maximum bit rate from the pull-down menu as the
threshold to contain the bandwidth consumption for both the high- and low-quality
video sections in a smart stream.
-
Quality priority
: Use the slide bar to tune the quality contrast between the ROI
and non-interested areas.
The farther the slide bar button is to the right, the higher the image quality
of the ROI areas. On the contrary, the farther the slide bar button to the left,
the higher the image quality of the non-interested area.
In this way, you may set up an ROI window as a privacy mask by covering a
protected area using an ROI window, while the rest of the screen becomes
the non-interested area. You may then congure the non-interested area to
have a high image quality, or vice versa.
VIVOTEK
90 - User's Manual
Smart Q: Select ON or OFF to enable or disable the feature. Smart Q is scene-aware.
The Smart Q reduces frame size and bit rate consumption through the following:
■
Dynamically adjusting the image quality for scenes in dierent luminosities in low
light frames. Less noises means less of the bandwidth consumed.
■
Endorsing dierent qualities for the I frames and P frames, and hence reduces
the frame size.
■ Dividing a single frame into dierent sections, and giving these sections dierent
qualities. For a highly complex area, such as an area with dense vegetation,
screen windows, or repeated patterns (complex textiles patterns like wall paper),
having a lower quality value actually poses little eects on human eyes.
Unnecessary quality is unrecognized by human eyes and wastes the bit rate.
The Smart Q streaming can save up to 50% to 80% of bandwidth in different
illumination conditions while keeping the same imaging quality. These numbers come
from the comparison between Smart Stream II and Smart Stream III streamings.
■
Bit rate control
Constrained bit rate:
A complex scene generally produces a larger file size, meaning that higher bandwidth
will be needed for data transmission. The bandwidth utilization is congurable to match a
selected level, resulting in mutable video quality performance. The bit rates are selectable
at the following rates: 20/30/40/50/64/128/256/512/768Kbps,
1/2/3/4/6/8/10/12/14/16/18/20/24/28/32/36/40Mbps. You can also select
Customize
and
manually enter a value up to 40Mbps.
• - Target quality: Select a desired quality ranging from Medium to Excellent.
- Maximum bit rate: select a bit rate from the pull-down menu. The bit rate ranges from
20kbps to a maximum of 40Mbps. The bit rate then becomes the Average or Upper bound
bit rate number. The Network Camera will strive to deliver video streams around or within
the bit rate limitation you impose.
- Policy: If Frame Rate Priority is selected, the Network Camera will try to maintain the
frame rate per second performance, while the image quality will be compromised. If Image
quality priority is selected, the Network Camera may drop some video frames in order to
maintain image quality.
VIVOTEK
User's Manual - 91
Maximum bit rate: With the guaranteed image quality, you might still want to place
a bit rate limitation to control the size of video streams for bandwidth and storage
concerns. The congurable bit rate starts from 1Mbps to 40Mbps.
The Maximum bit rate setting in the Fixed quality configuration can ensure a
reasonable and limited use of network bandwidth. For example, in low light conditions
where a Fixed quality setting is applied, video packet sizes can tremendously
increase when noises are produced with electrical gains.
You may also manually enter a bit rate number by selecting the
Customized
option.
Fixed quality:
On the other hand, if
Fixed quality
is selected, all frames are transmitted with the
same quality; bandwidth utilization is therefore unpredictable. The video quality
can be adjusted to the following settings: Medium, Standard, Good, Detailed, and
Excellent. You can also select
Customize
and manually enter a value.
Loading page 92...
Loading page 93...
VIVOTEK
94 - User's Manual
Audio clips
■ Output gain: Use the slide bar to change the audio output gains value.
■ Audio clip: When the camera's audio input is connected to a microphone, you can record a short
period of audio recordings (1 to 10 seconds). You can also use the camera's embedded microphone to
record an audio clip, if available. Because the memory space is limited, a recording count down will be
available on screen.
You can also upload an audio file to the camera's flash memory. With amplified speakers, you can
playback the audio, e.g., to deter an intruder. A maximum of 2 audio clips in wav format are supported.
The maximum size of the audio le to be uploaded is 2,000Kbytes.
The voice alert is enabled in the
Event settings
>
action
>
Play Audio Clip
. The action c a n b e
associated with triggering conditions.
VIVOTEK
User's Manual - 95
Media proles
You can configure a different video stream for each of the 3 default profiles, Max. view,
Recording, Live view, and App.
The related video stream information will display, including stream number, resolution, codec
used, frame rate, etc. The Multicast port number, and address for video, audio, and Metadata
conguration will also be listed.
VIVOTEK
96 - User's Manual
Network > General settings
This section explains how to congure a wired network connection for the Network Camera.
Network Type
LAN
Select this option when the Network Camera is deployed on a local area network (LAN) and is intended
to be accessed by local computers. The default setting for the Network Type is LAN. Please rememer to
click on the
Save
button when you complete the Network setting.
Get IP address automatically: Select this option to obtain an available dynamic IP address assigned by
the DHCP server each time the camera is connected to the LAN.
Use xed IP address: Select this option to manually assign a static IP address to the Network Camera.
1. You can make use of VIVOTEK Installation Wizard 2 on the software CD to easily set up the Network
Camera on LAN. Please refer to Software Installation on page 30 for details.
2. Enter the Static IP, Subnet mask, Default router, and Primary DNS provided by your ISP or network
administrator.
Subnet mask: This is used to determine if the destination is in the same subnet. The default value is
“255.255.255.0”.
Default router: This is the gateway used to forward frames to destinations in a dierent subnet. Invalid
router setting will disable the transmission to destinations across dierent subnets.
VIVOTEK
User's Manual - 97
Primary DNS: The primary domain name server that translates host names into IP addresses.
Secondary DNS: Secondary domain name server that backs up the Primary DNS.
Primary WINS server: The primary WINS server that maintains the database of computer names and IP
addresses.
Secondary WINS server: The secondary WINS server that maintains the database of computer names
and IP addresses.
Enable UPnP presentation: Select this option to enable UPnP
TM
presentation for your Network Camera
so that whenever a Network Camera is presented to the LAN, the shortcuts to connected Network
Cameras will be listed in My Network Places. You can click the shortcut to link to the web browser.
Currently, UPnP
TM
is supported by Windows XP or later. Note that to utilize this feature, please make
sure the UPnP
TM
component is installed on your computer.
Enable UPnP port forwarding: To access the Network Camera from the Internet, select this option to
allow the Network Camera to open ports automatically on the router so that video streams can be sent
out from a LAN. To utilize of this feature, make sure that your router supports UPnP
TM
and it is activated.
PPPoE (Point-to-point over Ethernet)
Select this option to congure your Network Camera to make it accessible from anywhere as long as
there is an Internet connection. Note that to utilize this feature, it requires an account provided by your
ISP.
Follow the steps below to acquire your Network Camera’s public IP address.
1. Set up the Network Camera on the LAN.
2. Go to Conguration > Event > Event settings > Add server (please refer to Add server on page 150) to
add a new email or FTP server.
3. Go to Conguration > Event > Event settings > Add media (please refer to Add media on page 138).
Select System log so that you will receive the system log in TXT le format which contains the
Network Camera’s public IP address in your email or on the FTP server.
4. Go to Conguration > Network > General settings > Network type. Select PPPoE and enter the user
name and password provided by your ISP. Click
Save
to enable the setting.
5. The Network Camera will reboot.
6. Disconnect the power to the Network Camera; remove it from the LAN environment.
Mega-pixel Network Camera (192.168.5.151)
VIVOTEK
98 - User's Manual
► If the default ports are already used by other devices connected to the same router, the Network
Camera will select other ports for the Network Camera.
► If UPnP
TM
is not supported by your router, you will see the following message:
Error: Router does not support UPnP port forwarding.
► Steps to enable the UPnP
TM
user interface on your computer:
Note that you must log on to the computer as a system administrator to install the UPnP
TM
components.
1. Go to Start, click
Control Panel
, then click
Add or Remove Programs
.
2. In the Add or Remove Programs dialog box, click
Add/Remove Windows Components
.
3.
In the Windows Components Wizard dialog box, select
Networking Services
and click
Details
.
NOTE:
VIVOTEK
User's Manual - 99
4. In the Networking Services dialog box, select
Universal Plug and Play
and click
OK
.
5. Click
Next
in the following window.
6. Click
Finish
. UPnP
TM
is enabled.
► How does UPnP
TM
work?
UPnP
TM
networking technology provides automatic IP conguration and dynamic discovery of devices
added to a network. Services and capabilities oered by networked devices, such as printing and le
sharing, are available among each other without the need for cumbersome network conguration. In
the case of Network Cameras, you will see Network Camera shortcuts under My Network Places.
► Enabling UPnP port forwarding allows the Network Camera to open a secondary HTTP port on the
router-not HTTP port-meaning that you have to add the secondary HTTP port number to the Network
Camera’s public address in order to access the Network Camera from the Internet. For example,
when the HTTP port is set to 80 and the secondary HTTP port is set to 8080, refer to the list below for
the Network Camera’s IP address.
From the Internet In LAN
http://203.67.124.123:8080 http://192.168.4.160 or
http://192.168.4.160:8080
► If the PPPoE settings are incorrectly configured or the Internet access is not working, restore the
Network Camera to factory default; please refer to Restore on page 65 for details. After the Network
Camera is reset to factory default, it will be accessible on the LAN.
Loading page 100...
Loading page 101...
Loading page 102...
VIVOTEK
User's Manual - 103
Network > Streaming protocols
HTTP streaming
To utilize HTTP authentication, make sure that your have set a password for the Network Camera rst;
please refer to Security > User account on page 116 for details.
Authentication: Depending on your network security requirements, the Network Camera provides two
types of security settings for an HTTP transaction: basic and digest.
If
basic
authentication is selected, the password is sent in plain text format and there can be potential
risks of being intercepted. If
digest
authentication is selected, user credentials are encrypted using MD5
algorithm and thus provide better protection against unauthorized accesses.
HTTP port / Secondary HTTP port: By default, the HTTP port is set to 80 and the secondary HTTP port is
set to 8080. They can also be assigned to another port number between 1025 and 65535. If the ports are
incorrectly assigned, the following warning messages will be displayed:
To access the Network Camera on the LAN, both the HTTP port and secondary HTTP port can be used
to access the Network Camera. For example, when the HTTP port is set to 80 and the secondary HTTP
port is set to 8080, refer to the list below for the Network Camera’s IP address.
Access name for stream 1 ~ 5: This Network camera supports multiple streams simultaneously. The
access name is used to identify different video streams. Users can click
Media > Video > Stream
settings
to set up the video quality of linked streams. For more information about how to set up the video
quality, please refer to Stream settings on page 83.
When using
Mozilla Firefox
to access the Network Camera and the video mode is set to JPEG, users
will receive video comprised of continuous JPEG images. This technology, known as “server push”,
allows the Network Camera to feed live pictures to Mozilla Firefox.
On the LAN
http://192.168.4.160 or
http://192.168.4.160:8080
NOTE:
The metadata information can only be transmitted through the HTTP main port. Metadata is not available
through the secondary HTTP port.
VIVOTEK
104 - User's Manual
URL command -- http://<ip address>:<http port>/<access name for stream 1, 2>
For example, when the Access name for stream 2 is set to video1s2.mjpg:
1. Launch a browser.
2. Type the above URL command in the address bar. Press
Enter
.
3. The JPEG images will be displayed in your web browser.
RTSP Streaming
To utilize RTSP streaming authentication, make sure that you have set a password for controlling the
access to video stream rst. Please refer to Security > User account on page 116 for details.
http://192.168.5.151/video1s2.mjpg
VIVOTEK
User's Manual - 105
Authentication: Depending on your network security requirements, the Network Camera provides three
types of security settings for streaming via RTSP protocol: disable, basic, and digest.
If
basic
authentication is selected, the password is sent in plain text format, but there can be potential
risks of it being intercepted. If
digest
authentication is selected, user credentials are encrypted using
MD5 algorithm, thus providing better protection against unauthorized access.
The availability of the RTSP streaming for the three authentication modes is listed in the following table:
Access name for Channel # and stream #: This Network camera supports multiple streams
simultaneously. The access name is used to dierentiate the streaming source.
If you want to use an RTSP player to access the Network Camera, you
HAVE TO
set the video mode to
H.265 or 264 and use the following RTSP URL command to request transmission of the streaming data.
rtsp://<ip address>:<rtsp port>/<access name for stream1 ~ 4>
For example, when the access name for stream 1 is set to live1s1.sdp:
1. Launch an RTSP player.
2. Choose File > Open URL. A URL dialog box will pop up.
3. Type the above URL command in the address eld.
4. The live video will be displayed in your player as shown
below.
VLC
Disable O
Basic O
Digest X
rtsp://192.168.5.151:554/live1s1.sdp
Loading page 106...
VIVOTEK
User's Manual - 107
Unicast video transmission delivers a stream through point-to-point transmission; multicast, on the other
hand, sends a stream to the multicast group address and allows multiple clients to acquire the stream at
the same time by requesting a copy from the multicast group address. Therefore, enabling multicast can
eectively save Internet bandwith.
The ports can be changed to values between 1025 and 65535. The multicast RTP port must be an even
number and the multicast RTCP port number is the multicast RTP port number plus one, and thus is
always odd. When the multicast RTP port changes, the multicast RTCP port will change accordingly.
If the multicast RTP video ports are incorrectly assigned, the following warning message will be
displayed:
Multicast TTL [1~255]: The multicast TTL (Time To Live) is the value that tells the router the range a
packet can be forwarded. Each hop decreases TTL by one.
Initial TTL Scope
0 Restricted to the same host
1 Restricted to the same subnetwork
15 Restricted to the same site
64 Restricted to the same region
128 Restricted to the same continent
255 Unrestricted in scope
IMPORTANT:
The Multicast metadata port is utilized by VIVOTEK VADP modules to transfer video analytics results,
PTZ stream, textual data, and event messages between the camera and the client side running and
observing the video analysis. If your client side computer is located outside the local network, you may
need to open the associated TCP port on routers and rewall.
VIVOTEK
108 - User's Manual
Two way audio port:
The Network Camera supports two way audio communication so that operators can transmit and receive
audio simultaneously. By using the Network Camera’s built-in or external microphone and an external
speaker, you can communicate with people around the Network Camera.
Note that as JPEG only transmits a series of JPEG images to the client, to enable the two-way audio
function, make sure the video mode is set to H.264 on the Media > Video > Stream settings page and
the media option is set to “Media > Video > Stream settings” on the Client Settings page. Please refer to
Client Settings on page 47 and Stream settings on page 83.
SIP
SIP is short for Session Initiation Protocol. If necessary, you can change the default port number, 5060,
to one between 1025 and 65535.
Audio transmitted from operators
Audio transmitted to operators
America
Taiwan
VIVOTEK
User's Manual - 109
Network > DDNS
This section explains how to configure the dynamic domain name service for the Network
Camera. DDNS is a service that allows your Network Camera, especially when assigned with a
dynamic IP address, to have a xed host and domain name.
https://0002D1123456.2bthere.net
Manual setup
DDNS: Dynamic domain name service
Enable DDNS: Select this option to enable the DDNS setting.
Provider: Select a DDNS provider from the provider drop-down list.
Refer to the following links to apply for a dynamic domain account when selecting other DDNS
providers:
■
Dyndns.org(Dynamic) / Dyndns.org(Custom): visit http://www.dyndns.com/
Loading page 110...
VIVOTEK
User's Manual - 111
QoS/DSCP (the DiServ model)
DSCP-ECN defines QoS at Layer 3 (Network Layer). The Differentiated Services (DiffServ) model is
based on packet marking and router queuing disciplines. The marking is done by adding a eld to the
IP header, called the DSCP (Differentiated Services Codepoint). This is a 6-bit field that provides 64
dierent class IDs. It gives an indication of how a given packet is to be forwarded, known as the Per Hop
Behavior (PHB). The PHB describes a particular service level in terms of bandwidth, queueing theory,
and dropping (discarding the packet) decisions. Routers at each network node classify packets according
to their DSCP value and give them a particular forwarding treatment; for example, how much bandwidth
to reserve for it.
Below are the setting options of DSCP (DiServ Codepoint). Specify the DSCP value for each application
(0~63).
Note that different vendors of network devices might have different methodologies and unique
implementations. Shown below is a sample corresponding information from a Cisco switch. You should
enter a DSCP tag value according to the information provided by the network devices.
32
QoS Baseline/Technical Marketing Classication and Marking Recommendations
Application Layer3 Classication Layer 2 CoS/MPLS EXP
IPP PHB DSCP
IP Routing 6 CS6 48 6
Voice 5 EF 46 5
Interactive Video 4 AF41 34 4 QoS B
Streaming-Video 4 CS4 32 4
Locally-dened Mission-
Critical Data
3 - 25 3
Call-signaling 3 AF31/CS3 26/24 3
Transactional Data 2 AF21 18 2
Network Management 2 CS2 16 2
Bulk Data 1 AF11 10 1
Scavenger 1 CS1 8 1
Best Eort 0 0 0 0
VIVOTEK
112 - User's Manual
Network > SNMP
(Simple Network Management Protocol)
This section explains how to use the SNMP on the network camera. The Simple Network
Management Protocol is an application layer protocol that facilitates the exchange of
management information between network devices. It helps network administrators to remotely
manage network devices and nd, solve network problems with ease.
■ The SNMP consists of the following three key components:
1. Manager: Network-management station (NMS), a server which executes applications that monitor and
control managed devices.
2. Agent: A network-management software module on a managed device which transfers the status of
managed devices to the NMS.
3. Managed device: A network node on a managed network. For example: routers, switches, bridges,
hubs, computer hosts, printers, IP telephones, network cameras, web server, and database.
Before conguring SNMP settings on the this page, please enable your NMS rst.
SNMP Conguration
Enable SNMPv1, SNMPv2c
Select this option and enter the names of Read/Write community and Read Only community according to
your NMS settings.
Enable SNMPv3
This option contains cryptographic security, a higher security level, which allows you to set the
Authentication password and the Encryption password.
■ Security name: According to your NMS settings, choose Read/Write or Read Only and enter the
community name.
■ Authentication type: Select MD5 or SHA as the authentication method.
■ Authentication password: Enter the password for authentication (at least 8 characters).
■ Encryption password: Enter a password for encryption (at least 8 characters).
VIVOTEK
User's Manual - 113
You can FTP the camera’s IP address to download videos recorded in the SD card, or use the “http://ip/
cgi-bin/admin/lsctrl.cgi?cmd=search” command to examine the recorded les on your SD card.
Tips:
Network > FTP
The newer firmware disabled the FTP port for security concerns. You can manually enable the FTP
server service to enable the FTP function. You can disable the FTP server function when it is not in use.
FTP port: The FTP server allows the user to save recorded video clips. You can utilize VIVOTEK's
Shepherd utility to upgrade the rmware via FTP server. By default, the FTP port is set to 21. It can also
be assigned to another port number between 1025 and 65535.
SFTP:
This is the embedded SFTP client. Host Key: A host key is the SFTP server's public key.
Ensuring the SFTP server is validated is an important aspect of the SFTP protocol. It is
designed to protect against man-in-the-middle attacks where the hacker intercepts and relays
an impersonated message to the other party.
Click the
Save
button and the camera SFTP server MD5 key will display. The default format is
ED25519 and RSA.
VIVOTEK
114 - User's Manual
Bonjour
To access the camera from a Mac computer, go to Safari, click on Bonjour and select the camera from a
drop-down list.
You can go to Safari > Preferences to enter your user name and password, and provide the root
password the rst time you access the camera. The camera main page will open in your browser.
Some later iOSes may come without the Bonjour option. Install the Discovery utility instead.
Find the Discovery (formerly Bonjour Browser) from the Mac App Store.
Discovery is a utility that displays all the Bonjour services on your local network or on Wide-Area Bonjour
domains. The utility is previously called Bonjour Browser, it is now distributed on the Mac App Store.
Discovery requires macOS 10.12 or higher. For older versions of Mac OS you can download the old
version of Bonjour Browser.
Bonjour Browser (obsolete)
http://www.tildesoft.com/les/BonjourBrowser.dmg - Version 1.5.6
Discovery for iOS
https://itunes.apple.com/us/app/discovery-dns-sd-browser/id305441017?mt=8
VIVOTEK
User's Manual - 115
Security > User accounts
This section explains how to enable password protection and create multiple accounts.
Account management
The administrator account name is “root”, which is permanent and can not be deleted. If you want to add
more accounts in the Account management window, please apply the password for the “root” account
rst.
The administrator can create up to 20 user accounts.
To create a new user,
1. Click to unfold the pull-down menu. Select
New user
.
2. Enter the new user’s name and password. Type the password identically in both text boxes.
Some, but not all special ASCII characters are supported: !, $, %, -, ., @, ^, _, and ~.
You can use them in the password combination.
The strength of your password combination is shown on the right, use the combination of alphabetic,
numeric, upper case, and lower case characters until the password strength is good enough.
3. Select the privilege level for the new user account. Click
Add
to enable the setting.
The privilege levels are listed below:
Administrator Full control
Operator Controls snapshot, screen, audio, and PTZ;
unable to enter the camera Conguration page.
Viewer Control snapshot, screen, audio, and PTZ.
Access rights are sorted by user privilege (Administrator, Operator, and Viewer). Only administrators
can access the Conguration page. Although operators cannot access the Conguration page, they can
use the URL Commands to get and set the value of parameters. For more information, please refer to
URL Commands of the Network Camera on page 179. Viewers can only access the main page for live
viewing.
Here you can also change a user’s access rights or delete user accounts.
1. Select an existing account to modify.
2. Make necessary changes and click
Update
or
Delete
to enable the setting.
VIVOTEK
116 - User's Manual
Privilege management
Digital Output & PTZ control: You can modify the management privilege as operators or viewers. Select
or de-select the checkboxes, and then click
Save
to enable the settings. If you give Viewers the privilege,
Operators will also have the ability to control the Network Camera through the main page. (Please refer
to Conguration on page 40).
Account block
Locking out users after too many consecutive unsuccessful login attempts. This helps ensure the security
from malicious attack.
By limiting the number of times a user can attempt to log in, we can lock the user account, e.g.,
after 5 consecutive failed attempts. You can also lock the account for 30 minutes if there have
been 5 consecutive unsuccessful attempts to log in.
VIVOTEK
User's Manual - 117
Security > HTTPS
(Hypertext Transfer Protocol over SSL/TLS)
This section explains how to enable authentication and encrypted communication over SSL
(Secure Socket Layer). It helps protect streaming data transmission over the Internet on higher
security level.
Create and Install Certicate Method
Before using HTTPS for communication with the Network Camera, a
Certicate
must be created rst.
There are three ways to create and install a certicate:
Create self-signed certificate
1. Select this option from a pull-down menu.
2. In the rst column, select
Enable HTTPS secure connection
, then select a connection option: “HTTP
& HTTPS” or “HTTPS only”.
3. Click
Create certicate
to generate a certicate.
4. The Certicate Information will automatically be displayed as shown below. You can click
Certicate
properties
to view detailed information about the certicate.
VIVOTEK
118 - User's Manual
https://192.168.5.151/index.html
https://
5. Click
Save
to preserve your conguration, and your current session with the camera will change to the
encrypted connection.
6. If your web session does not automatically change to an encrypted HTTPS session, click
Home
to re-
turn to the main page. Change the URL address from “http://” to “https://“ in the address bar and press
Enter
on your keyboard. Some Security Alert dialogs will pop up. Click
OK
or
Yes
to enable HTTPS.
VIVOTEK
User's Manual - 119
Create certificate request and install
1. Select the option from the
Method
pull-down menu.
2. Click
Create certicate
to proceed.
3. The following information will show up in a pop-up window after clicking
Create
. Then click
Save
to
generate the certicate request.
You can also select a upload a self-provided certicate and a private key. Select the upload option
from the pull-down menu, and select the les to upload.
4. The Certicate request window will prompt.
Loading page 120...
VIVOTEK
User's Manual - 121
5. Look for a trusted certificate authority, such as Symantec’s VeriSign Authentication Services, that
issues digital certificates. Sign in and purchase the SSL certification service. Copy the certificate
request from your request prompt and paste it in the CA’s signing request window. Proceed with the
rest of the process as CA’s instructions on their webpage.
6. Once completed, your SSL certicate should be delivered to you via an email or other means. Copy
the contents of the certicate in the email and paste it in a text/HTML/hex editor/converter, such as
IDM Computer Solutions’ UltraEdit.
Loading page 122...
VIVOTEK
User's Manual - 123
9. Save the edit using the “.crt” extension, using a le name like “CAcert.crt.”
10. Return to the original rmware session, use the
Browse
button to locate the crt certicate le, and
click
Upload
to enable the certication.
VIVOTEK
124 - User's Manual
11. When the certifice file is successfully loaded, its status will be stated as
Active
.
Note that a
certicate must have been created and installed before you can click on the “
Save
" button for
the conguration to take eect.
12.To begin an encrypted HTTPS session, click
Home
to return to the main page. Change the URL ad-
dress from “http://” to “https://“ in the address bar and press
Enter
on your keyboard. Some Security
Alert dialogs will pop up. Click
OK
or
Yes
to enable HTTPS.
VIVOTEK
User's Manual - 125
Security > Access List
Filter
Enable access list ltering: Check this item and click
Save
if you want to enable the access list
ltering function.
Filter type: Select
Allow
or
Deny
as the lter type. If you choose
Allow Type
, only those clients
whose IP addresses are on the Access List below can access the Network Camera, and the others
cannot. On the contrary, if you choose
Deny Type
, those clients whose IP addresses are on the
Access List below will not be allowed to access the Network Camera, and the others can.
Then you can
Add
a rule to the following Access List. Please note that the IPv6 access list column
will not be displayed unless you enable IPv6 on the Network page. For more information about
IPv6 Settings
, please refer to Network > General settings on page 80 for detailed information.
VIVOTEK
126 - User's Manual
Network: This rule allows the user to assign a network address and corresponding subnet mask to
the Allow/Deny List. The address and network mask are written in CIDR format.
For example:
Range: This rule allows the user to assign a range of IP addresses to the Allow/Deny List.
Note: This rule only applies to IPv4 addresses.
For example:
Administrator IP address
Always allow the IP address to access this device: You can check this item and add the
Administrator’s IP address in this eld to make sure the Administrator can always connect to the
device.
IP address range 192.168.2.x will be bolcked.
There are three types of rules:
Single: This rule allows the user to add an IP address to the Allowed/Denied list.
For example:
192.168.2.1
If IPv6 lter is preferred, you will be prompted by the following window. Enter the IPv6 address and
the two-digit prex length to specify the range of IP addresses in your conguration.
VIVOTEK
User's Manual - 127
Security > IEEE 802.1x
Enable this function if your network environment uses IEEE 802.1x, which is a port-based network
access control. The network devices, intermediary switch/access point/hub, and RADIUS server must
support and have their 802.1x settings enabled.
The 802.1x standard is designed to enhance the security of local area networks, which provides
authentication to network devices (clients) attached to a network port (wired or wireless). If all certicates
between client and server are veried, a point-to-point connection will be enabled; if authentication fails,
access on that port will be prohibited. 802.1x utilizes an existing protocol, the Extensible Authentication
Protocol (EAP), to facilitate communication.
■
The components of a protected network with 802.1x authentication:
1.
Supplicant: A client end user (camera), which requests authentication.
2.
Authenticator (an access point or a switch): A “go between” which restricts unauthorized end users
from communicating with the authentication server.
3.
Authentication server (usually a RADIUS server): Checks the client certicate and decides whether to
accept the end user’s access request.
■
VIVOTEK Network Cameras support two types of EAP methods to perform authentication:
EAP-PEAP
and
EAP-TLS
.
Please follow the steps below to enable 802.1x settings:
1. Before connecting the Network Camera to the protected network with 802.1x, please apply a digital
certificate from a Certificate Authority (i.e., network administrator of your company) which can be
validated by a RADIUS server.
2. Connect the Network Camera to a PC or notebook outside of the protected LAN. Open the
conguration page of the Network Camera as shown below. Select
EAP-PEAP
or
EAP-TLS
as the
EAP method. In the following blanks, enter your ID and password issued by the CA, then upload
related certicate(s).
Supplicant
(Network Camera)
Authenticator
(Network Switch)
Authentication Server
(RADIUS Server)
Loading page 128...
VIVOTEK
User's Manual - 129
Security > Miscellaneous
The embedded TrendMicro utitlity provides the protection against Cross-Site Request
Forgery. Cross-site request forgery is also known as one-click attack or session riding and is
abbreviated as CSRF. CSRF is a type of malicious exploit of a website, in this case, the camera.
Unauthorized commands are transmitted from a user that the web application trusts, using the
mechanism of forging a trusted user's own request with a request containing his own cookies,
etc. Dierent ways can be used for a malicious website to transmit such commands. They can
be specially-crafted image tags, hidden forms, and JavaScript XMLHttpRequests. The malicious
attack can occur without users' interaction or even knowing it.
Enable session timeout: Session timeout is an option that is used to determine how long
a device may remain authenticated on a connection with a camera before it must perform
authentication again. The default is that session does not time out and once a device is
authorized it may remain there until the device disconnects, or a timeout is issued for the device.
VIVOTEK
130 - User's Manual
PTZ > PTZ settings
This section explains how to control the Network Camera’s Pan/Tilt/Zoom operation. The
camera comes with built-in PTZ mechanisms.
Home location settings
Move your current field of view to a preferred location using the PTZ panel or mouse clicks
on the screen, and use the below buttons to configure the current view as the default home
position. You can also restore the home posiotion to the factory default, which is approximately
45 degree looking down with the lens lined up with the VIVOTEK logo.
Patrol list
This column displays the congured patrols. Note that only one patrol can apply at a time. Use
the ON/OFF buttons to enable or disable an existing patrol.
Use the buttons below to create a
recorded patro
l or a
preset patrol
.
VIVOTEK
User's Manual - 131
Recorded Patrol
The recorded patrol allows you to record the process moving along interested points (positions)
in your surveillance area while the camera memorizes every Pan/Tilt/Zoom/Focus commands
you gave in the process. You can then save the process as a recorded patrol. Due to the
limitation on system memory, you can configure 4 recorded patrols, each with a length of 2
minutes.
P5
P2
P4
Stop points
P1
P6
P7
P8
P9
P3
Loading page 132...
Loading page 133...
VIVOTEK
134 - User's Manual
Zoom In
Zoom Out
Click and hold down the
button to continue turning
Click to bring to
center of view
Misc. settings:
Use the checkboxes and the pull-down menus for the camera to automatically resume the previous
action or return to the home position after the camera has stayed idle for a period of time.
PTZ control panel operation mode: This determines how your mouse and PTZ control panel works on a
live view window.
The
Continuous move
allows your screen control action to continue as long as you click and hold down
the left mouse button. For example, if you click on the left button on the PTZ control panel, the camera's
view should continuously rotate to the left until you release the button. The same applies to arrow keys,
Zoom, and Focus buttons on the PTZ panel. If you select
Click to move
, every single mouse click takes
eect for once without the ensuing move.
Note that if your screen control malfunctions, it is possible that the CPU of your current view station can
not cope with the HD video feeds or that an incompatibility issue occurred with the ActiveX control plug-
ins.
Loading page 135...
VIVOTEK
136 - User's Manual
Positions on the Home page
The
Preset positions
will also be displayed on the home page. Select one from the Go to drop-down
list, and the Network Camera will move to the selected position.
Pan button: Click this button to start the 360
°
horizontal auto pan.
Patrol button: Click this button, then the Network Camera will patrol continuously among the selected
positions. You can select to perform a Preset patrol or a Recorded tour patrol.
Pan button
Patrol button
PTZ > Calibrate
This function re-calibrates the home position to the default center to recover any displacement caused by
external forces. Please note that there is no conrm message after using the function, and the calibration
immediately takes place. If, after a long use, a user nds it is dicult to move camera’s eld of view to a
specic point, use this function to restore the camera’s orginal coordinates in pan and tilt motions.
You can use the Save button to save the current position as Home, as a preset, or to the existing preset.
VIVOTEK
User's Manual - 137
Event > Event settings
This section explains how to congure the Network Camera to responds to particular situations
(event). A typical application is that when a motion is detected, the Network Camera sends
buffered images to an FTP server or e-mail address as notifications. Click on
Help
, there is
an illustration shown in the pop-up window explaining that an event can be triggered by many
sources, such as motion detection or external digital input devices. When an event is triggered,
you can specify what type of action will be performed.
Event
An event is an action initiated by a user-dened trigger source. In the
Event
column, click
Add
to open
the event settings window.
VIVOTEK
138 - User's Manual
■ Event name: Enter a name for the event setting.
■ Enable this event: Select this option to enable the event setting.
■ Priority: Select the relative importance of this event (High, Normal, or Low). Events with a higher
priority setting will be executed rst.
■ Detect next motion detection or digital input after seconds: Enter the duration in seconds to pause
motion detection after a motion is detected.
Follow the steps 1~3 to arrange the three elements -- Schedule, Trigger, and Action to configure an
action to take when an event is triggered. You can congure 3 event-triggered conditions.
1. Schedule
Specify the time span for the event-triggering condition. Please select the days of the week and the time
in a day (in 24-hr time format) for the recording schedule.
2. Trigger
This is the cause or stimulus which denes when to trigger the Network Camera. The trigger source can
be congured to use the Network Camera’s built-in motion detection mechanism or external digital input
devices.
There are several choices of trigger sources as shown below.
Select the item to display the detailed
conguration options.
■ Video motion detection
This option makes use of the built-in motion detection mechanism as a trigger source. To enable this
function, you need to congure a Motion Detection Window rst. For more information, please refer to
Motion Detection on page 156 for details.
■ Periodically
This option allows the Network Camera to trigger periodically for every other dened minute. Up to 999
minutes are allowed.
■ Digital input
This option allows the Network Camera to use an external digital input device or sensor as a trigger
source. Depending on your application, there are many choices of digital input devices on the market
which helps to detect changes in temperature, vibration, sound, and light, etc.
■ System boot
This option triggers the Network Camera when the power to the Network Camera is disconnected and
reconnected.
■ Recording notify
This option allows the Network Camera to trigger when the recording disk is full or when recording
starts to rewrite older data.
VIVOTEK
User's Manual - 139
■ Audio detection
A preset threshold can be congured with an external microphone as the trigger to system event. The
triggering condition can be an input exceeding or falling below a threshold. Audio detection can take
place as a complement to motion detection or as a method to detect activities not covered by the
camera's view. Please refer to page 160
Applications
>
Audio detection
for more details.
Once you have a preset audio alarm level, you can dene the triggering condition either as an audio
input rises above or falls below the alarm level.
■ VADP
It is presumed that you already uploaded and enabled the VADP modules before you can associatee
VADP triggers with an Event setting.
Click on the Set VADP Trigger button to open the VADP setup menu. The triggering conditions
available with 3rd-party software modules known as VADP will be listed. Use the arrow buttons to
select these triggers. Users may implant these modules for different purposes such as triggering
motion detection, or applications related to video analysis, etc. Please refer to page 164 for the
conguration options with VADP modules.
■ Manual triggers
An event can be manually triggered by the manual trigger buttons on the main page.
■ Camera tampering detection
This option allows the Network Camera to trigger when the camera detects that is is being tampered
with. To enable this function, you need to congure the Tampering Detection option rst. Please refer
to page 161 for detailed information.
■ Preset reached
A triggering condition when the camera maneuvers into a preset position.
Loading page 140...
VIVOTEK
User's Manual - 141
■ Congure CameraLink
The camera can be associated with another camera with responsive actions. For example, if a thermal
camera detects some abnormal situations, e.g., a re, the camera can tell another camera, say, a PTZ
camera to move to a preset position to observe the current situation.
The camera link can be considered as having one spotter camera and one action camera.
Open a conguration window by clicking the Congure camera link.
Enter the address, credentials of the peer camera. You can click Test to test the connection.
VIVOTEK
142 - User's Manual
The connected camera will appear.
On the Action window, the Camera link action option will appear.
You can then congure the action to take eect when a trigger occurs on the current camera.
VIVOTEK
User's Manual - 143
On the action camera, you can congure a Smart tracking window. Please refer to the Smart tracking
advanced User Manual.
VIVOTEK
144 - User's Manual
NOTE:
Motion detection
window
Current field of view
If you congured a motion detection window as a trigger, the motion detection may become invalid when
the camera’s eld of view moved away from the detection window.
You can let camera return to the motion detection position to detect the coming event by re-conguring
your Home position in
PTZ > PTZ settings
(see page 131) or turn the camera to a preset position.
VIVOTEK
User's Manual - 145
Add server
It is necessary to congure the server and media settings so that the Network Camera will know what
action to take (such as which server to send the media les to) when a trigger is activated. Click
Add
server
to open the server setting window. You can specify where the notication messages are sent to
when a trigger is activated. A total of 5 server settings can be congured.
There are four choices of server types available: Email, FTP, SFTP, and HTTP.
Select the item to display
the detailed conguration options. You can congure either one or all of them.
Server type - Email
Select to send the media les via email when a trigger is activated.
■ Server name: Enter a name for the server setting.
■ Sender email address: Enter the email address of the sender.
■ Recipient email address: Enter the email address of the recipient.
■ Server address: Enter the domain name or IP address of the email server.
■ User name: Enter the user name of the email account if necessary.
■ Password: Enter the password of the email account if necessary.
■ Server port: The default mail server port is set to 25. You can also manually set another port.
If your SMTP server requires a secure connection (SSL), check
This server requires a secure
connection (SSL).
VIVOTEK
146 - User's Manual
To verify if the email settings are correctly congured, click
Test
. The result will be shown in a pop-up
window. If successful, you will also receive an email indicating the result.
Click
Save
server
to enable the settings, then click
Close
to exit the Add server page.
After you set up the first event server, a new item for event server will automatically show up on the
Server list. If you wish to add more server options, click
Add server
.
Server type - FTP
Select to send the media les to an FTP server when a trigger is activated.
■ Server name: Enter a name for the server setting.
■ Server address: Enter the domain name or IP address of the FTP server.
■ Server port: By default, the FTP server port is set to 21. It can also be assigned to another port number
between 1025 and 65535.
■ User name: Enter the login name of the FTP account.
■ Password: Enter the password of the FTP account.
■ FTP folder name
Enter the folder where the media le will be placed. If the folder name does not exist, the Network
Camera will create one on the FTP server.
VIVOTEK
User's Manual - 147
■ Passive mode
Most firewalls do not accept new connections initiated from external requests. If the FTP server
supports passive mode, select this option to enable passive mode FTP and allow data transmission to
pass through the rewall.
To verify if the FTP settings are correctly congured, click
Test
. The result will be shown in a pop-up
window as shown below. If successful, you will also receive a test.txt le on the FTP server.
Click
Save
server
to enable the settings, then click
Close
to exit the Add server page.
Server type - SFTP
Select to send the media files to an SFTP (Secure File Transfer Protocol) server when a trigger is
activated. This page contains the client side settings.
■ Server address: Enter the SFTP server address in either the domain name or IP address.
■ Server port: By default, the FTP server port is set to 22. It can also be assigned to another port number
between 1025 and 65535.
■ Host key MD5: You have the option to use public/private key authentication instead of a username and
password to connect to the server. This option requires that you have a private/public SSH key pair,
and that the public key is in place on your SFTP server.
If you wish to Use key authentication for this SFTP server, click the
Get
(Read Fingerprint) button to
request the public key ngerprint from the server. The host key MD5 is a hash of the FTP server’s
public key, which the camera stores in order to verify that it is connecting to the correct SFTP server.
You can copy that ngerprint and save it for later reference.
The max. length of MD5 ngerprint is 47 characters.
Loading page 148...
VIVOTEK
User's Manual - 149
Publickey mode:
Selecting the
Public key
mode will bring up the
Pairing mode
options: Auto, Download, Upload.
Auto
Camera will generate a key pair and auto pair public key with the SFTP server.
Download
Camera will generate a key pair and download the public key for the user to upload
it to the SFTP server. The supported formats are: ED25519 (default. Elliptic curve
signature scheme Edwards-curve Digital Signature Algorithm; with faster key
creation, encryption and decryption), RSA (Rivest–Shamir–Adleman, with greater
portability), ECDSA (Elliptic Curve Digital Signature Algorithm).
Upload
Upload the private key here and upload the public key to the SFTP server.
A private key is a guarded secret and it can be stored on disk in an encrypted
form. A passphrase is used in order to decrypt it. It is a login password to the SSH
server, the passphrase is only used to decrypt the private key on the local system.
The passphrase is not transmitted over the network.
When using SFTP, you can authenticate using a public/private SSH key pair instead of a password.
If key authentication is not enabled, you need to specify a password instead. The administrator of the
SFTP server will need to manually add the corresponding public key to the SFTP server.
The key benefit of a key-based authentication is that instead of a using a password, you are less
vulnerable to brute-force attacks and you do not expose valid credentials, if the server has been
compromised.
Loading page 150...
VIVOTEK
User's Manual - 151
Network storage:
Select to send the media les to a network storage location when a trigger is activated. Please refer to
NAS server
on page 159 for details.
Click
Save
server
to enable the settings, then click
Close
to exit the Add server page.
■ SD Test: Click to test your SD card. The system will display a message indicating success or failure. If
you want to use your SD card for local storage, please format it before use. Please refer to page 172
for detailed information.
Loading page 152...
VIVOTEK
User's Manual - 153
■ Add date and time sux to the le name
Select this option to add a date/time sux to the le name.
For example:
Click
Save media
to enable the settings, then click
Close
to exit the Add media page.
After you set up the rst media server, a drop-down menu of existing medias will be available on the
Media list. If you wish to add more media options, click
Add media
again.
Media type -
Video clip
Select to send video clips when a trigger is activated.
■ Media name: Enter a name for the media setting.
■ Source: Select a video stream prole as the source of video clip.
■ Pre-event recording
The Network Camera has a buffer to temporarily hold data up to a certain limit. Enter a number to
decide the duration of recording before a trigger is activated. Up to 9 seconds can be set.
Snapshot_20210320_100341
Date and time suffix
The format is: YYYYMMDD_HHMMSS
File name prefix
Loading page 154...
VIVOTEK
User's Manual - 155
■ View: Click this button to open a file list window. This function only apllies when an SD card and
networked storage are available.
If you click
View
button of SD card, a Local storage page will pop up for you to manage recorded les
on SD card. For more information about Local storage, please refer to page 172. If you click
View
button of Network storage, a le directory window will pop up for you to view recorded data on Network
storage.
■ Create folders by date, time, and hour automatically: If you check this item, the system will
automatically create sub-folders named by the date.
The following is an example of a le destination with recorded video clips:
Click
20210320
to open the directory:
Video Clip_59.mp4
Video Clip_58.mp4
2021/03/20
2021/03/20
Click to delete
selected items
Click to delete all
recorded data
Click to go back to the previous
level of the directory
The format is: HH (24r)
Click to open the le list for that hour
Video Clip_59.mp4
Video Clip_58.mp4
2021/03/20
2021/03/20
The format is: File name prex + Minute (mm)
You can set up the le name prex on Add media page.
20210320
20210321
20210322
Click to delete selected items
Click to delete all recorded data
The format is: YYYYMMDD
Click to open the directory
VIVOTEK
156 - User's Manual
Here is an example of the Event setting:
When completed the settings with steps 1~3 to arrange Schedule, Trigger, and Action of an event, click
Save event
to enable the settings and click
Close
to exit the page.
The following is an example of the Event setting page:
VIVOTEK
User's Manual - 157
When the Event Status is
ON
, once an event is triggered by motion detection, the Network Camera will
automatically send snapshots via e-mails.
If you want to stop the event trigger, you can click
ON
to turn it to
OFF
status or click
Delete
to remove
the event setting.
To remove a server setting from the list, select a server name and click
Delete
. Note that you can only
delete a server setting when the server setting is currently not applied to an event setting.
To remove a media setting from the list, select a media name and click
Delete
. Note that you can only
delete a media setting when the media setting is currently not applied to an event setting.
VIVOTEK
158 - User's Manual
Motion Detection Setting 2:
For special situations
Motion Detection Setting 1:
For normal situations
Applications > Motion detection
This section explains how to congure the Network Camera to enable motion detection. A total
of 5 motion detection windows can be congured.
Follow the steps below to enable motion detection:
1. Click
New
to add a new motion detection window.
2. In the Window Name text box, enter a name for the motion detection window.
■ Use 4 mouse clicks to designate a detection window. You can change the window shape by dragging
the corner marks to a preferred location.
■ Drag the item size tab to change the minimum size of item to trigger an alarm. An item size box will
appear in the center of screen for your reference (in semi-transparent red). An intruding object must
be larger than the Item size to trigger an alarm. Change the item size according to the live view.
■ To delete a window, click the X mark on the right of the window name.
3. Dene the sensitivity to moving objects by moving the Sensitivity slide bar. Note that a high sensitivity
is prone to produce false alarms such as the fast changes of light (such as day/night mode switch,
turning lights on/o). A movement must persist longer than 0.3 second for the motion to be detected.
4. Click
Save
to enable the settings.
5. Select
Enable motion detection
to enable this function.
For example:
The Percentage Indicator will rise or fall depending on the variation between sequential images. When
motions are detected by the Network Camera and are considered to exceed the preset threshold, the red
bar rises. Meanwhile, the motion detection window will be outlined in red.
VIVOTEK
User's Manual - 159
A green bar indicates that even though motions have been detected, the event has not been triggered
because the image variations still fall under the preset threshold.
If you want to congure other motion detection settings for day/night/schedule mode (e.g., for a dierent
lighting condition), please click
Profile
to open the Motion Detection Profile Settings page as shown
below. Another three motion detection windows can be congured on this page.
Larger than the
min. item size
Photos or videos can be captured instantly and congured to be sent to a remote server (via an Email or
FTP server). For more information on how to congure an event setting, please refer to Event settings on
page 138.
Please follow the steps beolw to set up a prole:
1. Create a new motion detection window.
2. Click the
Prole mode
tab.
3. Select the applicable Schedule mode. Please manually enter a time range.
4. Click
Save
to enable the settings and click
Close
to exit the page.
Loading page 160...
Loading page 161...
VIVOTEK
162 - User's Manual
Applications > DI and DO
Digital input: Select High or Low to dene normal status for the digital input. Connect a digital input from
a sensor device to the camera, the Network Camera will report the current signal status. You may then
congure the Normal status (non-trigger status) as High or Low.
Digital output: Select Normally Closed or Normally Open to dene normal status for the digital output.
Connect an output line to an external device, the Network Camera will report the current signal status.
You may then congure the Normal status (non-trigger status).
Set up the event source as DI on
Event > Event settings > Trigger.
Please refer to page 139 for
detailed information.
VIVOTEK
User's Manual - 163
Applications > Tampering detection
This section explains how to set up camera tamper detection. With tamper detection, the
camera is capable of detecting incidents such as
redirection
,
blocking or defocusing
, or even
spray paint
.
Please follow the steps below to set up the camera tamper detection function:
1. Click to select the checkbox before tampering conditions: Tampering detection, Image too
dark, Image too bright, and Image too blurry. Enter the tamper trigger duration. (10 sec. ~ 10
min.). The duraction species the set of time before the tampering is considered as a real
alarm. This helps avoid false alarms by short-lived changes.
The tamper alarm will be triggered only when the tampering factor (the dierence between
current frame and pre-saved background) exceeds the trigger threshold. Conditions such
as image too dark, too bright, or too blurry (defocused) can also be congured as tampering
conditions. The Trigger threshold determines how sensitive your is tamper detection setting.
Lower the threshold number, easier to trigger.
Too bright: shining a flash light. The average lighting level of the scene is taken into
consideration.
Too dark: covering the objective or spraying paint.
Too blurry: blurry scene can be the result of strong interference on the device, such as EMI
interference.
2. You can configure Tampering Detection as a trigger element to the proactive event
configurations in
Event -> Event settings -> Trigger.
For example, when the camera is
tampered with, camera can be congured to send the pre- and post-event video clips to a
networked storage device. Please refer to page 140 for detailed information.
VIVOTEK
164 - User's Manual
Applications > Audio detection
Audio detection, along with video motion detection, is applicable in the following scenarios:
1. Detection of activities not covered by camera view, e.g., a loud input by gun shots or breaking a door/
window.
2. A usually noisy environment, such as a factory, suddenly becomes quiet due to a breakdown of
machines.
3. A PTZ camera can be directed to turn to a preset point by the occurrence of audio events.
4. Dark environments where video motion detection may not function well.
The red circles indicate where the audio alarms can be triggered when breaching or falling below the
preset threshold.
How to congure Audio detection:
1. Once the Audio detection window is opened, the current sound input will be interactively indicated
by a uctuating yellow wave diagram.
2. Use a mouse click to drag the Alarm level tab to a preferred location on the slide bar.
3. Select the “Enable audio detection“ checkbox and click Save to enable the feature.
1. Note that the volume numbers (0~100) on the side of wave diagram does not represent decibel (dB).
Sound intensity level has already been mapped to preset values. You can, however, use the real-
world inputs at your installation site that are shown on the wave diagram to congure an alarm level.
2. To configure this feature, you must not mute the audio in Configuration > Media > Audio.
The default of the camera can be muted due to the lack of an internal microphone. An external
microphone is provided by users.
NOTE:
VIVOTEK
User's Manual - 165
IMPORTANT:
• If the Alarm level and the received volume are set within a range of 20% on the wave
diagram, frequent alarms will be triggered. It is recommended to set the Alarm level farther
apart from the detected sound level.
• To configure and enable this feature, you must not configure video stream #1 into motion
jpeg. If an external microphone input is connected and recording of audio stream is
preferred, audio stream is transmitted between camera and viewer/recording station along
with stream #1.
• Refer to page 92 for Audio settings, and page 84 for video streaming settings.
You can use the
Prole
window to congure a dierent Audio detection setting. For example, a place can
be noisy in the day time and become very quiet in the night.
1. Click on the
Enable this prole
checkbox. Once the Audio detection window is opened, the current
sound input will be interactively indicated by a uctuating yellow wave diagram.
2. Use a mouse click to drag the
Alarm level
tab to a preferred location on the slide bar.
3. Select the
Day
,
Night
, or
Schedule
mode check circles. You may also manually congure a period
of time during which this prole will take eect.
4. Click
Save
and then click
Close
to complete your conguration.
VIVOTEK
166 - User's Manual
Applications > Package management - a.k.a., VADP (VIVOTEK
Application Development Platform)
The Smart Motion detection, with Human detection and tunable time lter, can eliminate
the defects of traditional motion detection and facilitate the conguration at a surveillance
site.
Users can store and execute VIVOTEK's or 3rd-party software modules onto the camera's
flash memory or SD card. These software modules can apply in video analysis for
intelligent video applications such as object counting, or as an agent for edge recording,
etc.
• Once the software package is successfully uploaded, the module conguration (vadp.
xml) information is displayed. When uploading a module, the camera will examine
whether the module fits the predefined VADP requirements. Please contact our
technical support or the vendor of your 3rd-party module for the parameters contained
within.
• The le system of SD card (FAT32) does not support soft (symbolic) link. It will return
failure if your module tries to create soft links on SD card.
VIVOTEK
User's Manual - 167
To start a module, select the checkcircle in front, and click the
Start
button.
If you should need to remove a module, select the checkcircle in front and then click the
Stop
button. By then the module status will become
OFF
, and the
X
button will appear at the end of
the row. Click on the
X
button to remove an existing module.
When prompted by a conrm message, Click
Yes
to proceed.
Yes
No
Note that the actual memory consumed while operating the module will be indicated on the
Memory status
eld. This helps determine whether a running module has consumed too much
of system resources.
To utilize a software module, acquire the software package and click
Browse
and
Upload
buttons. The screen message for a successful upload is shown below:
Loading page 168...
Loading page 169...
VIVOTEK
170 - User's Manual
If you enable adaptive recording and enable time-shift cache stream on Camera A, only when an event
is triggered on Camera A will the server record video streams in the full frame rate; otherwise, it will only
request the I frame data during normal monitoring, thus eectively save lots of bandwidth and storage.
The alarm trigger includes: motion detection and DI detection. Please refer to Event Settings on page 118.
■ Pre-event recording and post-event recording
The Network Camera has a buer that temporarily holds data for a period of time. Therefore, when an
event occurs, the camera can restrieve image frames taken several seconds ago. Enter a number to
dene the duration of recording before and after a trigger is activated.
■ Priority: Select the relative importance of this recording (High, Normal, or Low). Recording with a higher
priority setting will be executed rst.
■ Source: Select a video prole as the recording source.
► To enable recording notication, please congure
Event
settings
rst. Please refer to page 138.
Please follow steps 1~2 below to set up the recording:
1. Trigger
Select a trigger source.
■ Schedule: The server will start to record les on the local storage or to a networked storage device
(NAS).
■ Network fail: Since the time when the network fails, the server will start to record files on the local
storage (SD card).
Time
Bandwidth
Bandwidth
Activity Adaptive Streaming
for Dynamic Frame Rate Control
I frame ---> Full frame rate ---> I frame
Continuous recording
► To enable adaptive recording, please make sure
you’ve set up the trigger source such as Motion
Detection, DI Device, or Manual Trigger.
► When there is no alarm trigger:
- JPEG mode: record 1 frame per second.
- H.265 or H.264 mode: record I frame only.
► When the I frame period is >1s on Video settings
page, it should be forced to make the I frame period
to 1s when adaptive recording is activated.
NOTE:
NOTE:
VIVOTEK
User's Manual - 171
2. Destination
You can select the SD card or network attached storage (NAS) for recording video les.
NAS server
Click
Add NAS server
to open the server setting window and follow the steps below to set up:
1. Fill in the information for your server.
For example:
2. Click
Test
to check the setting. The result will be shown in the pop-up window.
1
2 4
Network storage path
(\\server name or IP address\folder name)
User name and
password for your
server
3
VIVOTEK
172 - User's Manual
If successful, you will receive a test.txt le on the network storage server.
3. Enter a server name.
4. Click
Save
to complete the settings and click
Close
to exit the page.
■ Capacity: You can choose either the entire free space available or limit the reserved space. The
recording size limit must be larger than the reserved amount for cyclic recording. The reserved space
is a small amount of space used only for the transaction stage when the capacity is about to be used
up or recycled.
■ Enable cyclic storage: If you check this item, when the maximum capacity is reached, the oldest le
will be overwritten by the latest one. The reserved amount is reserved for the transaction stage when
the storage space is about to be full and new data arrives. The minimum for the Reserved space must
be larger than 15 MegaBytes.
■ Recording file management: You can manually assign the Maximum duration and the Maximum
file size for each recording footage. You may need to stitch individual files together under some
circumstances. You may also designate a le name prex by lling in the responsive text eld.
VIVOTEK
User's Manual - 173
If you want to enable recording notication, please click
Event
to set up. Please refer to
Event > Event
settings
on page 138 for more details.
When completed, select
Enable this recording
. Click
Save
to enable the setting and click
Close
to exit
this page. When the system begins recording, it will send the recorded les to a networked storage or SD
card. The new recording name will appear on the recording page as shown below.
To remove a recording setting from the list, select it and click
Delete
.
■
Video (Name)
: Click to open the Recording settings page to modify its details.
■
ON (Status)
: Click to manually adjust the Status. (
ON
: start recording;
OFF
: stop recording)
■
NAS or SD (Destination)
: Click to open the le list of recordings as shown below. For more information
about folder naming rules, please refer to page 153 or page 119 for details.
Loading page 174...
VIVOTEK
User's Manual - 175
SD card control
■ Enable cyclic storage: Check this item if you want to enable cyclic recording. When the maximum
capacity is reached, the oldest le will be overwritten by the latest one.
■ Enable automatic disk cleanup: Check this item and enter the number of days you wish to retain a le.
For example, if you enter “7 days”, the recorded les will be stored on the SD card for 7 days.
■ Maximum duration for keeping les: Enter the life span of recorded footages.
Click
Save
to enable your settings.
Storage > NAS management
NAS Setup
Click
NAS management
tab to open the server setting window and follow the steps below to set up:
1. Fill in the information for the access to the shared networked storage.
For example:
\\192.160.5.122\NAS
vivotek
rita.li
admin
Loading page 176...
VIVOTEK
User's Manual - 177
Storage > Content management
This section explains how to manage the content of recorded videos on the Network Camera. Here you
can search and view the records and view the searched results.
Searching and Viewing the Records
This column allows the user to set up search criteria for recorded data. If you do not select any criteria
and click
Search
button, all recorded data will be listed in the
Search Results
column.
■ File attributes: Select one or more items as your search criteria.
■ Trigger time: Manually enter the time range you want to search for contents created at a specic point
in time.
Click
Search
and the recorded data corresponding to the search criteria will be listed in
Search Results
window.
VIVOTEK
178 - User's Manual
Search Results
The following is an example of search results. There are four columns: Trigger time, Media type, Trigger
type, and Locked. Click to sort the search results in either direction.
Numbers of entries displayed
on one page
Click to open a live view
■ Play: Click on a search result which will highlight the selected item. A Play window will appear on top
for immediate review of the selected le.
For example:
■ Download: Click on a search result to highlight the selected item in purple as shown above. Then click
the
Download
button and a le download window will pop up for you to save the le.
■ JPEGs to AVI: This function only applies to “JPEG“ format files such as snapshots. You can select
several snapshots from the list, then click this button. Those snapshots will be converted into an AVI
le.
Loading page 179...
VIVOTEK
180 - User's Manual
Appendix
URL Commands for the Network Camera
1. Overview
For some customers who already have their own web site or web control application, the Network
Camera/Video Server can be easily integrated through URL syntax. This section specifies the external
HTTP-based application programming interface. The HTTP-based camera interface provides the
functionality to request a single image, control camera functions (PTZ, output relay etc.), and 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, text within angle brackets denotes content that
is to be replaced with either a value or a string. When replacing the text string, the angle brackets
should 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, that is replaced with the string myserver in the URL
syntax example further down in the page.
URL syntax is denoted with the word "Syntax:" written in bold face followed by a box with the referenced
syntax as shown below. For example, name of the server is written as <servername> and 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 number for the server, e.g., 192.168.0.220.
Syntax:
http://<servername>/cgi-bin/viewer/video.jpg
Description of returned data is written with "
Return:
" in bold face followed by the returned data in a box. All data is
returned in HTTP format, i.e., each line is separated with a Carriage Return and Line Feed (CRLF) printed as \r\n.
Return:
HTTP/1.0 <HTTP code> <HTTP text>\r\n
URL syntax examples are written with "
Example:
" in bold face followed by a short description and a light grey box
with the example.
Example:
request a single snapshot image
http://mywebserver/cgi-bin/viewer/video.jpg
Loading page 181...
Loading page 182...
VIVOTEK
User's Manual - 183
© 2022 VIVOTEK INC. All Right Reserved
31
4. Security Level
SECURITY LEVEL SUB-DIRECTORY DESCRIPTION
0
anonymous
Unprotected.
1 [view] viewer Can view, listen, and talk to camera.
4 [operator]
operator
Operator access rights can modify most of the camera’s
parameters except some privileges and network options.
6 [admin] admin Administrator access rights can fully control the
camera’s operations.
7
N/A
Internal APIs. Unable to be changed by any external
interfaces.
A viewer account can access all APIs with security level 0 and 1. An operator account can access all
APIs with security level 0, 1, or 4. An admin account can access all APIs except internal APIs.
Access management is based on the URL directory structure and is described in following
paragraphs.
VIVOTEK
184 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
32
5. Get Server Parameter Values
Note: The access right depends on the URL directory.
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 oftherelated group will be returned.
When querying parameter values, the current parameter values are returned.
A successful control request returns parameter pairs as follows:
Return:
HTTP/1.0 200 OK\r\n
Content-Type: text/html\r\n
Context-Length: <length>\r\n
\r\n
<parameter pair>
where<parameter pair> is
<parameter>=<value>\r\n
[<parameter pair>]
<length> is the actual length of content.
Example: Request IP address and its response
Request:
VIVOTEK
User's Manual - 185
© 2022 VIVOTEK INC. All Right Reserved
33
http://192.168.0.123/cgi-bin/admin/getparam.cgi?network_ipaddress
Response:
HTTP/1.0 200 OK\r\n
Content-Type: text/html\r\n
Context-Length: 33\r\n
\r\n
network.ipaddress=192.168.0.123\r\n
VIVOTEK
186 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
34
6. Set Server Parameter Values
Note: The access right depends on the URL directory.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/
anonymous/setparam.cgi? <parameter>=<value>
[&<parameter>=<value>…][&return=<return page>]
http://<servername>/cgi-bin/viewer/setparam.cgi? <parameter>=<value>
[&<parameter>=<value>…][&return=<return page>]
http://<servername>/cgi-bin/operator/setparam.cgi? <parameter>=<value>
[&<parameter>=<value>…][&return=<return page>]
http://<servername>/cgi-bin/admin/setparam.cgi? <parameter>=<value>
[&<parameter>=<value>…][&return=<return page>]
PARAMETER DESCRIPTION
<parameter>
A full path like: "videoin_c0_s0_h264_resolution",
"videoin_c0_s0_h264_maxframe", etc.
<value> The assigned <value> to the <parameter>.
<return page>
Redirect to the page <return page>after the <parameter> is assigned. The <return
page>can be a full URL path or relative path according to the current path. If you
omit this parameter, it will redirect to an empty page.
(Note: The return page can be a general HTML file (.htm, .html). It cannot be a CGI
command or have any extra parameters. This parameter must be placed at the end
of the parameter list.
Return:
HTTP/1.0 200 OK\r\n
Content-Type: text/html\r\n
Context-Length: <length>\r\n
\r\n
<parameter pair>
where<parameter pair> is
<parameter>=<value>\r\n
Loading page 187...
Loading page 188...
VIVOTEK
User's Manual - 189
© 2022 VIVOTEK INC. All Right Reserved
37
VALID VALUES DESCRIPTION
<WxH>
The format for resolution.
W is the pixel number of width.
H is the pixel number of height.
Ex: 1920x1080, 2048x1536
available The API is listed in product WebAPIs.
non-available
The API is not in product WebAPIs.
valid The API is listed in product WebAPIs, and is functional.
non-valid
The API is listed in product WebAPIs, but is malfunction in this status.
<decimal> Any decimal number expressed in 32-bits ranging from
1.18e-38~3.40e+38.
NOTE: The camera should not be restarted when parameters are changed.
7.1 System
Group: system
NAME VALUE SECURITY
(get/set)
DESCRIPTION
hostname
string[64]
1/6
Host name of server
(Network Camera,
Wireless Network Camera,
Video Server,
Wireless Video Server).
ledoff <boolean> 6/6 Turn on (0) or turn off (1) all led
indicators.
date
<YYYY/MM/DD
>,
keep,
auto
6/6
Current date of system. Set to ‘keep’ to
keep date unchanged. Set to ‘auto’ to
use NTP to synchronize date.
time <hh:mm:ss>,
keep,
auto
6/6 Current time of the system. Set to ‘keep’
to keep time unchanged. Set to ‘auto’ to
use NTP to synchronize time.
datetime
<MMDDhhmm
YYYY.ss>
6/6
Another current time format of the
system.
ntp <domain
name>,
<ip address>,
6/6 NTP server.
*Do not use “skip to invoke default
server” for default value.
VIVOTEK
190 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
38
NAME VALUE SECURITY
(get/set)
DESCRIPTION
<blank>
timezoneindex
<Not recommended to
use this>
-489 ~ 529 6/6 Indicate timezone and area.
-440: GMT-11:00 Midway Island, Samoa
-400: GMT-10:00 Hawaii
-360: GMT-09:00 Alaska
-320: GMT-08:00 Las Vegas, San
Francisco, Vancouver
-280: GMT-07:00 Mountain Time, Denver
-281: GMT-07:00 Arizona
-240: GMT-06:00 Central America,
Central Time
-241: GMT-06:00 Mexico City
-242: GMT-06:00 Saskatchewan
-200: GMT-05:00 Eastern Time, New
York, Toronto
-201: GMT-05:00 Bogota, Lima, Quito,
Indiana
-180: GMT-04:00 Caracas
-160: GMT-04:00 Atlantic Time(Canada),
La Paz
-140: GMT-03:30 Newfoundland
-120: GMT-03:00 Brasilia, Buenos Aires,
Georgetown, Greenland, Sao Paulo
-121: GMT-03:00 Santiago
-80: GMT-02:00 Mid-Atlantic
-40: GMT-01:00 Azores, Cape Verde Is.
0: GMT Casablanca, Greenwich Mean
Time: Dublin, Edinburgh, Lisbon, London
40: GMT 01:00 Amsterdam, Berlin,
Rome, Stockholm, Vienna, Madrid, Paris,
Warsaw, Budapest, Bern
41: GMT 01:00 Amsterdam, Berlin,
Rome, Stockholm, Vienna, Madrid, Paris,
Warsaw, Budapest, Bern
80: GMT 02:00 Athens, Helsinki, Riga
81: GMT 02:00 Cairo
VIVOTEK
User's Manual - 191
© 2022 VIVOTEK INC. All Right Reserved
39
NAME VALUE SECURITY
(get/set)
DESCRIPTION
82: GMT 02:00 Lebanon
83: GMT 02:00
120: GMT 03:00 Baghdad, Kuwait,
Riyadh, Nairobi
121: GMT 03:00 Iraq, Minsk
140: GMT 03:30 Tehran
160: GMT 04:00 Abu Dhabi, Muscat,
Baku, Tbilisi, Yerevan, Moscow, St.
Petersburg
180: GMT 04:30 Kabul
200: GMT 05:00 Islamabad, Karachi,
Tashkent
220: GMT 05:30 Calcutta, Chennai,
Mumbai, New Delhi
230: GMT 05:45 Kathmandu
240: GMT 06:00 Ekaterinburg, Almaty,
Astana, Dhaka, Sri Jayawardenepura
260: GMT 06:30 Rangoon
280: GMT 07:00 Bangkok, Hanoi,
Novosibirsk, Jakarta
320: GMT 08:00 Beijing, Chongqing,
Hong Kong, Kuala Lumpur, Singapore,
Taipei, Krasnoyarsk
360: GMT 09:00 Osaka, Sapporo, Tokyo,
Seoul
380: GMT 09:30 Adelaide, Darwin
400: GMT 10:00 Brisbane, Canberra,
Melbourne, Sydney, Guam
401: GMT 10:00 Vladivostok
440: GMT 11:00 Magadan, Solomon Is.,
New Caledonia, Vladivostok
480: GMT 12:00
481: GMT 12:00 Auckland, Wellington,
Fiji, Marshall Is.
-480: GMT 12:00 Eniwetok, Kwajalein
520: GMT 13:00 Nuku'Alofa
VIVOTEK
192 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
40
NAME VALUE SECURITY
(get/set)
DESCRIPTION
* We replace this parameter with
“system_tz” when the version number
(httpversion) is equal or greater than
0314b.
daylight_enable <boolean> 6/6 Enable automaticdaylight saving time in
time zone.
daylight_auto_begintim
e
string[19]
6/7
Display the current daylight saving start
time.
daylight_auto_endtime string[19] 6/7 Display the current daylight saving end
time.
daylight_timezones
,-360,-320,-28
0,-240,-241,-2
00,-140,-121,-
40,0,40,41,80,
82,83,140,380,
480
6/7
List time zone index which support
daylight saving time.
* The timezone list can’t be modified for
the version number (httpversion) equal
or greater than 0316b, we recommend
using “system_tz” for customized time
settings instead.
updateinterval 0,
3600,
86400,
604800,
2592000
6/6 0 to Disable automatic time adjustment,
otherwise, it indicates the seconds
between NTP automatic update
intervals.
utctime
<string>
6/7
Current UTC timestamp.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0314b.
tz <POSIX TZ
string>
6/6 POSIX timezone setting.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0314b.
restore
0,
<positive
integer>
7/6
Restore the system parameters to default
values after <value> seconds.
reset 0,
<positive
integer>
7/6 Restart the server after <value> seconds
if <value> is non-negative.
VIVOTEK
User's Manual - 193
© 2022 VIVOTEK INC. All Right Reserved
41
NAME VALUE SECURITY
(get/set)
DESCRIPTION
restoreexceptnet
0,
<positive
integer>
7/6
Restore the system parameters to default
values except (ipaddress, subnet, router,
dns1, dns2, pppoe).
This command can cooperate with other
“restoreexceptXYZ” commands. When
cooperating with others, the system
parameters will be restored to the
default value except for a union of the
combined results.
restoreexceptdst 0,
<positive
integer>
7/6 Restore the system parameters to default
values except all daylight saving time
settings.
This command can cooperate with other
“restoreexceptXYZ” commands. When
cooperating with others, the system
parameters will be restored to default
values except for a union of combined
results.
restoreexceptlang
0,
<positive
integer>
7/6
Restore the system parameters to default
values except the custom language file
the user has uploaded.
This command can cooperate with other
“restoreexceptXYZ” commands. When
cooperating with others, the system
parameters will be restored to the
default value except for a union of the
combined results.
restoreexceptvadp 0,
<positive
integer>
7/6 Restore the system parameters to default
values except the vadp parameters and
VADP modules that stored in the system.
This command can cooperate with other
“restoreexceptXYZ” commands. When
cooperating with others, the system
parameters will be restored to the
default value except for a union of the
combined results.
VIVOTEK
194 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
42
NAME VALUE SECURITY
(get/set)
DESCRIPTION
restoreexceptfocusvalu
e
0,
<positive
integer>
7/6
Restore the system parameters to default
values except zoom and focus value.
This command can cooperate with other
“restoreexceptXYZ” commands. When
cooperating with others, the system
parameters will be restored to the
default value except for a union of the
combined results.
* Only available when
"capability_image_c<0~(n-1)>_remotefo
cus" != 0.
restoreexceptlen 0,
<positive
integer>
7/6 Restore the system parameters to default
values except lens profile.
This command can cooperate with other
“restoreexceptXYZ” commands. When
cooperating with others, the system
parameters will be restored to the
default value except for a union of the
combined results.
* Only available when
"capability_image_c<0~(n-1)>_lensconfig
uration_support" != 0.
connection_timeout
<integer>
6/6
Session connection timeout interval.
* Only available when
"capability_taics_support" = 1.
7.1.1 System.Info
Subgroup of system: info (The fields in this group are unchangeable.)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
modelname string[40] 0/7 Internal model name of the server
extendedmodelname
string[40]
0/7
ODM specific model name of server (eg.
DCS-5610). If it is not an ODM model,
this field will be equal to “modelname”
VIVOTEK
User's Manual - 195
© 2022 VIVOTEK INC. All Right Reserved
43
NAME VALUE SECURITY
(get/set)
DESCRIPTION
serialnumber
<mac address>
1/7
12 characters MAC address (without
hyphens).
firmwareversion string[40] 0/7 Firmware version, including model,
company, and version number in the
format:<MODEL-BRAND-VERSION>
language_count
<positive
integer>
0/7
Number of webpage languages available
on the server.
language_i<0~(count-
1)>
string[16]
language_i0 :
English
language_i1 :
Deutsch
language_i2 :
Español
language_i3 :
Français
language_i4 :
Italiano
language_i5 :
日本語
language_i6 :
Português
language_i7 :
简体中文
language_i8 :
繁體中文
0/7 Available language lists.
customlanguage_max
count
0,<positive
integer>
0/6
Maximum number of custom languages
supported on the server.
customlanguage_coun
t
0,<positive
integer>
0/6 Number of custom languages which have
been uploaded to the server.
customlanguage_i<0~
(maxcount-1)>
string
0/6
Custom language name.
7.2 Status
Group: status
Loading page 196...
VIVOTEK
User's Manual - 197
© 2022 VIVOTEK INC. All Right Reserved
45
NAME VALUE SECURITY
(get/set)
DESCRIPTION
integer>
eth_i0 <string> 1/7 Get network information from
mii-tool.
vi_i<0~(capability_nvi-1)>
<product dependent>
<boolean>
1/7
Virtual input
0 => Inactive
1 => Active
(capability_nvi > 0)
7.2.1 Status per Channel
Group: status_c<0~(n-1)> for n channel products
n denotes the value of "capability_nvideoin"
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
signal_detect <boolean> 1/7 Indicates whether the video source is
connected or not.
* Only available when
capability_videoin_type is 0 or 1.
signal_type
ntsc,pal
1/7
The actual modulation type.
* Only available when
capability_videoin_type is 0 or 1.
daynight day, night 1/7 Indicate the current light status.
7.3 Digital Input Behavior Define
Group: di_i<0~(k-1)> for k is the value of "capability_ndi" (capability_ndi > 0)
k is determined by the below criterion:
The following applies for capability_extension_di_num >= 0
* if extension_connected=1, k=capability_ndi
* if extension_connected=0, k=capability_ndi+ capability_extension_di_num
Otherwise,
* k=capability_ndi
NAME VALUE SECURITY
(get/set)
DESCRIPTION
normalstate
high,
low
1/1
Indicates open circuit or closed circuit
(inactive status)
VIVOTEK
198 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
46
7.4 Digital Output Behavior Define
Group: do_i<0~(k-1)> for k is the value of "capability_ndo" (capability_ndo > 0)
k is determined by the below criterion:
The following applies for capability_extension_do_num >= 0
* if extension_connected=1, k=capability_ndo
* if extension_connected=0, k=capability_ndo+ capability_extension_do_num
Otherwise,
* k=capability_ndo
NAME VALUE SECURITY
(get/set)
DESCRIPTION
normalstate
open,
grounded
1/1
Indicate open circuit or closed circuit
(inactive status)
7.5 Security
Group: security
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
privilege_do
view, operator,
admin
1/6 Indicate which privileges and above
can control digital output
(capability_ndo > 0)
privilege_camctrl
view, operator,
admin
1/6
Indicate which privileges and above
can control PTZ
(capability_ptzenabled > 0 or
capability_eptz > 0 or
capability_fisheye > 0)
user_i0_name string[64] 6/7 User name of root
user_i<1~20>_name
string[64]
6/7
User name
user_i0_pass password[64] 7/6 Root password
user_i<1~20>_pass
password[64]
7/6
User password
user_i0_privilege view,
operator,
admin
6/7 Root privilege
user_i<1~20>_ privilege
view,
operator,
admin
6/6
User privilege
Loading page 199...
Loading page 200...
VIVOTEK
User's Manual - 201
© 2022 VIVOTEK INC. All Right Reserved
49
7.6.2 QOS
Subgroup of network: qos_cos (capability_protocol_qos_cos > 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
6/6
Enable/disable CoS (IEEE 802.1p)
vlanid 1~4095 6/6 VLAN ID
video
0~7
6/6
Video channel for CoS
audio
<product dependent>
0~7 6/6 Audio channel for CoS
(capability_naudioin > 0)
eventalarm
0~7
6/6
Event/alarm channel for CoS
management 0~7 6/6 Management channel for CoS
eventtunnel
0~7
6/6
Event/Control channel for CoS
Subgroup of network: qos_dscp (capability_protocol_qos_dscp > 0)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 6/6 Enable/disable DSCP
video
0~63
6/6
Video channel for DSCP
audio 0~63 6/6 Audio channel for DSCP
(capability_naudioin > 0)
eventalarm
0~63
6/6
Event/alarm channel for DSCP
management 0~63 6/6 Management channel for DSCP
eventtunnel
0~63
6/6
Event/Control channel for DSCP
7.6.3 IPV6
Subgroup of network: ipv6 (capability_protocol_ipv6 > 0)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 6/6 Enable IPv6.
addonipaddress
<ip address>
6/6
IPv6 IP address.
addonprefixlen 0~128 6/6 IPv6 prefix length.
addonrouter
<ip address>
6/6
IPv6 router address.
addondns <ip address> 6/6 IPv6 DNS address.
allowoptional
<boolean>
6/6
Allow manually setup of IP address
setting.
VIVOTEK
202 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
50
7.6.4 FTP
Subgroup of network: ftp
NAME VALUE SECURITY
(get/set)
DESCRIPTION
port
21, 1025~65535
6/6
Local ftp server port.
enable <boolean> 6/6 Enable ftp.
7.6.5 HTTP
Subgroup of network: http
NAME VALUE SECURITY
(get/set)
DESCRIPTION
port
80, 1025 ~
65535
1/6
HTTP port.
alternateport 1025~65535 6/6 Alternate HTTP port.
authmode
basic,
digest
1/6
HTTP authentication mode.
s<0~(capability_nmed
iastream*capability_n
videoin)-1)>_accessna
me
<product dependent>
<Not recommended
to use this>
string[32]
1/6 Http server push access name for stream
N, N=
1~(capability_nmediastream*capability_
nvideoin)-1).
(capability_protocol_spush_mjpeg =1
and capability_nmediastream > 0)
The value are shown as
video1s1.mjpg = c0_s0_accessname,
(channel1stream1)
video1s2.mjpg = c0_s1_accessname,
(channel1stream2)
video1s3.mjpg = c0_s2_accessname,
(channel1stream3)
video1s4.mjpg = c0_s3_accessname,
(channel1stream4)
etc.
* We replace this parameter with
"network_http_c<0~(capability_nvideoin
-1)>_s<0~(capability_nmediastream-1)>_
VIVOTEK
User's Manual - 203
© 2022 VIVOTEK INC. All Right Reserved
51
NAME VALUE SECURITY
(get/set)
DESCRIPTION
accessname
" when the version number (httpversion)
is equal or greater than 0311c.
7.6.6 HTTP per Channel
Subgroup of network: http_c<0~(n-1)> for n channel products
n denotes the value of "capability_nvideoin"
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
s<0~(capability_nmedia
stream-1)>_accessname
<product dependent>
string[32]
1/6 Http server push access name for
channel N and stream M, N= 1~
capability_nvideoin, M= 1~
capability_nmediastream.
(capability_protocol_spush_mjpeg =1
and capability_nmediastream > 0)
The value are shown as
video1s1.mjpg = c0_s0_accessname,
(channel1stream1)
video1s2.mjpg = c0_s1_accessname,
(channel1stream2)
video2s1.mjpg = c1_s0_accessname,
(channel2stream1)
video2s2.mjpg = c1_s1_accessname,
(channel2stream2)
etc.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0311c.
7.6.7 HTTS Port
Subgroup of network: https (capability_protocol_https > 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
port
443, 1025 ~
1/6
HTTPS port.
Loading page 204...
VIVOTEK
User's Manual - 205
© 2022 VIVOTEK INC. All Right Reserved
53
NAME VALUE SECURITY
(get/set)
DESCRIPTION
live1s1.sdp = c0_s0_accessname,
(channel1stream1)
live1s2.sdp = c0_s1_accessname,
(channel1stream2)
live1s3.sdp = c0_s2_accessname,
(channel1stream3)
live1s4.sdp = c0_s3_accessname,
(channel1stream4)
etc.
* Values start with prefix “cgi-bin”
are prohibited. For example, “c, cg,
cgi, cgi-, cgi-b, cgi-bi, cgi-bin” are not
allowed.
* We modify the value of RTSP
access name after version
number(httpversion) is 0311c
pimssm_enable <boolean> 7/6 To enable the feature of Protocol
Independent Multicast - Source
Specific Multicast.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0313a.
7.6.9 RTSP Multicast
Subgroup of network: rtsp_s<0~(n-1)>_multicast
n denotes the value of "capability_nmediastream * capability_nvideoin"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
alwaysmulticast
<boolean>
4/4
Enable always multicast.
ipaddress <ip
address>
4/4 Multicast video IP address.
* We replace
"network_rtsp_s<0~(n-1)>_multicast_ipaddress"
with "
network_rtsp_s<0~(n-1)>_multicast_videoipadd
ress ".
VIVOTEK
206 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
54
NAME VALUE SECURITY
(get/set)
DESCRIPTION
* Reserved for compatibility, and suggest don't
use this since [httpversion] > 0304a
videoipaddress <ip
address>
4/4 Multicast video IP address.
* We support this parameter when the version
number (httpversion) is equal or greater than
0304a.
audioipaddress
<product
dependent>
<ip
address>
4/4
Multicast audio IP address.
* We support this parameter when the version
number (httpversion) is equal or greater than
0304a.
* Only available when capability_naudioin > 0
metadataipaddres
s
<ip
address>
4/4 Multicast metadata IP address.
* We support this parameter when the version
number (httpversion) is equal or greater than
0304a.
videoport
1025 ~
65535
4/4
Multicast video port.
audioport
<product
dependent>
1025 ~
65535
4/4 Multicast audio port.
* Only available when capability_naudioin > 0
metadataport
1026~6553
4
4/4
Multicast metadata port.
ttl 1 ~ 255 4/4 Multicasttime to live value.
7.6.10 SIP Port
Subgroup of network: sip (capability_protocol_sip> 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
port 1025 ~ 65535 1/6 SIP port.
7.6.11 RTP Port
Subgroup of network: rtp
NAME VALUE SECURITY
(get/set)
DESCRIPTION
VIVOTEK
User's Manual - 207
© 2022 VIVOTEK INC. All Right Reserved
55
NAME VALUE SECURITY
(get/set)
DESCRIPTION
videoport
1025 ~ 65535
6/6
Video channel port for RTP.
audioport 1025 ~ 65535 6/6 Audio channel port for RTP.
metadataport
1025 ~ 65535
6/6
Metadata channel port for RTP.
7.6.12 PPPoE
Subgroup of network: pppoe (capability_protocol_pppoe > 0)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
user string[128] 6/6 PPPoE account user name.
pass
password[64]
7/6
PPPoE account password.
7.6.13 Bonjour
Subgroup of network: service_bonjour
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 6/6 Enable bonjour service feature.
* We support this parameter when the
version number (httpversion) is equal
or greater than 0312a.
servicename
<string>
6/6
A friendly name for bonjour service.
* We support this parameter when the
version number (httpversion) is equal
or greater than 0312a.
7.6.14 SFTP server
* Only available when bit 1 of "capability_protocol_ftp_server " is 1.
Subgroup of network: sftp
NAME VALUE SECURITY
(get/set)
DESCRIPTION
port 22,
1025~65535
6/6 Local sftp server port.
enable <boolean> 6/6 Enable sftp.
Loading page 208...
Loading page 209...
VIVOTEK
210 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
58
NAME VALUE SECURITY
(get/set)
DESCRIPTION
The definition is:
0: EV -2.0
1: EV -1.7
2: EV -1.3
3: EV -1.0
4: EV -0.7
5: EV -0.3
6: EV 0
7: EV +0.3
8: EV +0.7
9: EV +1.0
10: EV +1.3
11: EV +1.7
12: EV +2.0
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_mode" !=0
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
irismode
fixed, indoor,
outdoor
<product
independent>
4/4 Control DC-Iris mode.
"outdoor": Auto-setting DC-Iris to get
best quality, but easy to meet rolling
or flicker effect in indoor
environment.
"indoor": Avoid rolling and flicker
effect first.
"fixed": Open the iris to maximum.
* Only available when
"capability_image_c<0~(n-1)>_iristype
"=dciris
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
VIVOTEK
User's Manual - 211
© 2022 VIVOTEK INC. All Right Reserved
59
NAME VALUE SECURITY
(get/set)
DESCRIPTION
after the version number (httpversion)
is equal or greater than 0400a.
enableblc
<Not support
anymore>
<boolean> 4/4 Enable backlight compensation.
* Not support this parameter
anymore when the version number
(httpversion) is equal or greater than
0301a.
* It's recommanded to use
"exposurewin_c<0~(n-1)>_mode" to
switch on/off BLC.
color
0, 1
4/4
0 =>monochrome
1 => color
* Only available when "
capability_videoin_c<0~(n-1)>_color_
support" is 1.
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
flip <boolean> 4/4 Flip the image.
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
mirror
<boolean>
4/4
Mirror the image.
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
rotate 0,90,180,270 1/4
The rotation angle of image.
Support only in Rotation mode.
* Only available when "
capability_videoin_c<0~(n-1)>_rotatio
Loading page 212...
Loading page 213...
VIVOTEK
214 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
62
NAME VALUE SECURITY
(get/set)
DESCRIPTION
re_maxrange" != "-"
* Only valid when
"piris_mode"=manual or
"irismode"=fixed
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
enablepreview <boolean> 1/4 Usage for UI of exposure settings.
Preview settings of video profile.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_mode" !=0
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
7.8.1 Video Input Setting per Channel
Group: videoin_c<0~(n-1)> for n channel products, and m is stream number
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nmediastream"
NAME VALUE SECURITY(
get/set)
DESCRIPTION
cmosfreq
50, 60
4/4
CMOS frequency.
* Only available when "
capability_videoin_type " is 2
mode 0 ~
"capability_videoin_c<0~(
n-1)>_nmode"-1
4/4 Indicate the video mode on use.
whitebalance
auto,
4/4
Modes of white balance.
Loading page 215...
VIVOTEK
216 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
64
NAME VALUE SECURITY(
get/set)
DESCRIPTION
bgain
0~100
4/4
Manual set bgain value of gain control
setting.
0: Weak <-> 100: Strong
* Only available when "rbgain" is
listed in
"capability_image_c<0~(n-1)>_wbmo
de".
* Only valid when
"videoin_c<0~(n-1)>_whitebalance" !
= auto
* Normalized range.
exposurelevel 0~12 4/4 Exposure level
"0,12": This range takes the concept
from DC's exposure tuning options.
The definition is:
0: EV -2.0
1: EV -1.7
2: EV -1.3
3: EV -1.0
4: EV -0.7
5: EV -0.3
6: EV 0
7: EV +0.3
8: EV +0.7
9: EV +1.0
10: EV +1.3
11: EV +1.7
12: EV +2.0
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_mode" !=0
exposuremode
<product
dependent>
auto,
shutterpriority,
irispriority,
qualitypriority,
manual,
4/4
Select exposure mode.
"auto": Automatically adjust the Iris,
Gain and Shutter Speed to fit the
exposure level.
"shutterpriority": Manually adjust
VIVOTEK
User's Manual - 217
© 2022 VIVOTEK INC. All Right Reserved
65
NAME VALUE SECURITY(
get/set)
DESCRIPTION
etc
(Available options are list
in
"capability_image_c<0~(n-
1)>_exposure_modetype")
with variable Shutter Speed, and keep
adjusting Iris, Gain automatically.
"irispriority": Manually adjust with
variable Iris, and keep adjusting Gain
and Shutter speed automatically.
"qualitypriority": Automatically
adjust the Iris, Gain and Shutter Speed
by VIVOTEK quality algorithm.
"manual": Manually adjust with
variable Shutter, Iris and Gain.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_mode" !=0
irismode
fixed, indoor, outdoor
<product dependent>
4/4 Control DC-Iris mode.
"outdoor": Auto-setting DC-Iris to get
best quality, but easy to meet rolling
or flicker effect in indoor
environment.
"indoor": Avoid rolling and flicker
effect first.
"fixed": Open the iris to maximum.
* Only available when
"capability_image_c<0~(n-1)>_iristype
"=dciris
piris_mode
<product
dependent>
manual, indoor, outdoor,-
1/4
Control P-Iris mode.
"outdoor": Auto-setting P-Iris to get
best quality, but easy to meet rolling
or flicker effect in indoor
environment.
"indoor": Avoid rolling and flicker
effect first.
"manual": Manual set P-Iris by
"piris_position".
VIVOTEK
218 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
66
NAME VALUE SECURITY(
get/set)
DESCRIPTION
"-": not support. (only available when
"capability_image_c<0~(n-1)>_sensor
type" is "smartsensor")
* Only available when
"capability_image_c<0~(n-1)>_iristype
"=piris
piris_position
<product
dependent>
1~100 1/4 Manual set P-Iris.
1: Open <-> 100: Close
* Only valid when
"piris_mode"=manual or
"capability_image_c<0~(n-1)>_sensor
type" is "smartsensor"
* Only available when
"capability_image_c<0~(n-1)>_iristype
"=piris
enableblc
<Not support
anymore>
<boolean>
4/4
Enable backlight compensation
* Not support this parameter
anymore when the version number
(httpversion) is equal or greater than
0301a.
* It's recommanded to use
"exposurewin_c<0~(n-1)>_mode" to
switch on/off BLC.
maxgain 0~100 4/4 Maximum gain value.
0: Low <-> 100: High
* Only available when
"capability_image_c<0~(n-1)>_agc_m
axgain" != "-"
* Only valid when
"piris_mode"=manual or
"irismode"=fixed
* Normalized range.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
mingain
0~100
4/4
Minimum gain value.
VIVOTEK
User's Manual - 219
© 2022 VIVOTEK INC. All Right Reserved
67
NAME VALUE SECURITY(
get/set)
DESCRIPTION
0: Low <-> 100: High
* Only available when
"capability_image_c<0~(n-1)>_agc_mi
ngain" != "-"
* Only valid when
"piris_mode"=manual or
"irismode"=fixed
* Normalized range.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
gainvalue 0~100 4/4 Gain value.
0: Low <-> 100: High
* Only available when
"capability_image_c<0~(n-1)>_agc_m
axgain" != "-" and
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "onevalue".
* Normalized range.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
color
0, 1
4/4
0 =>monochrome
1 => color
* Only available when "
capability_videoin_c<0~(n-1)>_color_
support" is 1.
flip <boolean> 4/4 Flip the image.
mirror
<boolean>
4/4
Mirror the image.
rotate 0,90,180,270 1/4 The rotation angle of image.
Support only in Rotation mode
(capability_videoin_c<0~(n-1)>_rotati
on=1)
ptzstatus
<Not support
anymore>
0,<positive integer>
1/7
A 32-bit integer, each bit can be set
separately as follows:
Bit 0 => Support camera control
Loading page 220...
Loading page 221...
VIVOTEK
222 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
70
NAME VALUE SECURITY(
get/set)
DESCRIPTION
* Available value is listed
in
"capability_image_c<0~(n-
1)>_exposure_maxrange"
* This parameter may also restrict
image frame rate from sensor due to
sensor generates a frame per
exposure time. Ex: If this is set to 1/5s
~ 1/8000s and camera takes 1/5s on
the night, then sensor only outputs 5
frame/s.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_maxrange" != "-" and
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "onevalue".
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
enablepreview <boolean> 1/4 Usage for UI of exposure settings.
Preview settings of video profile.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_mode" !=0
meteringmode
auto,
blc,
hlc
* Available value is listed
in
"capability_image_c<0~(n-
1)>_exposure_meteringm
ode"
4/4
"auto": The algorithm chooses the
best metering strategy.
"blc": This metering method increases
the weight of dark area.
"hlc": The metering method can
detect strong light and make affected
area clear.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0311a.
crop_position <coordinate>
(x,y)
1/7 Crop left-top corner coordinate.
crop_size
<window size>
(WxH)
1/7
Crop width and height.
(width must be 16x or 32x and height
must be 8x)
Loading page 223...
Loading page 224...
VIVOTEK
User's Manual - 225
© 2022 VIVOTEK INC. All Right Reserved
73
NAME VALUE SECURITY(
get/set)
DESCRIPTION
library directly.
* Only valid when
"h264_ratecontrolmode"= vbr and
s<0~(m-1)>_h264_quant = 99.
s<0~(m-1)>_h2
64_qpercent
1~100 4/4 Select customized quality in a
normalized full range.
1: Worst quality
100: Best quality
* Only valid when
"h264_ratecontrolmode"= vbr and
"quant"= 100.
s<0~(m-1)>_h2
64_maxvbrbitr
ate
20000~"capability_videoin
_c<0~(n-1)>_h264_maxbit
rate"
4/4
The maximum allowed bit rate in fixed
quality mode.
When the bit rate exceeds this value,
frames will be dropped to restrict the
bit rate.
* Only valid when
"h264_ratecontrolmode"= vbr
s<0~(m-1)>_h2
64_cbr_quant
1~5, 100 4/4 Set the pre-defined quality level:
1: Medium
2: Standard
3: Good
4: Detailed
5: Excellent
100: Use the quality level in
"cbr_qpercent"
* Only available when
"h264_ratecontrolmode"= cbr.
s<0~(m-1)>_h2
64_cbr_qperce
nt
1~100
4/4
Select customized quality in a
normalized full range.
1: Worst quality
100: Best quality
* Only valid when
"h264_ratecontrolmode"= cbr and
"quant"= 100.
s<0~(m-1)>_h2 20000~"capability_videoin 4/4 The target bit rate in constant bit rate
VIVOTEK
226 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
74
NAME VALUE SECURITY(
get/set)
DESCRIPTION
64_bitrate
_c<0~(n-1)>_h264_maxbit
rate"
mode.
* Only valid when
"h264_ratecontrolmode"= cbr
s<0~(m-1)>_h2
64_prioritypoli
cy
framerate,imagequality 4/4 Set prioritypolicy
* Only valid when
"h264_ratecontrolmode"= cbr
s<0~(m-1)>_h2
64_maxframe
1~"capability_videoin_c<0
~(n-1)>_h264_maxframera
te"
1/4
The maximum frame rates of a H264
stream at different
resolutions("capability_videoin_c<0~(
n-1)>_resolution") are recorded in
"capability_videoin_c<0~(n-1)>_h264
_maxframerate"
s<0~(m-1)>_h2
64_profile
0~2
* Available values can also
be <string> listed in
"capability_videoin_c<n>_
h264_profile"
1/4 Indicate H264 profiles
0: baseline
1: main
2: high
* It’s recommended to use available
values from
"capability_videoin_c<n>_h264_profil
e".
s<0~(m-1)>_h2
64_smartq_en
able
<boolean>
4/4
Enable "Smart Q" function.
* Only available when
"capability_videoin_c<0~(n-1)>_smart
q_support" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0309a.
s<0~(m-1)>_h2
65_dintraperio
d_enable
<boolean> 4/4 Enable "Dynamic intra frame period".
* Only available when
"capability_videoin_c<0~(n-1)>_dintra
period_support" is 1 and h265 is listed
in "capability_videoin_codec".
* We support this parameter when
the version number (httpversion) is
equal or greater than 0301c.
s<0~(m-1)>_h2
250, 500, 1000, 2000,
4/4
The time interval between two
Loading page 227...
VIVOTEK
228 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
76
NAME VALUE SECURITY(
get/set)
DESCRIPTION
* Only valid when
"h265_ratecontrolmode"= vbr and
"quant"= 100.
s<0~(m-1)>_h2
65_maxvbrbitr
ate
20000~"capability_videoin
_c<0~(n-1)>_h265_maxbit
rate"
4/4 The maximum allowed bit rate in fixed
quality mode.
When the bit rate exceeds this value,
frames will be dropped to restrict the
bit rate.
* Only available when h265 is listed in
"capability_videoin_codec".
* Only valid when
"h265_ratecontrolmode"= vbr
s<0~(m-1)>_h2
65_cbr_quant
1~5, 100
4/4
Set the pre-defined quality level:
1: Medium
2: Standard
3: Good
4: Detailed
5: Excellent
100: Use the quality level in
"cbr_qpercent"
* Only available when h265 is listed in
"capability_videoin_codec" and
"h265_ratecontrolmode"= cbr.
s<0~(m-1)>_h2
65_cbr_qperce
nt
1~100 4/4 Select customized quality in a
normalized full range.
1: Worst quality
100: Best quality
* Only available when h265 is listed in
"capability_videoin_codec".
* Only valid when
"h265_ratecontrolmode"= cbr and
"quant"= 100.
s<0~(m-1)>_h2
65_bitrate
20000~"capability_videoin
_c<0~(n-1)>_h265_maxbit
4/4
The target bit rate in constant bit rate
mode.
VIVOTEK
User's Manual - 229
© 2022 VIVOTEK INC. All Right Reserved
77
NAME VALUE SECURITY(
get/set)
DESCRIPTION
rate"
* Only available when h265 is listed in
"capability_videoin_codec".
* Only valid when
"h265_ratecontrolmode"= cbr
s<0~(m-1)>_h2
65_prioritypoli
cy
framerate,imagequality 4/4 Set prioritypolicy
* Only available when h265 is listed in
"capability_videoin_codec".
* Only valid when
"h265_ratecontrolmode"= cbr
s<0~(m-1)>_h2
65_maxframe
1~"capability_videoin_c<0
~(n-1)>_h265_maxframera
te"
1/4
The maximum frame rates of a H265
stream at different
resolutions("capability_videoin_c<0~(
n-1)>_resolution") are recorded in
"capability_videoin_c<0~(n-1)>_h265
_maxframerate"
* Only available when h265 is listed in
"capability_videoin_codec".
s<0~(m-1)>_h2
65_profile
Available values are listed
in "
capability_videoin_c<0~(n
-1)>_h265_profile"
1/4 Indicate H265 profiles
* Only available when h265 is listed in
"capability_videoin_codec".
s<0~(m-1)>_h2
65_smartq_en
able
<boolean>
4/4
Enable "Smart Q" function.
* Only available when h265 is listed in
"capability_videoin_codec".
* Only available when
"capability_videoin_c<0~(n-1)>_smart
q_support" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0309a.
s<0~(m-1)>_mj
peg_ratecontr
olmode
cbr, vbr 4/4 cbr: Constant bit rate mode.
vbr: Fixed quality mode, all frames are
encoded in the same quality.
s<0~(m-1)>_mj
peg_quant
1~5,
99, 100
4/4
* Only valid when
"mjpeg_ratecontrolmode"= vbr.
VIVOTEK
230 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
78
NAME VALUE SECURITY(
get/set)
DESCRIPTION
Set the pre-defined quality level:
1: Medium
2: Standard
3: Good
4: Detailed
5: Excellent
100: Use the quality level in
"qpercent"
99: Use the quality level in "qvalue"
s<0~(m-1)>_mj
peg_qvalue
10~200
(Only valid when
"capability_api_httpversio
n" format is XXXXX_1 or
XXXXX_3 or XXXXX_4
ex: 0301a_1 or 0301a_3 or
0301a_4)
or 1~99
(Only valid when
"capability_api_httpversio
n" format is XXXXX_2,
ex: 0301a_2)
<product dependent>
4/4 Manual video quality level input. The
Q value which is used by encoded
library directly.
* Only valid when
"mjpeg_ratecontrolmode"= vbr and
s<0~(m-1)>_mjpeg_quant = 99
s<0~(m-1)>_mj
peg_qpercent
1~100
4/4
Select customized quality in a
normalized full range.
1: Worst quality
100: Best quality
* Only valid when
"mjpeg_ratecontrolmode"= vbr and
s<0~(m-1)>_mjpeg_quant = 100.
s<0~(m-1)>_mj
peg_maxvbrbit
rate
20000~"capability_videoin
_c<0~(n-1)>_mjpeg_maxbi
trate"
4/4 The maximum allowed bit rate in fixed
quality mode.
When the bit rate exceeds this value,
frames will be dropped to restrict the
bit rate.
* Only valid when
"mjpeg_ratecontrolmode"= vbr
Loading page 231...
VIVOTEK
232 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
80
NAME VALUE SECURITY(
get/set)
DESCRIPTION
For NTSC:
D1/4CIF(720/704x480) -> (640x480)
CIF(352x240)->(320x240)
* Only available when
capability_videoin_type is 0 or 1.
wdrpro_mode
<product
dependent>
0, 1, 2 4/4 0: Disable WDR Pro.
1: Enable WDR Pro.
* Only valid when
"capability_image_c<0~(n-1)>_wdrpro
_mode" = 1
2: Enable WDR Pro II.
* Only valid when
"capability_image_c<0~(n-1)>_wdrpro
_mode" = 2
wdrpro_streng
th
<product
dependent>
1~100
4/4
The strength of WDR Pro.
The bigger value means the stronger
strength of WDR Pro.
* Only available when
"capability_image_c<0~(n-1)>_wdrpro
_strength" is 1
wdrc_mode
<product
dependent>
<boolean> 4/4 Enable WDR enhanced.
* Only available when
"capability_image_c<0~(n-1)>_wdrc_
mode" is 1
wdrc_strength
<product
dependent>
1~100
4/4
The strength of WDR enhanced.
The bigger value means the stronger
strength of WDR enhanced.
* Only available when
"capability_image_c<0~(n-1)>_wdrc_
mode" is 1
aespeed_mod
e
<product
dependent>
<boolean> 4/4 Turning AE converge speed on or off.
0: off
1: on
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1
VIVOTEK
User's Manual - 233
© 2022 VIVOTEK INC. All Right Reserved
81
NAME VALUE SECURITY(
get/set)
DESCRIPTION
aespeed_spee
dlevel
<product
dependent>
1~100
4/4
The speed level of AE converge speed.
1~20: level 1
21~40: level 2
41~60: level 3
61~80: level 4
81~100: level 5
Level 1~4(low ~ high)
The higher speed level meas shorter
AE converged time during AE
executing.
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1
aespeed_sensi
tivity
<product
dependent>
1~100 4/4 The sensitivity of AE converge speed.
1~20: level 1
21~40: level 2
41~60: level 3
61~80: level 4
81~100: level 5
Level 1~4(low ~ high)
The higher sensitivity level meas that
it is easy to be trigger while scene
changed.
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1 and
"capability_image_c<0~(n-1)>_aespee
dsupportsensitivity" is 1.
flickerless
<product
dependent>
<boolean>
4/4
Turn on(1) or turn off(0) the flickerless
mode
* Only available when
"capability_image_c<0~(n-1)>_flickerl
ess" is 1.
mounttype ceiling, wall, floor 1/6 Hardware installation.
* Only available when
"capability_videoin_c<0~(n-1)>_moun
VIVOTEK
234 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
82
NAME VALUE SECURITY(
get/set)
DESCRIPTION
ttype" != "-".
enablewaterm
ark
<product
dependent>
0, 1 1/6 0: Not to add watermarks on images
1: Add watermarks on images
* Only available when
"capability_fisheye" > 0
s<0~(m-2)>_fis
heyedewarpm
ode
<product
dependent>
‘1O, 1P, 2P, 1R, 4R’ for
ceiling/floor mount
‘1O, 1P, 1R, 4R’ for wall
mount
<product dependent>
* Available value is listed
in
"capability_videoin_c<0~(
n-1)>_localdewarp_typece
ilingmount" and
"capability_videoin_c<0~(
n-1)>_localdewarp_typew
allmount"
1/4
Local dewarp mode.
“1O” is original mode (disable).
Supported dewarp mode is different
by mount type.
* Only available when
"capability_fisheyelocaldewarp_c<0~(
capability_nvideoin)-1>" > 0
Group: videoin_c<0~(n-1)>_s<0~(m-1)>_h264_smartstream2 (capability_smartstream_support=1
and capability_smartstream_version>=2.0)
Group: videoin_c<0~(n-1)>_s<0~(m-1)>_h265_smartstream2 (capability_smartstream_support=1,
capability_smartstream_version>=2.0 and h265 is listed in "capability_videoin_codec")
n denotes the value of "capability_nvideoin",m denotes the value of " capability_nmediastream"
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 4/4 Enable or Disable smart codec
function
mode
autotracking,manual,hybri
d
4/4
Set Smart stream mode
"autotracking": only available when
"capability_smartstream_mode_autot
racking" is 1.
"manual": only available when
"capability_smartstream_mode_man
ual" is 1.
"hybrid": only available when
VIVOTEK
User's Manual - 235
© 2022 VIVOTEK INC. All Right Reserved
83
NAME VALUE SECURITY
(get/set)
DESCRIPTION
"capability_smartstream_mode_hybri
d" is 1.
qualitypriority -5,-4,-3,-2,-1,1,2,3,4,5 4/4 The differential value of Q between
the regions of interest (ROI) and the
areas of non-interest (non-ROI) of the
display image.
If the value is a positive number, the
video quality of ROI is better than the
non-ROI areas. The level is from 1 to
5. Level 5 is the maximum level of the
quality difference between the ROI
and non-ROI areas.
If the value is a negative number, the
video quality of non-ROI areas is
better than the ROI. The level is from
-1 to -5. Level -5 is the maximum level
of the quality difference between the
ROI and non-ROI areas.
Group: videoin_c<0~(n-1)>_s<0~(m-1)>_h264_smartstream2_win_i<0~(k-1)>
(capability_smartstream_support=1, capability_smartstream_version>=2.0 and
capability_smartstream_mode_manual = 1)
Group: videoin_c<0~(n-1)>_s<0~(m-1)>_h265_smartstream2_win_i<0~(k-1)>
(capability_smartstream_support=1, capability_smartstream_version>=2.0 and h265 is listed in
"capability_videoin_codec" and capability_smartstream_mode_manual = 1)
n denotes the value of "capability_nvideoin",m denotes the value of " capability_nmediastream",k
denotes the value of "capability_smartstream_nwindow_manual".
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
4/4
Enable or disable the window.
home 0~320,0~240 4/4 Left-top corner coordinate of the
window.
size
0~320x0~240
4/4
Width and height of the window
VIVOTEK
236 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
84
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 channel which might be for different scene of light (daytime or nighttime).
Group: videoin_c<0~(n-1)>_profile_i<0~(m-1)> for n channel products and m profile
n denotes the value of "capability_nvideoin" and m denotes the value of
"capability_nvideoinprofile"
(capability_nvideoinprofile> 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
4/4
Enable/disable this profile setting
policy night,
schedule
<product dependent>
4/4 The mode which the profile is applied
to.
* Not support "policy=day" anymore
when the version number
(httpversion) is equal or greater than
0301a.
* "policy=night" is only available when
"capability_daynight_c<0~(n-1)>_sup
port > 0".
begintime
hh:mm
4/4
Begin time of schedule mode.
endtime hh:mm 4/4 End time of schedule mode.
minexposure
<product
dependent>
<1~32000>,
<5~32000>,
<1~8000>,
<5~8000>,
etc.
* Available value is listed
in
"capability_image_c<0~(n-
1)>_exposure_minrange"
4/4
Minimum exposure time
1~32000 => 1s ~ 1/32000s
5~32000 => 1/5s ~ 1/32000s
1~8000 => 1s ~ 1/8000s
5~8000 => 1/5s ~ 1/8000s
etc.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_minrange" != "-"
* Only valid when
"piris_mode"=manual or
"irismode"=fixed
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
maxexposure
<product
<1~32000>,
<5~32000>,
4/4 Maximum exposure time
1~32000 => 1s ~ 1/32000s
VIVOTEK
User's Manual - 237
© 2022 VIVOTEK INC. All Right Reserved
85
NAME VALUE SECURITY
(get/set)
DESCRIPTION
dependent>
<1~8000>,
<5~8000>,
etc.
* Available value is listed
in
"capability_image_c<0~(n-
1)>_exposure_maxrange"
5~32000 => 1/5s ~ 1/32000s
1~8000 => 1s ~ 1/8000s
5~8000 => 1/5s ~ 1/8000s
etc.
* This parameter may also restrict
image frame rate from sensor due to
sensor generates a frame per
exposure time. Ex: If this is set to 1/5s
~ 1/8000s and camera takes 1/5s on
the night, then sensor only outputs 5
frame/s.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_maxrange" != "-"
* Only valid when
"piris_mode"=manual or
"irismode"=fixed
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
shuttervalue
<product
dependent>
<1~32000>,
<5~32000>,
<1~8000>,
<5~8000>,
etc.
* Available value is listed
in
"capability_image_c<0~(n-
1)>_exposure_maxrange"
4/4 Exposure time
1~32000 => 1s ~ 1/32000s
5~32000 => 1/5s ~ 1/32000s
1~8000 => 1s ~ 1/8000s
5~8000 => 1/5s ~ 1/8000s
etc.
* This parameter may also restrict
image frame rate from sensor due to
sensor generates a frame per
exposure time. Ex: If this is set to 1/5s
~ 1/8000s and camera takes 1/5s on
the night, then sensor only outputs 5
frame/s.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_maxrange" != "-" and
Loading page 238...
Loading page 239...
VIVOTEK
240 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
88
NAME VALUE SECURITY
(get/set)
DESCRIPTION
"outdoor": auto white balance mode
specifically for outdoor.
"indoor": auto white balance mode
specifically for indoor.
"sodiumauto": sodium vapor lamps.
* Only available when
"capability_image_c<0~(n-1)>_wbmo
de" !="-"
rgain 0~100 4/4 Manual set rgain value of gain control
setting.
0: Weak <-> 100: Strong
* Only available when "rbgain" is
listed in
"capability_image_c<0~(n-1)>_wbmo
de".
* Only valid when
"videoin_c<0~(n-1)>_whitebalance" !
= auto
* Normalized range.
bgain
0~100
4/4
Manual set bgain value of gain control
setting.
0: Weak <-> 100: Strong
* Only available when "rbgain" is
listed in
"capability_image_c<0~(n-1)>_wbmo
de".
* Only valid when
"videoin_c<0~(n-1)>_whitebalance" !
= auto
* Normalized range.
maxgain 0~100 4/4 Maximum gain value.
0: Low <-> 100: High
* Only available when
"capability_image_c<0~(n-1)>_agc_m
axgain" != "-"
* Only valid when
VIVOTEK
User's Manual - 241
© 2022 VIVOTEK INC. All Right Reserved
89
NAME VALUE SECURITY
(get/set)
DESCRIPTION
"piris_mode"=manual or
"irismode"=fixed
* Normalized range.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
mingain 0~100 4/4 Minimum gain value.
0: Low <-> 100: High
* Only available when
"capability_image_c<0~(n-1)>_agc_mi
ngain" != "-"
* Only valid when
"piris_mode"=manual or
"irismode"=fixed
* Normalized range.
* Only available when
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "twovalues".
gainvalue
0~100
4/4
Gain value.
0: Low <-> 100: High
* Only available when
"capability_image_c<0~(n-1)>_agc_m
axgain" != "-" and
"capability_image_c<0~(n-1)>_exposu
re_rangetype" is "onevalue".
* Normalized range.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
meteringmode auto,
blc,
hlc
* Available value is listed
in
"capability_image_c<0~(n-
4/4 "auto": The algorithm chooses the
best metering strategy.
"blc": This metering method increases
the weight of dark area.
"hlc": The metering method can
detect strong light and make affected
area clear.
VIVOTEK
242 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
90
NAME VALUE SECURITY
(get/set)
DESCRIPTION
1)>_exposure_meteringm
ode"
* We support this parameter when
the version number (httpversion) is
equal or greater than 0311a.
piris_mode
<product
dependent>
manual, indoor, outdoor,- 1/4 Control P-Iris mode.
"outdoor": Auto-setting P-Iris to get
best quality, but easy to meet rolling
or flicker effect in indoor
environment.
"indoor": Avoid rolling and flicker
effect first.
"manual": Manual set P-Iris by
"piris_position".
"-": not support (only available when
"capability_image_c<0~(n-1)>_sensor
type" is "smartsensor")
* Only available when
"capability_image_c<0~(n-1)>_iristype
"=piris
piris_position
<product
dependent>
1~100
1/4
Manual set P-Iris.
1: Open <-> 100: Close
* Only valid when
"piris_mode"=manual or
"capability_image_c<0~(n-1)>_sensor
type" is "smartsensor"
* Only available when
"capability_image_c<0~(n-1)>_iristype
"=piris
irismode
fixed, indoor, outdoor
<product dependent>
4/4 Control DC-Iris mode.
"outdoor": Auto-setting DC-Iris to get
best quality, but easy to meet rolling
or flicker effect in indoor
environment.
"indoor": Avoid rolling and flicker
effect first.
"fixed": Open the iris to maximum.
* Only available when
VIVOTEK
User's Manual - 243
© 2022 VIVOTEK INC. All Right Reserved
91
NAME VALUE SECURITY
(get/set)
DESCRIPTION
"capability_image_c<0~(n-1)>_iristype
"=dciris
wdrpro_mode
<product
dependent>
0, 1, 2 4/4 0: Disable WDR Pro.
1: Enable WDR Pro.
* Only valid when
"capability_image_c<0~(n-1)>_wdrpro
_mode" = 1
2: Enable WDR Pro II.
* Only valid when
"capability_image_c<0~(n-1)>_wdrpro
_mode" = 2
wdrpro_streng
th
<product
dependent>
1~100
4/4
The strength of WDR Pro.
The bigger value means the stronger
strength of WDR Pro.
* Only available when
"capability_image_c<0~(n-1)>_wdrpro
_strength" is 1
wdrc_mode
<product
dependent>
<boolean> 4/4 Enable WDR enhanced.
* Only available when
"capability_image_c<0~(n-1)>_wdrc_
mode" is 1
wdrc_strength
<product
dependent>
1~100
4/4
The strength of WDR enhanced.
The bigger value means the stronger
strength of WDR enhanced.
* Only available when
"capability_image_c<0~(n-1)>_wdrc_
mode" is 1
aespeed_mod
e
<product
dependent>
<boolean> 4/4 Turning AE converge speed on or off.
0: off
1: on
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1
aespeed_spee
dlevel
<product
1~100
4/4
The speed level of AE converge speed.
1~20: level 1
21~40: level 2
VIVOTEK
244 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
92
NAME VALUE SECURITY
(get/set)
DESCRIPTION
dependent>
41~60: level 3
61~80: level 4
81~100: level 5
Level 1~4(low ~ high)
The higher speed level meas shorter
AE converged time during AE
executing.
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1
aespeed_sensi
tivity
<product
dependent>
1~100 4/4 The sensitivity of AE converge speed.
1~20: level 1
21~40: level 2
41~60: level 3
61~80: level 4
81~100: level 5
Level 1~4(low ~ high)
The higher sensitivity level meas that
it is easy to be trigger while scene
changed.
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1 and
"capability_image_c<0~(n-1)>_aespee
dsupportsensitivity" is 1.
flickerless
<product
dependent>
<boolean>
4/4
Turn on(1) or turn off(0) the flickerless
mode
* Only available when
"capability_image_c<0~(n-1)>_flickerl
ess" is 1
7.8.2 Multicast Settings for Video Streaming
Group: videoin_c<0~(n-1)>_s<0~(m-1)>_multicast
(capability_media_streamprofiles_support = 1)
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nmediastream"
NAME
VALUE
SECURITY(
get/set)
DESCRIPTION
VIVOTEK
User's Manual - 245
© 2022 VIVOTEK INC. All Right Reserved
93
ipaddress <ip address> 4/4 Multicast video IP address.
port
1025 ~ 65535
4/4
Multicast video port.
ipversion IPv4, IPv6 4/4 The version of internet protocol.
ttl
1 ~ 255
4/4
Multicast video time to live value.
7.9 Time Shift Settings
Group: timeshift for n channel products and m stream
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nmediastream"
(capability_timeshift > 0)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable
<Not
recommended
to use>
<boolean> 4/4 Enable time shift streaming.
* We replace this parameter with "
timeshift_c<0~(n-1)>_enable"
when the version number
(httpversion) is equal or greater than
0312a.
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
c<0~(n-1)>_en
able
<boolean>
4/4
Enable time shift streaming.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
c<0~(n-1)>_s<
0~(m-1)>_allo
w
<boolean> 4/4 Enable time shift streaming for
specific stream.
7.10 IR Cut Control
<Not recommended to use this>
Loading page 246...
Loading page 247...
Loading page 248...
VIVOTEK
User's Manual - 249
© 2022 VIVOTEK INC. All Right Reserved
97
NAME VALUE SECURITY
(get/set)
DESCRIPTION
use this>
capability_daynight_c<0~(n-1)>_ircuts
ensitivity_type=options
"1~100": if
capability_daynight_c<0~(n-1)>_ircuts
ensitivity_type=normalize
* Only available when
"capability_daynight_c<0~(n-1)>
_ircutsensitivity_type" is not "-".
* We replace this parameter with
ircutcontrol_c<0~(n-1)>_sensitivity”
when the version number
(httpversion) is equal or greater than
0312a.
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
spectrum_mode
<Not
recommended to
use this>
visible,
ir,
irenhanced,
blueenhanced
<product dependent>
* Available values are
listed in
"capability_daynight_
c<0~(n-1)>_spectrum
_mode".
6/6 Set spectrum method .
* Only available when
"capability_daynight_c<0~(n-1)>_spec
trum_support" is 1.
* We replace this parameter with
"ircutcontrol_illuminators_spectrum_
mode" when the version number
(httpversion) is equal or greater than
0312a.
* We do not support this parameter
when "capability_nvideoin > 1".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
7.10.1 IR cut control setting per channel
VIVOTEK
250 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
98
Group: ircutcontrol_c<0~(n-1)> for n channel products (capability_daynight_c<0~(n-1)>_support >
0)
n denotes the value of "capability_nvideoin"
NAME VALUE SECURIT
Y
(get/set)
DESCRIPTION
mode
auto,
day,
night,
di,
schedule…etc
* Available values
are listed in
"capability_daynig
ht_c<0~(n-1)>_mo
de"
<product
dependent>
6/6
Set IR cut control mode
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
sir
<product dependent>
<boolean> 6/6 Enable/disable Smart IR
* Only available when
"capability_daynight_c<0~"capability_
nvideoin"-1>_smartir" is 1
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
daymodebegintime
00:00~23:59
6/6
Day mode begin time
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
daymodeendtime 00:00~23:59 6/6 Day mod end time
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
bwmode
<boolean>
6/6
Switch to B/W in night mode if
enabled.
* Only available when
"capability_daynight_c<0~(n-1)>_
blackwhitemode" is 1.
Loading page 251...
VIVOTEK
252 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
100
tin_support > 0" and "irled" is listed in
"capability_daynight_ illuminators
_builtin_type"
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
builtin_whiteled_enable
d
<boolean>
6/6
Enable/disable built-in white led
* Only available when
"capability_daynight_illuminators_buil
tin_support > 0" and "whiteled" is
listed in "capability_daynight_
illuminators _builtin_type"
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
external_do_enabled <boolean> 1/6 Enable/disable external led mounted
on do1
* Only available when
"capability_daynight_illuminators_ext
ernal_support > 0" and "do" is listed
in
"capability_daynight_illuminators_ext
ernal_interface".
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
external_do<2~(k)>_ena
bled
<boolean>
1/6
Enable/disable external led mounted
on do<2~(k)>.
* Only available when "capability_ndo
> 1"
* Only available when
"capability_daynight_illuminators_ext
ernal_support > 0" and "do<2~(k)>"
are listed in
"capability_daynight_illuminators_ext
ernal_interface".
* We support this parameter when
the version number (httpversion) is
VIVOTEK
User's Manual - 253
© 2022 VIVOTEK INC. All Right Reserved
101
equal or greater than 0312a.
spectrum_mode
visible,
ir,
irenhanced,
blueenhanced
<product
dependent>
* Available values
are listed in
"capability_daynig
ht_illuminators
_spectrum_mode"
.
6/6
Set spectrum method .
* We support this parameter when
the version number (httpversion) is
equal or greater than 0312a.
* Only available when
"capability_daynight_illuminators_
spectrum _support > 0".
7.11 Image Setting per Channel
Group: image_c<0~(n-1)> for n channel products and m profile
n denotes the value of "capability_nvideoin" and m denotes the value of
"capability_nvideoinprofile"
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
brightness
<Not
recommended to
use this>
-5~5,100 4/4 -5: Darker <-> 5: Bright
100: Use "
image_c<n>_brightnesspercent"
* Only available when bit 0 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1
* We replace "brightness" with
"brightnesspercent".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
contrast
<Not
recommended to
use this>
-5~5,100
4/4
-5: Less contrast <-> 5: More contrast
100: Use "
image_c<0~(n-1)>_contrastpercent"
* Only available when bit 1 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
VIVOTEK
254 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
102
NAME VALUE SECURITY
(get/set)
DESCRIPTION
* We replace "contrast" with
"contrastpercent ".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
saturation
<Not
recommended to
use this>
-5~5,100 4/4 -5: Less saturation <-> 5: More
saturation
100: Use "
image_c<n>_saturationpercent"
* Only available when bit 2 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
* We replace "saturation" with
"saturationpercent".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
sharpness
<Not
recommended to
use this>
-3~3,100
4/4
-3: Softer <-> 3: Sharper
100: Use "
image_c<0~(n-1)>_sharpnesspercent"
* Only available when bit 3 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
* We replace "sharpness" with
"sharpnesspercent".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
brightnesspercent 0~100 4/4 Set brightness in the normalized
range.
0: Darker <-> 100: Bright
* Only available when bit 0 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
contrastpercent
0~100
4/4
Set contrast in the normalized range.
0: Less contrast <-> 100: More
VIVOTEK
User's Manual - 255
© 2022 VIVOTEK INC. All Right Reserved
103
NAME VALUE SECURITY
(get/set)
DESCRIPTION
contrast
* Only available when bit 1 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1
saturationpercent 0~100 4/4 Set saturation in the normalized
range.
0: Less saturation <-> 100: More
saturation
* Only available when bit 2 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
sharpnesspercent
0~100
4/4
Set sharpness in the normalized
range.
0: Softer <-> 100: Sharper
* Only available when bit 3 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1
gammacurve
<product
dependent>
0~100 4/4 0: Fine-turned gamma curve by
Vivotek.
1: Gamma value = 0.01
2: Gamma value = 0.02
3: Gamma value = 0.03
...
100: Gamma value = 1
* Note: Although we set gamma value
to 100 level, but not all gamma values
are valid. Internal module will take the
closest valid one. For example, 1~45
may all be mapped to gamma value =
0.45, etc.
* Only available when
"capability_image_c<0~(n-1)>_gamm
acurve" is 1
lowlightmode
<product
dependent>
<boolean>
4/4
Enable/disable low light mode.
* Only available when
"capability_image_c<0~(n-1)>_lowligh
Loading page 256...
Loading page 257...
Loading page 258...
VIVOTEK
User's Manual - 259
© 2022 VIVOTEK INC. All Right Reserved
107
NAME VALUE SECURITY
(get/set)
DESCRIPTION
listed in
"capability_image_c<
0~(n-1)>_palette_mo
de"
* Only available when
"capability_image_c<0~(n-1)>_palette
_support" is 1.
profile_i<0~(m-1)>
_enable
<boolean> 4/4 Enable/disable this profile setting
profile_i<0~(m-1)>
_policy
night,
schedule
<product dependent>
4/4
The mode which the profile is applied
to.
* Not support "policy=day" anymore
when the version number
(httpversion) is equal or greater than
0301a.
* "policy=night" is only available when
"capability_daynight_c<0~(n-1)>_sup
port > 0".
profile_i<0~(m-1)>
_begintime
hh:mm 4/4 Begin time of schedule mode.
profile_i<0~(m-1)>
_endtime
hh:mm
4/4
End time of schedule mode.
profile_i<0~(m-1)>
_brightness
<Not
recommended to
use this>
-5~5,100 4/4 -5: Darker <-> 5: Bright
100: Use "
image_c<0~(n-1)>_brightnesspercent"
* Only available when bit 0 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1
* We replace "profile_i0_brightness"
with "profile_i0_brightnesspercent".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
profile_i<0~(m-1)>
_contrast
<Not
-5~5,100
4/4
-5: Less contrast <-> 5: More contrast
100: Use "
image_c<0~(n-1)>_contrastpercent"
VIVOTEK
260 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
108
NAME VALUE SECURITY
(get/set)
DESCRIPTION
recommended to
use this>
* Only available when bit 1 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
* We replace "profile_i0_contrast"
with "profile_i0_contrastpercent ".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
profile_i<0~(m-1)>
_saturation
<Not
recommended to
use this>
-5~5,100 4/4 -5: Less saturation <-> 5: More
saturation
100: Use "
image_c<0~(n-1)>_saturationpercent"
* Only available when bit 2 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
* We replace "profile_i0_saturation"
with "profile_i0_saturationpercent".
* This parameter will not be used
after the version number (httpversion)
is equal or greater than 0400a.
profile_i<0~(m-1)>
_sharpness
<Not
recommended to
use this>
-3~3,100
4/4
-5: Less saturation <-> 5: More
saturation
100: Use "
image_c<0~(n-1)>_saturationpercent"
* Only available when bit 2 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
* We replace "profile_i0_saturation"
with "profile_i0_saturationpercent".
* This parameter will not be used
VIVOTEK
User's Manual - 261
© 2022 VIVOTEK INC. All Right Reserved
109
NAME VALUE SECURITY
(get/set)
DESCRIPTION
after the version number (httpversion)
is equal or greater than 0400a.
profile_i<0~(m-1)>
_brightnesspercent
0~100 4/4 Set brightness in the normalized
range.
0: Darker <-> 100: Bright
* Only available when bit 0 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
profile_i<0~(m-1)>
_contrastpercent
0~100
4/4
Set contrast in the normalized range.
0: Less contrast <-> 100: More
contrast
* Only available when bit 1 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1
profile_i<0~(m-1)>
_saturationpercent
0~100 4/4 Set saturation in the normalized
range.
0: Less saturation <-> 100: More
saturation
* Only available when bit 2 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1.
profile_i<0~(m-1)>
_sharpnesspercent
0~100
4/4
Set sharpness in the normalized
range.
0: Softer <-> 100: Sharper
* Only available when bit 3 of
"capability_image_c<0~(n-1)>_basicse
tting" is 1
profile_i<0~(m-1)>
_gammacurve
0~100 4/4 0: Fine-turned gamma curve by
Vivotek.
1: Gamma value = 0.01
2: Gamma value = 0.02
3: Gamma value = 0.03
...
100: Gamma value = 1
* Note: Although we set gamma value
to 100 level, but not all gamma values
VIVOTEK
262 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
110
NAME VALUE SECURITY
(get/set)
DESCRIPTION
are valid. Internal module will take the
closest valid one. For example, 1~45
may all be mapped to gamma value =
0.45, etc.
* Only available when
"capability_image_c<0~(n-1)>_gamm
acurve" is 1
profile_i<0~(m-1)>
_lowlightmode
<product
dependent>
<boolean> 4/4 Enable/disable low light mode.
* Only available when
"capability_image_c<0~(n-1)>_lowligh
tmode" is 1
profile_i<0~(m-1)>
_hlm
<product
dependent>
<boolean>
4/4
Enable/disable hightlight mask.
* Only available when
"capability_image_c<0~(n-1)>_hlm" is
1
profile_i<0~(m-1)>
_dnr_mode
<product
dependent>
<boolean> 4/4 3D noise reduction.
0:disable
1:enable
* Only available when
"capability_image_c<0~(n-1)>_dnr" is
1
profile_i<0~(m-1)>
_dnr_strength
<product
dependent>
1~100
4/4
Strength of 3DNR
* Only available when
"capability_image_c<0~(n-1)>_dnr" is
1
profile_i<0~(m-1)>
_defog_mode
<product
dependent>
<boolean> 4/4 Enable/disable defog mode.
0:disable
1:enable
* Only available when
"capability_image_c<0~(n-1)>_defog_
mode" is 1
profile_i<0~(m-1)>
_defog_strength
<product
dependent>
1~100
4/4
Strength of defog
* Only available when
"capability_image_c<0~(n-1)>_defog_
mode" is 1
profile_i<0~(m-1)> <boolean> 4/4 Electronic image stabilizer
VIVOTEK
User's Manual - 263
© 2022 VIVOTEK INC. All Right Reserved
111
NAME VALUE SECURITY
(get/set)
DESCRIPTION
_eis_mode
<product
dependent>
0:disable
1:enable
* Only available when 'eis' is listed in
"capability_image_c<0~(n-1)>_is_mod
e".
profile_i<0~(m-1)>
_eis_strength
<product
dependent>
1~100 4/4 Strength of electronic image stabilizer
* Only available when 'eis' is listed in
"capability_image_c<0~(n-1)>_is_mod
e".
profile_i<0~(m-1)>
_dis_mode
<product
dependent>
<boolean>
4/4
Digital image stabilizer
0:disable
1:enable
* Only available when 'dis' is listed in
"capability_image_c<0~(n-1)>_is_mod
e".
profile_i<0~(m-1)>
_dis_strength
<product
dependent>
1~100 4/4 Strength of digital image stabilizer
* Only available when 'dis' is listed in
"capability_image_c<0~(n-1)>_is_mod
e".
7.12 Exposure Window Setting per Channel
Group: exposurewin_c<0~(n-1)> for n channel profucts
n denotes the value of "capability_nvideoin"
(Only available when "capability_image_c<0~(n-1)>_exposure_mode"=1)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
mode
auto, custom,blc,hlc,center
* Available values are listed
in
"capability_image_c<0~(n-1)
>_exposure_winmode"
4/4
"auto": Use full image view as the
only exposure window.
"custom": Use custom windows.
"blc": Use BLC(Back Light
Compensation), and the only
exposure window is located at the
center of view.
"hlc": Use HLC (High Light
Compensation), and to perform the
Loading page 264...
VIVOTEK
User's Manual - 265
© 2022 VIVOTEK INC. All Right Reserved
113
NAME VALUE SECURITY
(get/set)
DESCRIPTION
H: 0~ The current image height
-1
"capability_image_c<0~(n-1)>_exposu
re_windomain".
sizepx <0~Wx0~ H>
W: 0~ The current image width
-1
H: 0~ The current image height
-1
4/4 Width and height of the window.
* Only available when px is listed in
"capability_image_c<0~(n-1)>_exposu
re_windomain".
homestd
<0~9999,0~9999>
4/4
Left-top corner coordinate of the
window.
* Only available when std is listed in
"capability_image_c<0~(n-1)>_exposu
re_windomain".
sizestd <0~9999x0~9999> 4/4 Width and height of the window.
* Only available when std is listed in
"capability_image_c<0~(n-1)>_exposu
re_windomain".
Group: exposurewin_c<0~(n-1)>_profile_i<0~(m-1)> for n channel profuct and m profile,
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nvideoinprofile",
(Only available when "capability_image_c<0~(n-1)>_exposure_mode"=1)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
mode
auto, custom,blc,hlc,center
* Available values are listed
in
"capability_image_c<0~(n-1)
>_exposure_winmode"
4/4
The mode indicates how to decide the
exposure.
"auto": Use full view as the only one
exposure window.
"custom": Use inclusive and exclusive
window.
"blc": Use BLC(Back Light
Compensation), and the only
exposure window is located at the
center of view.
"hlc": Use HLC (High Light
VIVOTEK
266 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
114
NAME VALUE SECURITY
(get/set)
DESCRIPTION
Compensation), and to perform the
masking of bright light area.
"center": Use Center window as
metering area and give the necessary
light compensation.
Group: exposurewin_c<0~(n-1)>_profile_i<0~(m-1)>_win_i<0~(k-1)> for m profile and n channel
product,
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nvideoinprofile",
k denotes the value of "capability_image_c<0~(n-1)>_exposure_winnum".
(Only available when "capability_image_c<0~(n-1)>_exposure_mode"=1 and when custom is listed
in "capability_image_c<0~(n-1)>_exposure_winmode" and valid when
"exposurewin_c<0~(n-1)>_mode"=custom or "exposurewin_c<0~(n-1)>_mode"=hlc)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 4/4 Enable or disable the window.
policy
0~1
4/4
0: Indicate exclusive.
1: Indicate inclusive.
* Only available when exclusive is
listed in
"capability_image_c<0~(n-1)>_exposu
re_wintype".
* "policy=night" is only available when
"capability_daynight_c<0~(n-1)>_sup
port > 0".
home <0~320,0~240> 4/4 Left-top corner coordinate of the
window.
* Only available when qvga is listed in
"capability_image_c<0~(n-1)>_exposu
re_windomain".
size
<0~320x0~240>
4/4
Width and height of the window.
* Only available when qvga is listed in
"capability_image_c<0~(n-1)>_exposu
re_windomain".
Loading page 267...
VIVOTEK
268 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
116
NAME VALUE SECURITY
(get/set)
DESCRIPTION
input
intmic, extmic
<product
dependent>
4/4
intmic: Internal (built-in) microphone.
(Only available when
capability_audio_intmic = 1)
extmic: External microphone input.
(Only available when
capability_audio_extmic =1)
* Note: If physical microphone switch
is showed on product, this value is
updated during booting to fit switch
status.
volume_internal 0~100 4/4 Volume when take internal
microphone as input source.
0: Minimum
100: Maximum
* Only available when the channel
supports internal microphone (The
related bit of
"capability_audio_intmic" is equal to
1).
volume_external
0~100
4/4
Volume when take external
microphone as input source.
0: Minimum
100: Maximum
* Only available when the channel
supports external microphone (The
related bit of
"capability_audio_extmic" is equal to
1).
mute 0, 1 1/4 0: Mute off
1: Mute on
gain
<Not recommended
to use this>
0~100
4/4
Gain of input.
(audioin_c<0~(n-1)>_source = linein)
* Reserved for compatibility, and
Loading page 269...
VIVOTEK
270 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
118
NAME VALUE SECURITY
(get/set)
DESCRIPTION
5900,
6700,
7400,
7950,
10200,
12200
s0_g711_mode
pcmu,
pcma
4/4 Set G.711 companding algorithm.
pcmu: µ-law algorithm
pcma: A-law algorithm
* Only available if G.711 is supported.
s0_g726_bitrate
16000,
24000,
32000,
40000
4/4
Set G.726 encoded bitrate in bps.
* Only available if G.726 is supported.
s0_g726_bitstreamp
ackingmode
little, big 4/4 Set G.726 bit streaming packing
mode.
little: Little-endian bitstream format.
big: Big-endian bitstream format.
* Only available if G.726 is supported.
s0_g726_vlcmode
0, 1
4/4
Enable vlcmode for G.726.
0: Standard mode.
1: Solve compatibility problem with
VLC player.
* Only available if G.726 is supported.
aec_enable <boolean> 4/4 Enable acoustic echo cancellation.
* Only available when
"capability_audio_aecmode" is
"manual".
* We support this parameter when
the version number (httpversion) is
equal or greater than 0306b.
alarm_enable
<boolean>
4/4
Enable audio detection
alarm_level 1~100 4/4 Audio detection alarm level
profile_i0_enable
<boolean>
4/4
Enable/disable this profile setting
profile_i0_policy night, 4/4 The mode which the profile is applied
VIVOTEK
User's Manual - 271
© 2022 VIVOTEK INC. All Right Reserved
119
NAME VALUE SECURITY
(get/set)
DESCRIPTION
schedule
<product
dependent>
to.
* Not support "policy=day" anymore
when the version number
(httpversion) is equal or greater than
0301a.
* "policy=night" is only available when
"capability_daynight_c<0~(n-1)>_sup
port > 0".
profile_i0_begintime hh:mm 4/4 Begin time of schedule mode.
profile_i0_endtime
hh:mm
4/4
End time of schedule mode.
profile_i0_alarm_lev
el
1~100 4/4 Audio detection alarm level
7.13.1. Multicast Settings for Audio Streaming
Group: audioin_c<0~(n-1)>_s0_multicast
(capability_naudioin > 0 and
capability_media_streamprofiles_support = 1)
n denotes the value of "capability_naudioin"
NAME VALUE SECURITY(
get/set)
DESCRIPTION
ipaddress
<ip address>
4/4
Multicast audio IP address.
port 1025 ~ 65535 4/4 Multicast audio port.
ipversion
IPv4, IPv6
4/4
The version of internet protocol.
ttl 1 ~ 255 4/4 Multicast audio time to live value.
7.14 Audio Output per Channel
Group: audioout_c<0~(n-1)> for n channel products (capability_naudioout>0)
n denotes the value of "capability_naudioout"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
volume
0~100
4/4
Adjusting audio volume
VIVOTEK
272 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
120
7.15 Play an Audio Clip
Group: audioclip_i<0~1> (capability_audio_audioclip=1)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
name
string[40]
1/4
Specify the audio clip name that can
be played when an event occurs.
size 0,<positive integer> 1/4 The size of audio clip.
Group: audioclip (capability_audio_audioclip=1)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
prerecord_seconds
1~10
1/4
Indicates the seconds that can be
waited before audio clip start to
record.
7.16 Motion Detection Settings
Group: motion_c<0~(n-1)> for n channel products
n denotes the value of "capability_nvideoin"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable <boolean> 4/4 Enable motion detection.
win_sensitivity 0 ~ 100 4/4 Sensitivity of all motion detection
windows.
* The value "0" is reserved for
compatibility and will not be used after
the version number (httpversion) is
equal or greater than 0400a.
7.16.1. Motion Detection for Each Window
Group: motion_c<0~(n-1)>_win_i<0~(k-1)>
n denotes the value of "capability_nvideoin", k denotes the value of "capability_nmotion".
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable <boolean> 4/4 Enable motion detection window.
name string[14] 4/4 Name of motion window.
polygonstd 0 ~ 9999,0 ~ 9999, 0 4/4 Coordinate of polygon window
VIVOTEK
User's Manual - 273
© 2022 VIVOTEK INC. All Right Reserved
121
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
~ 9999,0 ~ 9999, 0 ~
9999,0 ~ 9999, 0 ~
9999,0 ~ 9999
position.
(4 points: x0,y0,x1,y1,x2,y2,x3,y3)
* Only available when
"capability_motion_wintype" =
polygon.
* Only available when std is listed in
"capability_motion_windomain"
objsize
1 ~ 100
4/4
Percent of motion detection window.
sensitivity
<Not recommended
to use this>
0 ~ 100
4/4
Sensitivity of motion detection window.
* We replace "sensitivity" with
"win_sensitivity".
* This parameter will not be used after
the version number (httpversion) is
equal or greater than 0400a.
polygonpx
<Not recommended
to use this>
0 ~ W,0 ~ H, 0 ~ W,0
~ H, 0 ~ W,0 ~ H, 0 ~
W,0 ~ H
W: 0~ The current
image width -1
H: 0~ The current
image height -1
4/4
Coordinate of polygon window
position.
(4 points: x0,y0,x1,y1,x2,y2,x3,y3)
* Only available when
"capability_motion_wintype" =
polygon.
* Only available when px is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is
equal or greater than 0400a.
polygon
<Not recommended
to use this>
0 ~ 320,0 ~ 240, 0 ~
320,0 ~ 240, 0 ~
320,0 ~ 240, 0 ~
320,0 ~ 240
4/4
Coordinate of polygon window
position.
(4 points: x0,y0,x1,y1,x2,y2,x3,y3)
* Only available when
"capability_motion_wintype" =
polygon.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
VIVOTEK
274 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
122
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
the version number (httpversion) is
equal or greater than 0400a.
left
<Not recommended
to use this>
0 ~ 320
4/4
Left coordinate of window position.
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is
equal or greater than 0400a.
top
<Not recommended
to use this>
0 ~ 240
4/4
Top coordinate of window position.
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is
equal or greater than 0400a.
width
<Not recommended
to use this>
0 ~ 320
4/4
Width of motion detection window.
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is
equal or greater than 0400a.
height
<Not recommended
to use this>
0 ~ 240
4/4
Height of motion detection window.
* Only available when
"capability_motion_wintype" =
rectangle.
Loading page 275...
Loading page 276...
VIVOTEK
User's Manual - 277
© 2022 VIVOTEK INC. All Right Reserved
125
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
<Not recommended
to use this>
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is equal
or greater than 0400a.
top
<Not recommended
to use this>
0 ~ 240
4/4
Top coordinate of window position.
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is equal
or greater than 0400a.
width
<Not recommended
to use this>
0 ~ 320
4/4
Width of motion detection window.
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
* This parameter will not be used after
the version number (httpversion) is equal
or greater than 0400a.
height
<Not recommended
to use this>
0 ~ 240
4/4
Height of motion detection window.
* Only available when
"capability_motion_wintype" =
rectangle.
* Only available when qvga is listed in
"capability_motion_windomain".
* It's recommended to use polygonsd
VIVOTEK
278 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
126
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
* This parameter will not be used after
the version number (httpversion) is equal
or greater than 0400a.
7.17 Tampering Detection Settings
Group: tampering_c<0~(n-1)> for n channel products (capability_tampering > 0)
n denotes the value of "capability_nvideoin"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
4/4
Enable or disable tamper detection.
threshold 0~100 4/4 Threshold of tamper detection.
duration
10~600
4/4
If tampering value exceeds the
"threshold" for more than "duration"
second(s), then tamper detection is
triggered.
ignorewidth 0,<positive
integer>
1/7 Indicate the width to offset to start to
analysis the image.
dark_enable
<boolean>
4/4
Enable or disable image too dark
detection
dark_threshold 0~100 4/4 Threshold of image too dark detection
dark_duration
1~10
4/4
If image too dark value exceeds the
"threshold" for more than "duration"
second(s), then image too dark
detection is triggered.
bright_enable <boolean> 4/4 Enable or disable image too bright
detection
bright_threshold
0~100
4/4
Threshold of image too bright
detection
bright_duration 1~10 4/4 If image too bright value exceeds the
"threshold" for more than "duration"
second(s), then image too bright
detection is triggered.
blurry_enable
<boolean>
4/4
Enable or disable image too blurry
detection
blurry_threshold 0~100 4/4 Threshold of image too blurry
VIVOTEK
User's Manual - 279
© 2022 VIVOTEK INC. All Right Reserved
127
NAME VALUE SECURITY
(get/set)
DESCRIPTION
detection
blurry_duration 1~10 4/4 If image too blurry value exceeds the
"threshold" for more than "duration"
second(s), then image too blurry
detection is triggered.
7.18 DDNS
Group: ddns (capability_protocol_ddns > 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
6/6
Enable or disable the dynamic DNS.
provider DyndnsDynamic,
DyndnsCustom,
Safe100
6/6 DyndnsDynamic => dyndns.org
(dynamic)
DyndnsCustom => dyndns.org
Safe100 => safe100.net
<provider>_hostnam
e
string[128]
6/6
Your DDNS hostname.
<provider>_usernam
eemail
string[64] 6/6 Your user name or email to login to
the DDNS service provider
<provider>_passwor
dkey
string[64]
7/6
Your password or key to login to the
DDNS service provider.
7.19 Express Link
Group: expresslink
PARAMETER
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 6/6 Enable or disable express link.
state onlycheck,
onlyoffline,
checkonline,
badnetwork
6/6
Camera will check the status of network
environment and express link URL
url string[64] 6/6 The url user define to link to camera
VIVOTEK
280 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
128
7.20 UPnP Presentation
Group: upnppresentation
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
6/6
Enable or disable the UPnP
presentation service.
7.21 UPnP Port Forwarding
Group: upnpportforwarding
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 6/6 Enable or disable the UPnP port
forwarding service.
upnpnatstatus
0~3
6/7
The status of UPnP port forwarding,
used internally.
0 = OK, 1 = FAIL, 2 = no IGD router, 3 =
no need for port forwarding
7.22 System Log
Group: syslog
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enableremotelog <boolean> 6/6 Enable remote log.
serverip
<IP address>
6/6
Log server IP address.
serverport 514, 1025~65535 6/6 Server port used for log.
level
0~7
6/6
Levels used to distinguish the
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
Loading page 281...
VIVOTEK
282 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
130
7.24 Layout Configuration
Group: layout
NAME VALUE SECURITY
(get/set)
DESCRIPTION
logo_default
<boolean>
1/6
0 => Custom logo
1 => Default logo
logo_link string[128]
http://www.vivot
ek.com
1/6 Hyperlink of the logo
logo_powerbyvvtk_hidd
en
<boolean>
1/6
0 => display the power by vivotek logo
1 => hide the power by vivotek logo
custombutton_manualtr
igger_show
<boolean> 1/6 Show or hide manual trigger (VI)
button in homepage
0 -> Hidden
1 -> Visible
theme_option
1~4
1/6
1~3: One of the default themes.
4: Custom definition.
theme_color_font string[7] 1/6 Font color
theme_color_configfont string[7] 1/6 Font color of configuration area.
theme_color_titlefont string[7] 1/6 Font color of video title.
theme_color_controlba
ckground
string[7]
1/6
Background color of control area.
theme_color_configbac
kground
string[7] 1/6 Background color of configuration
area.
theme_color_videoback
ground
string[7]
1/6
Background color of video area.
theme_color_case string[7] 1/6 Frame color
defaultpassword_specia
lcharacter
!%-.@^_~ 6/7 Allowed special characters
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314b.
defaultpassword_type
<positive
integer>
6/7
Required character type for password.
An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => Require English alphabet
letter (uppercase or lowercase)
VIVOTEK
User's Manual - 283
© 2022 VIVOTEK INC. All Right Reserved
131
NAME VALUE SECURITY
(get/set)
DESCRIPTION
Bit 1 => Require special character
Bit 2 => Require digit number
Bit 3 => Require lowercase letter
Bit 4 => Require uppercase letter
Bit 5 => Allow checking username and
password; if "bit=1" means
username=password is allowed,
otherwise is not allowed.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314b.
defaultpassword_length 8 ~ 64 6/7 Allowed password length.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314b.
VIVOTEK
284 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
132
7.25 Privacy Mask
Group: privacymask_c<0~(n-1)> for n channel products and m privacy mask window.
n denotes the value of "capability_nvideoin" and m denotes the value of
"capability_videoin_c<0~(n-1)>_nprivacymask"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
4/4
Enable privacy mask.
win_i<0~(m-1)>_enable <boolean> 4/4 Enable privacy mask window.
win_i<0~(m-1)>_name string[14] 4/4 Name of the privacy mask window.
win_i<0~(m-1)>_left 0 ~ 320 4/4 Left coordinate of window position.
* Only available when
"capability_image_c<0~(n-1)>_privacy
mask_wintype" = rectangle.
* If the image is rotated by 90 or 270
degrees, the range of left coordinate
is 0~240.
win_i<0~(m-1)>_top
0 ~ 240
4/4
Top coordinate of window position.
* Only available when
"capability_image_c<0~(n-1)>_privacy
mask_wintype" = rectangle.
* If the image is rotated by 90 or 270
degrees, the range of top coordinate
is 0~320.
win_i<0~(m-1)>_width 0 ~ 320 4/4 Width of privacy mask window.
* Only available when
"capability_image_c<0~(n-1)>_privacy
mask_wintype" = rectangle.
* If the image is rotated by 90 or 270
degrees, the range of width is 0~240.
win_i<0~(m-1)>_height
0 ~ 240
4/4
Height of privacy mask window.
* Only available when
"capability_image_c<0~(n-1)>_privacy
mask_wintype" = rectangle.
* If the image is rotated by 90 or 270
degrees, the range of height is 0~320.
win_i<0~(m-1)>_polygo 0 ~ 320,0 ~ 240, 4/4 Coordinate of polygon window
VIVOTEK
User's Manual - 285
© 2022 VIVOTEK INC. All Right Reserved
133
NAME VALUE SECURITY
(get/set)
DESCRIPTION
n
0 ~ 320,0 ~ 240,
0 ~ 320,0 ~ 240,
0 ~ 320,0 ~ 240
position.
(4 points: x0,y0,x1,y1,x2,y2,x3,y3)
* Only available when
"capability_image_c<n>_privacymask
_wintype" = polygon.
* Only available when qvga is listed in
"capability_image_c<0~(n-1)>_privacy
mask_windomain".
win_i<0~(m-1)>_polygo
npx
0 ~ W,0 ~ H,
0 ~ W,0 ~ H,
0 ~ W,0 ~ H,
0 ~ W,0 ~ H
W: 0~ The
current image
width -1
H: 0~ The current
image height -1
4/4 Coordinate of polygon window
position.
(4 points: x0,y0,x1,y1,x2,y2,x3,y3)
* Only available when
"capability_image_c<0~(n-1)>_privacy
mask_wintype" = polygon.
* Only available when px is listed in
"capability_image_c<0~(n-1)>_privacy
mask_windomain".
win_i<0~(m-1)>_polygo
nstd
0 ~ 9999,0 ~
9999, 0 ~ 9999,0
~ 9999, 0 ~
9999,0 ~ 9999, 0
~ 9999,0 ~ 9999
4/4
Coordinate of polygon window
position.
(4 points: x0,y0,x1,y1,x2,y2,x3,y3)
* Only available when
"capability_image_c<0~(n-1)>_privacy
mask_wintype" = polygon.
* Only available when std is listed in
"capability_image_c<0~(n-1)>_privacy
mask_windomain".
7.26 3D Privacy Mask
Group: privacymask3d_c<0~(n-1)> for n channel products and m privacy mask window.
(capability_image_c<0~(n-1)>_privacymask_wintype = 3Drectangle)
n denotes the value of "capability_nvideoin" and m denotes the value of
"capability_videoin_c<0~(n-1)>_nprivacymask"
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable <boolean> 4/4 Enable the 3D privacy mask
Loading page 286...
Loading page 287...
Loading page 288...
VIVOTEK
User's Manual - 289
© 2022 VIVOTEK INC. All Right Reserved
137
NAME VALUE SECURITY
(get/set)
DESCRIPTION
nvideoout
0, <Positive Integer>
0/7
Number of video out interface.
nvideoinprofile <positive integer> 0/7 Number of video input profiles.
nmediastream <positive integer> 0/7 Number of media stream per
channels.
naudiosetting
<Not support
anymore>
<positive integer> 0/7 Number of audio settings per channel.
* Not support this parameter
anymore when the version number
(httpversion) is equal or greater than
0301a.
* We replace "naudiosetting" with
"naudioin". More details, please refer
the parameter description of
"volume_internal" and
"volume_external".
nuart 0,
<positive integer>
0/7 Number of UART interfaces.
nmotion <positive integer> 0/7 The number of motion window.
nmotionprofile
0, <positive integer>
0/7
Number of motion profiles.
nevent 0, <positive integer> 0/7 Number of event.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0311c.
nrecording 0, <positive integer> 0/7 Number of recording.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0309a.
ptzenabled 0, <positive integer> 0/7 An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => Support camera control
function;
0(not support), 1(support)
Bit 1 => (only available when bit0 is 1)
Built-in or external video source;
0(external), 1(built-in)
Bit 2 =>
(only available when bit0 is 1)
Loading page 290...
Loading page 291...
VIVOTEK
292 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
140
NAME VALUE SECURITY
(get/set)
DESCRIPTION
group for 1st channel, bit 16~31 are
the 2nd group for 2nd channel.
nvideoin = 3, bit 0~9 are the 1st group
for 1st channel, bit 10~19 are the 2nd
group for 2nd channel, bit 20~31 are
the 3rd group for 3rd channel.
Then, the 1st bit of the group
indicates 1st stream of a channel
support ePTZ or not. The 2nd bit of
the group indicates 2nd stream of a
channel support ePTZ or not, and so
on.
* For most products, the last stream
of a channel will not support ePTZ. It
is reserved for full view of the
channel. For some dual-stream
products, both streams support ePTZ.
nanystream 0, <positive integer> 0/7 number of any media stream per
channel
iva
<boolean>
0/7
Indicate whether to support
Intelligent Video analysis
whitelight
<Not
recommended to
use this>
<boolean> 0/7 Indicate whether to support white
light led.
* We replace this parameter with
"capability_daynight_c<0~(n-1)>_built
inwled" when the version number
(httpversion) is equal or greater than
0309d.
iris
<boolean>
0/7
Indicate whether to support iris
control.
supportsd <boolean> 0/7 Indicate whether to support local
storage.
fisheye
<boolean>
0/7
The parameter is used to determine
whether the product is fisheye or not.
tampering <boolean> 0/7 Indicate whether to support
tampering detection.
Loading page 293...
Loading page 294...
VIVOTEK
User's Manual - 295
© 2022 VIVOTEK INC. All Right Reserved
143
NAME VALUE SECURITY
(get/set)
DESCRIPTION
protocol_ipv6
<boolean>
0/7
Indicate whether to support IPv6.
protocol_pppoe <boolean> 0/7 Indicate whether to support PPPoE.
protocol_ieee8021
x
<boolean> 0/7 Indicate whether to support
IEEE802.1x.
protocol_qos_cos <boolean> 0/7 Indicate whether to support CoS.
protocol_qos_dscp
<boolean>
0/7
Indicate whether to support
QoS/DSCP.
protocol_ddns <boolean> 0/7 Indicate whether to support DDNS.
protocol_ftp_serve
r
<positive integer> 0/7 An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => ftp;
Bit 1=> sftp;
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314a.
protocol_ftp_client <positive integer> 0/7 An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => ftp;
Bit 1=> sftp;
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314a.
videoin_type 0, 1, 2 0/7 0 => Interlaced CCD
1 => Progressive CCD
2 => CMOS
videoin_nresolutio
n
<positive integer> 0/7 This equals
"capability_videoin_c0_nresolution".
* This is kept for compatibility.
videoin_resolution A list of <WxH>
<product dependent>
0/7 This equals
"capability_videoin_c0_resolution".
* This is kept for compatibility.
videoin_maxframer
ate
A list of <Integer> 0/7 This equals
"capability_videoin_c0_maxframerate
".
VIVOTEK
296 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
144
NAME VALUE SECURITY
(get/set)
DESCRIPTION
* This is kept for compatibility.
videoin_mjpeg_ma
xframerate
A list of <Integer> and
"-"
0/7 This equals
"capability_videoin_c0_mjpeg_maxfra
merate".
* This is kept for compatibility.
videoin_h264_max
framerate
A list of <Integer> and
"-"
0/7 This equals
"capability_videoin_c0_h264_maxfra
merate".
* This is kept for compatibility.
videoin_codec mjpeg, h264, h265
<product dependent>
0/7 Available codec of a device, split by
comma.
The sequence is not limited.
EX:
FD8183 supports H.264 and MJPEG,
then this is "mjpeg,h264".
IP9171 supports H.264, MJPEG and
H.265, then this is "mjpeg,h264,h265"
videoin_streamcod
ec
A list of <Positive
Integer>
0/7 This equals
"capability_videoin_c0_streamcodec".
* This is kept for compatibility.
videoin_flexiblebitr
ate
<boolean> 0/7 Indicate whether to support
flexible bit rate control.
videoout_codec A list of the available
codec types separated
by commas
<product dependent>
0/7 Available codec list.
"-": not supported
timeshift <boolean> 0/7 Indicate whether to support time shift
caching stream.
audio_aec <boolean> 0/7 Indicate whether to support acoustic
echo cancellation.
audio_aecmode auto,
manual
0/7 Indicate the acoustic echo
cancellation control mode.
"auto": control by camera
automatically.
"manual": Manually turn on/off the
control mode.
Loading page 297...
VIVOTEK
298 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
146
NAME VALUE SECURITY
(get/set)
DESCRIPTION
For example:
"maxframerate: fixed:15" which
means the max frame rate is 15fps
when acoustic echo cancellation
function is enabled.
"-" means no feature is affected.
* Only available when
"capability_audio_aec" is "1".
* We support this parameter when
the version number (httpversion) is
equal or greater than 0306b.
audio_mic
<Not support
anymore>
<boolean> 0/7 Indicate whether to support built-in
microphone input.
* Not support this parameter
anymore when the version number
(httpversion) is equal or greater than
0301a.
* We replace "audio_mic" with
"audio_intmic".
audio_intmic
<0~Positive Integer>
0/7
Internal (Built-in) Microphone.
0: Not support
1: Support
Bit 0 for CH0, bit 1 for CH1, and so on.
audio_extmic <0~Positive Integer> 0/7 External Microphone.
0: Not support
1: Support
Bit 0 for CH0, bit 1 for CH1, and so on.
audio_alarm
<0~Positive Integer>
0/7
0: Not support audio alarm.
1: Support audio alarm.
Bit 0 for CH0, bit 1 for CH1, and so on.
audio_linein
<Not support
anymore>
<boolean> 0/7 Indicate whether to support external
line input.
* Not support this parameter
anymore when the version number
(httpversion) is equal or greater than
0301a.
VIVOTEK
User's Manual - 299
© 2022 VIVOTEK INC. All Right Reserved
147
NAME VALUE SECURITY
(get/set)
DESCRIPTION
* It will be replaced by audio_intmic
and audio_extmic.
audio_lineout <boolean> 0/7 Indicate whether to support line
output.
audio_michardwar
eswitch
<boolean>
0/7
Indicate whether the hardware
supports built-in/external mic switch
audio_headphoneo
ut
<Not support
anymore>
<boolean> 0/7 Indicate whether to support
headphone output.
* Not support this parameter
anymore when the version number
(httpversion) is equal or greater than
0301a.
audio_audioclip
<boolean>
0/7
Indicate whether to support audio clip
function.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0309a.
audioin_codec aac4, gamr, g711,
g726, -
<product dependent>
0/7 Available audio codec. We take
comma to split codec without any
space.
"aac4": Advanced Audio Coding (AAC)
"gamr": Adaptive Multi-Rate (AMR)
"g711": G.711
"g726": G.726
"-": Not supported.
audioout_codec
g711, -
<product dependent>
0/7
Available codec list for SIP.
"-": Not supported.
motion_wintype rectangle, polygon,- 0/7 The supported motion window type.
"polygon": The window is a 2D
polygon shape.
"rectangle": The window is a 2D
rectangle shape.
"-": Not supported.
motion_windomai
n
qvga, px, std, -
0/7
The domain to set an motion window.
"qvga": a 320x240 range to represent
VIVOTEK
300 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
148
NAME VALUE SECURITY
(get/set)
DESCRIPTION
the whole image.
"px": Locate a window in the image
with pixels.
"std": A normalized 0~9999 range.
"-": Not supported.
smartstream_supp
ort
<boolean> 0/7 Indicate whether smart stream is
supported.
smartstream_versi
on
<integer>
0/7
Number of smart stream version.
* Only available when
"capability_smartstream_support" is 1
smartstream_nstre
am
<positive integer> 0/7 Number of stream that support smart
stream.
* Only available when
"capability_smartstream_support" is 1
smartstream_wind
omain
qvga, px, std, -
0/7
The domain to set an focus window.
"qvga": a 320x240 range to represent
the whole image.
"px": Locate a window in the image
with pixels.
"std": A normalized 0~9999 range.
"-": Not supported.
* Only available when
"capability_smartstream_support" is 1
smartstream_mod
e_autotracking
<boolean> 0/7 Indicate whether autotracking smart
stream is supported.
* Only available when
"capability_smartstream_support" is 1
smartstream_mod
e_manual
<boolean>
0/7
Indicate whether manual smart
stream is supported.
* Only available when
"capability_smartstream_support" is 1
smartstream_mod
e_hybrid
<boolean> 0/7 Indicate whether hybrid(autotracking+
manual) smart stream is supported.
* Only available when
"capability_smartstream_support" is 1
smartstream_nwin
<positive integer>
0/7
Maximum number of tracking window
VIVOTEK
User's Manual - 301
© 2022 VIVOTEK INC. All Right Reserved
149
NAME VALUE SECURITY
(get/set)
DESCRIPTION
dow_autotracking
of autotracking.
* Only available when
"capability_smartstream_support" is 1
smartstream_nwin
dow_manual
<positive integer> 0/7 Maximum number of tracking window
of manual.
* Only available when
"capability_smartstream_support" is 1
smartstream_nwin
dow_hybrid_autotr
acking
<positive integer>
0/7
Maximum number of tracking window
of autotracking in hybrid mode.
* Only available when
"capability_smartstream_support" is 1
smartstream_nwin
dow_hybrid_manu
al
<positive integer> 0/7 Maximum number of tracking window
of manual in hybrid mode.
* Only available when
"capability_smartstream_support" is 1
vadp_supportfeatu
re
<positive integer>
0/7
An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => VADP interface
Bit 1 => Capture video raw data
Bit 2 => Support encode jpeg
Bit 3 => Capture audio raw data
Bit 4 => Support event trigger
Bit 5 => Support license registration
Bit 6 => Support shared memory API
Bit 7 => Support digital signature of
package
Bit 8 => Support snapshot
Bit 9 => Support upload encrypted
package
vadp_npackage <positive integer> 0/7 Indicate the maximum number of
VADP package that can be uploaded
to the device.
camctrl_httptunnel
<Not support
anymore>
<boolean>
0/7
Indicate whether to support
httptunnel.
* Not support this parameter
anymore when the version number
Loading page 302...
Loading page 303...
Loading page 304...
Loading page 305...
VIVOTEK
306 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
154
NAME VALUE SECURITY
(get/set)
DESCRIPTION
One bit represents one channel.
Ex: “3” means channel 0 and channel1
support seamless recording .
* Only available when
"capability_supportsd" is 1 or
"capability_storage_dbenabled" is 1.
localstorage_modn
um
<Not
recommended to
use this>
0,
<positive integer>
0/7 The maximum MOD connection
numbers.
* Only available when
"capability_supportsd" is 1 or
"capability_storage_dbenabled" is 1.
* We replace this parameter with
“capability_storage_management_mo
dnum” when the version number
(httpversion) is equal or greater than
0312a.
localstorage_modv
ersion
<string>
0/7
Indicate MOD daemon version.
* Only available when
"capability_supportsd" is 1 or
"capability_storage_dbenabled" is 1.
localstorage_storm
grversion
<string> 0/7 Indicate storage manager daemon
version.
* Only available when
"capability_supportsd" is 1 or
"capability_storage_dbenabled" is 1.
localstorage_suppo
rtedge
0,
<positive integer>
0/7
An 32-bit integer, which indicates the
supportive application of edge
storage.
If the value of this parameter is larger
than 0, it means that the camera
supports edge recording function.
bit 0 : It supports to record directly to
an on-board SD-Card.
bit 1~: Currently, they are reserved
bit, and the default value is 0.
* Only available when
Loading page 307...
VIVOTEK
308 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
156
NAME VALUE SECURITY
(get/set)
DESCRIPTION
layout_redirection
<string>
0/7
Indicate which function will be
redirected to the vadp package path.
"-": Not supported.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0309a.
securecam_suppor
t
<Boolean> 0/7 Indicate support for security camera.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314a.
securecam_version
<string>
0/7
Indicate the security camera feature
phases.
* Only available when
capability_securecam_support=1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314a.
taics_support <boolean> 0/7 Support the feature for Video
Surveillance System Security from
TAICS.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314b.
taics_level
0, <positive integer>
0/7
Indicate the support level for Video
Surveillance System Security from
TAICS.
* Only available when
"capability_taics_support" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0314b.
cameralink_suppor
t
<Boolean> 0/7 Indicate support for the feature of
camera link.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0315a.
VIVOTEK
User's Manual - 309
© 2022 VIVOTEK INC. All Right Reserved
157
NAME VALUE SECURITY
(get/set)
DESCRIPTION
cameralink_num
0, <positive integer>
0/7
Indicate the maximum number of
receiver camera link.
* Only available when
"capability_cameralink_support" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0315a.
cameralink_version <integer> 0/7 Indicate the version of camera link
feature.
* Only available when
"capability_cameralink_support" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0315a.
7.27.1 Capability for Camctrl
Group: capability_camctrl_c<0~(n-1)> n denotes the value of "capability_nvideoin"
(capability_ptzenabled > 0)
* We support this group when the version number (httpversion) is equal or greater than 0303b.
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
ptztunnel
<boolean>
0/7
Indicate whether to support ptztunnel
in this video input.
privilege <boolean> 0/7 Indicate whether to support “Manage
Privilege” of PTZ control in the security
page in this video input.
1: support both
/cgi-bin/camctrl/camctrl.cgi and
/cgi-bin/viewer/camctrl.cgi
0: support only
/cgi-bin/viewer/camctrl.cgi
rs485
<boolean>
0/7
An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => support rs485-in
Bit 1 => support rs485-out
VIVOTEK
310 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
158
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
buildinpt
<boolean>
0/7
An 32-bit integer, each bit can be set
separately as follows:
Bit 0 => support build-in pan
Bit 1 => support build-in tilt
zoommodule <boolean> 0/7 Indicate whether to support zoom lens.
In our product, only SD series and IZ
series use the zoom lens.
* Both varifocal and zoom lenses are
built with movable elements that
permit changing the effective focal
length. And the key difference between
a varifocal and a zoom lens can be
explained by thinking about a lens that
has been focused on an object at any
focal length. A varifocal will need to be
refocused whenever the focal length is
adjusted; the zoom will stay in focus
when the focal length is adjusted.
VIVOTEK
User's Manual - 311
© 2022 VIVOTEK INC. All Right Reserved
159
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
focusmode
auto,onetimeauto,sp
otlight,manual
<product
dependent>
0/7
Focus mode selection:
"auto": Camera will automatically
adjust the focus position full time to
adapt a clear picture.
"onetimeauto": Camera will
automatically adjust the focus position
one time, which follows any PTZ
control.
"spotlight": Camera will automatically
adjust the focus position full time, and
to consider a spotlight avoidance
situation.
"manual": Turn off the automatically
focus function. For user to control the
focus position manually as their
purpose.
* Only available when
"capability_camctrl_c<0~(n-1)_zoommo
dule" is 1.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0304a.
digitalzoom_support <boolean> 0/7 Indicate the lens support digital zoom
or not.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0317a.
7.27.2 Capability for PTZ
Group: capability_ptz_c<0~(n-1)> n denotes the value of "capability_nvideoin"
(capability_ptzenabled > 0 and capability_camctrl_c<0~(n-1)>_zoommodule !=0)
* We support this group when the version number (httpversion) is equal or greater than 0303b.
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
VIVOTEK
312 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
160
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
panspeedlv
0, <positive integer>
0/7
The maximum speed level of pan
motion.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
minpan 0, <positive integer> 0/7 The lower limit for pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
maxpan
0, <positive integer>
0/7
The upper limit for pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
minpanangle <integer> 0/7 The lower limit for pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
maxpanangle
<integer>
0/7
The upper limit for pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
tiltspeedlv 0, <positive integer> 0/7 The maximum speed level of tilt
motion.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
mintilt
0, <positive integer>
0/7
The lower limit for tilt position.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
maxtilt 0, <positive integer> 0/7 The upper limit for tilt position.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
VIVOTEK
User's Manual - 313
© 2022 VIVOTEK INC. All Right Reserved
161
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
mintiltangle
<integer>
0/7
The lower limit for tilt angle.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
maxtiltangle <integer> 0/7 The upper limit for tilt angle.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildin
pt" is "1"
zoomspeedlv
0, <positive integer>
0/7
The maximum speed level of zoom
motion.
*Only available when the value of
"capability_camctrl_c<0~(n-1)>_zoomm
odule" is "1"
minzoom 0, <positive integer> 0/7 The lower limit for zoom position.
*Only available when the value of
"capability_camctrl_c<0~(n-1)>_zoomm
odule" is "1"
maxzoom
0, <positive integer>
0/7
The upper limit for zoom position.
*Only available when the value of
"capability_camctrl_c<0~(n-1)>_zoomm
odule" is "1"
maxdzoom 0, <positive integer> 0/7 The upper limit for digital zoom
position.
*Only available when the value of
"capability_camctrl_c<0~(n-1)>_zoomm
odule" is "1"
focusspeedlv
0, <positive integer>
0/7
The maximum speed level of focus
motion.
*Only available when the value of
"capability_camctrl_c<0~(n-1)>_zoomm
odule" is "1"
minfocus 0, <positive integer> 0/7 The lower limit for focus position.
*Only available when the value of
"capability_camctrl_c<0~(n-1)>_zoomm
odule" is "1"
Loading page 314...
Loading page 315...
VIVOTEK
316 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
164
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
ircutsensitivity_supportle
vel
0,
<positive integer>
0/7
The value indicate the support strength
level of ircutsensitivity.
* Only available when
"capability_daynight_c<0~(n-1)>_suppo
rt" is 1 and
"capability_daynight_c<0~(n-1)>_ircuts
ensitivity_type" is not "-".
* We support this parameter when the
version number (httpversion) is equal or
greater than 0302a.
extled_interface
do
<product
dependent>
0/7 The device interface of external IR led:
"do": digital output
* Only available when
"capability_daynight_c<0~(n-1)>_extern
alir" is 1
* We replaced this parameter with
“capability_daynight_illuminators_exter
nal_interface” when the version
number (httpversion) is equal or greater
than 0312a.
spectrum_support
<boolean>
0/7
Indicate whether to support proposed a
brightness enhancement method based
on CCM(Color Correction Matrix) model
to improve the brightness effect of the
images if the IR and blue light exists.
* Only available when
"capability_daynight_c<0~(n-1)>_suppo
rt" is 1
* We replaced this parameter with
“capability_daynight_illuminators_spect
rum_support” when the version
number (httpversion) is equal or greater
than 0312a.
Loading page 317...
VIVOTEK
318 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
166
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
mode
auto,daynight,di,di2,
di3,di4,schedule,-
<product
dependent>
0/7
Indicate the day / night switch mode.
"auto": The Camera automatically
judges the current operation mode by
the level of ambient light detected.
"daynight": support day mode and night
mode. In day mode, the camera
streams color video. In night mode, the
camera streams black and white video
in low light environments.
"di": the camera automatically switches
the cu
rrent mode when a ditigal input 1
is triggered.
"di2": the camera automatically
switches the current mode when a
ditigal input 2 is triggered.
"di3": the camera automatically
switches the current mode when a
ditigal input 3 is triggered.
"di4": the camera automatically
switches the current mode when a
ditigal input 4 is triggered.
"schedule": The Camera switches
between day mode and night mode
based on a specified schedule.
"-": not support
* We support this parameter when the
version number (httpversion) i
s equal or
greater than 0309d.
7.27.4 Capability for IR Illuminators
Group: capability_daynight_illuminators
PARAMETER
VALUE
SECURITY
(get/set)
DESCRIPTION
Loading page 319...
Loading page 320...
Loading page 321...
Loading page 322...
VIVOTEK
User's Manual - 323
© 2022 VIVOTEK INC. All Right Reserved
171
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
rotationaffect
-
<product
dependent>
0/7
When rotation is enabled, some features
may become malfunction or be forced to a
given value. The affected functions are list
here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into following
groups:
- (disabled) : UI turns grey and users can't
select it.
-
(unchanged) : UI keeps the status as before
and user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple selections
or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function is not
available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:" which
means blc exposure window is disabled. API
name can be one word as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative integer
or string or NULL.
"-" means no feature is affected.
* When "rotation"=0, this value must be "-"
* We support this parameter when the
version number (httpversion) is equal or
greater than 0304b.
VIVOTEK
324 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
172
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
rotationangle
<string>
0/7
The different angles which camera supports
for rotation.
* Only avaliable when
"capability_videoin_c<0~(n-1)>_rotation" is
1.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309b.
orientation flip,mirror,rotatio
n
<product
dependent>
0/7
Indicates the camera supports flip, mirror or
rotation.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309b.
streamcodec
<positive integer>
0/7
Represent supported codec types of each
stream.
This contains a list of positive integers, split
by comma. Each one stands for a stream,
and the definition is as following:
Bit 0: Support MPEG4.
Bit 1: Support MJPEG
Bit 2: Support H.264
Bit 3: Support H.265
mode 0,<positive
integer>
0/7 Indicate current video mode.
nmode
<positive integer>
0/7
Indicate how many video modes supported
by this channel.
maxsize <WxH> 0/7
The maximum resolution of all modes in this
channel, the unit is pixel.
nprivacymask
0, <positive
integer>
0/7
Number of privacy mask per channel
nresolution <positive integer> 0/7 The maximum resolution options (listed in
"resolution") in current video mode.
VIVOTEK
User's Manual - 325
© 2022 VIVOTEK INC. All Right Reserved
173
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
resolution
A list of <WxH>
<product
dependent>
0/7
Resolution options in current video mode.
These options are the possible options for
"videoin_c<n>_s<m>_resolution".
The last one is the maximum resolution in
current mode.
maxresolution A list of <Integer> 0/7 Represent supported maximum resolution
of each stream in current video mode.
* The element number is defined as
"capability_nmediastream".
minresolution
A list of <Integer>
0/7
Represent supported minimum resolution
of each stream in current video mode.
* The element number is defined as
"capability_nmediastream".
* We support this parameter when the
version number (httpversion) is equal or
greater than 0304b.
maxframerate A list of <Integer> 0/7 Indicate frame rate that the video source
outputs in current video mode.
One to one mapping to the resolution in
"resolution".
* The element number is defined as
"nresolution" in this group.
* This parameter may be changed when
"videoin_c<n>_cmosfreq"=50 or
"videoin_c<n>_modulation"=pal.
Ex: 30 fps is changed to 25 fps, 60 fps is
changed to 50 fps, and so on.
Loading page 326...
VIVOTEK
User's Manual - 327
© 2022 VIVOTEK INC. All Right Reserved
175
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
h264_maxbitrate
<positive integer>
0/7
Maximum bitrates of H.264.
The unit is bps.
* Only available when 'h264' is listed in
"capability_videoin_codec".
h264_profile baseline,main,hig
h
<product
dependent>
0/7 Indicate H264 profiles
* Only available when 'h264' is listed in
"capability_videoin_codec".
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309a.
h265_maxframerate
A list of <Positive
Integer> and "-"
0/7
Maximum fps that the device can encoded
with H.265 on resolutions in current video
mode.
"-" means not support.
* One to one mapping to the resolution in
"resolution".
* The element number is defined as
"nresolution" in this group.
* This parameter may be changed when
"videoin_c<n>_cmosfreq"=50 or
"videoin_c<n>_modulation"=pal.
Ex: 30 fps is changed to 25 fps, 60 fps is
changed to 50 fps, and so on.
* Only available when 'h265' is listed in
"capability_videoin_codec".
h265_maxbitrate <positive integer> 0/7 Maximum bitrates of H.265.
The unit is bps.
* Only available when 'h265' is listed in
"capability_videoin_codec".
h265_profile
main,main10
<product
dependent>
0/7
Indicate H265 profiles
* Only available when 'h265' is listed in
"capability_videoin_codec".
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309a.
VIVOTEK
328 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
176
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
fisheye_mounttype
<Not recommended
to use this>
ceiling, wall, floor
<product
dependent>
0/7
Indicate the supported type.
wall mount: 180° panoramic view
ceiling mount: 360° surround view without
blind spots
floor mount: 360° surround view without
blind spots
* Only available when "
capability_fisheye" >
0
* It's recommended to use
"capability_videoin_c<0~(n-1)>_mounttype"
mounttype ceiling, wall,
floor,-
<product
dependent
* Available values
are listed in "
capability_videoin
_c<0~(n-1)>_mou
nttype "
0/7 Indicate the supported mount type.
"-": not support
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309c.
dintraperiod_support
<boolean>
0/7
0: Non-support "Dynamic intra frame
period"
1: Support "Dynamic intra frame period"
"Dynamic intra frame period" can be used
to reduce bitrate by reducing the number of
I-frame.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0301c.
VIVOTEK
User's Manual - 329
© 2022 VIVOTEK INC. All Right Reserved
177
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
cameraunit_name
CU8131,
CU8171,
CU8161-H,
CU8162-H,
CU8163-H,
CU8361-H,
...,
-
<product
dependent>
0/7
A "camera unit" name of a split-type camera
system, which the camera unit and the
video core are separated.
-: If the camera is not a split-type camera
system, the value of this parameter is "-".
* We support this parameter when the
version number (httpversion) is equal or
greater than 0302b.
cmosfreq_support <boolean> 0/7 0: The power line frequency(50/60Hz) is
detected by camera automatically.
1: The power line frequency(50/60Hz) can
be set by user.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0308a.
smartfps_support
<boolean>
0/7
Indicate whether to support Smart fps
function.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309a.
smartq_support <boolean> 0/7 Indicate whether to support Smart Q
function.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0309a.
7.27.7 Capability for Local Dewarp
Group: capability_videoin_c<0~(n-1)>_localdewarp
(capability_fisheyelocaldewarp_c<0~(capability_nvideoin)-1> > 0)
n denotes the value of "capability_nvideoin"
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
typeceilingmount
1O, 1P, 2P, 1R, 4R
0/7
Available dewarp types of ceiling and
floor mount.
VIVOTEK
330 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
178
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
typewallmount
1O, 1P, 1R, 4R
0/7
Available dewarp types of wall mount.
resolutionC1P A list of <WxH> 0/7 Available resolutions of 1P mode of
ceiling and floor mount.
resolutionC2P A list of <WxH> 0/7 Available resolutions of 2P mode of
ceiling and floor mount.
resolutionC1R A list of <WxH> 0/7 Available resolutions of 1R mode of
ceiling and floor mount.
resolutionC4R A list of <WxH> 0/7 Available resolutions of 4R mode of
ceiling and floor mount.
resolutionW1P A list of <WxH> 0/7
Available resolutions of 1P mode of wall
mount.
resolutionW1R A list of <WxH> 0/7
Available resolutions of 1R mode of wall
mount.
resolutionW4R A list of <WxH> 0/7
Available resolutions of 4R mode of wall
mount.
panorama_pancontrol <Boolean> 0/7 Indicate whether to support
localdewarp panorama pan control.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0312b.
7.27.8 Capability for Video Mode
Group: capability_videoin_c<0~(n-1)>_mode<0~(m-1)> n denotes the value of
"capability_nvideoin", m denotes the value of "capability_videoin_c<0~(n-1)>_nmode"
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
rotation <boolean> 0/7 Indicate this mode whether support
video rotation
Loading page 331...
VIVOTEK
332 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
180
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
eptz
0, <positive integer>
0/7
Indicate this mode whether support eptz.
For "nvideoin" = 1, the definition is as
following:
A 32-bits integer, each bit can be set
separately as follows:
Bit 0 => 1st stream supports ePTZ or not.
Bit 1 => 2nd stream supports ePTZ or not,
and so on.
For nvideoin >= 2, the definition is
different:
First all 32 bits are divided into groups for
channel.
Ex:
nvideoin = 2, bit 0~15 are the 1st group
for 1st channel, bit 16~31 are the 2nd
group for 2nd channel.
nvideoin = 3, bit 0~9 are the 1st group for
1st channel, bit 10~19 are the 2nd group
for 2nd channel, bit 20~31 are the 3rd
group for 3rd channel.
Then, the 1st bit of the group indicates
1st stream of a channel support ePTZ or
not. The 2nd bit of the group indicates
2nd stream of a channel support ePTZ or
not, and so on.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0304b.
wdrpro 0, 1, 2 0/7
Indicate this mode whether support WDR
pro.
0: Non-support WDR Pro
1: Support WDR Pro
2: Support WDR Pro II
* We support this parameter when the
version number (httpversion) is equal or
greater than 0304b.
Loading page 333...
Loading page 334...
VIVOTEK
User's Manual - 335
© 2022 VIVOTEK INC. All Right Reserved
183
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
maxfps_mjpeg
A list of <Positive
Integer> and "-"
0/7
Maximum fps which the device can
encoded with MJPEG on resolutions in
this video mode.
"-" means not support.
* One to one mapping to the resolution
in "resolution".
* The element number is defined as
"nresolution" in this group.
* This parameter records the frame rate
when
"videoin_c<0~(n-1)>_cmosfreq"=60 or
"videoin_c<0~(n-1)>_modulation"=ntsc
* Only available when 'mjpeg' is listed in
"capability_videoin_codec".
maxfps_h264 A list of <Positive
Integer> and "-"
0/7 Maximum fps which the device can
encoded with H.264 on resolutions in this
video mode.
"-" means not support.
* One to one mapping to the resolution
in "resolution".
* The element number is defined as
"nresolution" in this group.
* This parameter records the frame rate
when
"videoin_c<0~(n-1)>_cmosfreq"=60 or
"videoin_c<0~(n-1)>_modulation"=ntsc
* Only available when 'h264' is listed in
"capability_videoin_codec".
VIVOTEK
336 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
184
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
maxfps_h265
A list of <Positive
Integer> and "-"
0/7
Maximum fps which the device can
encoded with H.265
on resolutions in this
video mode.
"-" means not support.
* One to one mapping to the resolution
in "resolution".
* The element number is defined as
"nresolution" in this group.
* This parameter records the frame rate
when
"videoin_c<0~(n-1)>_cmosfreq"=60 or
"videoin_c<0~(n-1)>_modulation"=ntsc
* Only available when 'h265' is listed in
"capability_videoin_codec".
description <string[128]> 0/7 Description about this mode.
7.27.9 Capability for Image
Group: capability_image_c<0~(n-1)> n denotes the value of "capability_nvideoin"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
basicsetting 0, <positive
integer>
0/7 A 32-bits integer, each bit can be set
separately as follows:
Bit 0 => Supports Brightness or not.
Bit 1 => Supports Contrast or not.
Bit 2 => Supports Saturation or not.
Bit 3 => Supports Sharpness or not.
Bit 4 => Supports adjusting the image
to proper position horizontally or not.
Bit 5 => Supports adjusting the image
to proper position vertically or not.
hlm <boolean> 0/7 Hightlight Mask: The function will
strengthen the image contrast and
mask the specified zone of image if
any strong spot-light exists.
* We support this parameter when
the version number (httpversion) is
Loading page 337...
Loading page 338...
Loading page 339...
Loading page 340...
VIVOTEK
User's Manual - 341
© 2022 VIVOTEK INC. All Right Reserved
189
NAME VALUE SECURITY
(get/set)
DESCRIPTION
is_supportlevel
0, <positive
integer>
0/7
Indicate the support strength level of
image stabilizer mode.
* Only available when
"capability_image_c<0~(n-1)>_is_mod
e" is not "-".
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
is_affect -,
<x>: nonnegative
integer
<product
dependent>
0/7 When Is mode is not "-", some
features may become malfunction or
be forced to a given value. The
affected functions are list here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc: disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
Loading page 342...
Loading page 343...
VIVOTEK
344 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
192
NAME VALUE SECURITY
(get/set)
DESCRIPTION
dependent>
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc: disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* Only available when "railtrack" is
listed in
"capability_image_c<0~(n-1)>_scene
mode_supporttype" and
"capability_image_c<0~(n-1)>_scene
mode_support" is 1.
Loading page 345...
VIVOTEK
346 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
194
NAME VALUE SECURITY
(get/set)
DESCRIPTION
constant value.
"twovalues": Need two parameters to
indicate the exposure range.
* Only available when
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
exposure_shuttervalu
etype
fixed,
maximum,
ranged,
-
0/7 * One to one mapping to the mode
type in "exposure_modetype".
"fixed": The shutter value is the
assigned value
(videoin_c<0~(n-1)>_shuttervalue).
"maximum": The shutter value can be
up to the assigned value
(videoin_c<0~(n-1)>_shuttervalue).
"ranged": Need two parameters to
indicate the shutter range.
(videoin_c<0~(n-1)>_maxexposure/
videoin_c<0~(n-1)>_maxexposure)
"-": not support.
* Only available when
"shutterpriority" is listed in
"capability_image_c<0~(n-1)>_
exposure_modetype" and
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
exposure_gainvaluety
pe
fixed,
maximum,
ranged,
-
0/7
* One to one mapping to the mode
type in "exposure_modetype".
"fixed": The gain value is the assigned
value (videoin_c<0~(n-1)>_gainvalue).
VIVOTEK
User's Manual - 347
© 2022 VIVOTEK INC. All Right Reserved
195
NAME VALUE SECURITY
(get/set)
DESCRIPTION
"maximum": The gain value can be up
to the assigned value
(videoin_c<0~(n-1)>_gainvalue)
"ranged": Need two parameters to
indicate the gain range.
(videoin_c<0~(n-1)>_maxgain/
videoin_c<0~(n-1)>_maxgain)
"-": not support.
* Only available when "irispriority" or
"shutterpriority" is listed in
"capability_image_c<0~(n-1)>_
exposure_modetype" and
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
exposure_automode_
affect
-,
exposurewin.mode
.blc:hidden:,
defog:disabled:,
wdrpro:disabled:,
exposurelevel:hidd
en:,
defaultgain:fixed:x
or others
<x>: nonnegative
integer
<product
dependent>
0/7 When exposure auto mode is
enabled, some features may become
malfunction or be forced to a given
value. The affected functions are list
here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
VIVOTEK
348 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
196
NAME VALUE SECURITY
(get/set)
DESCRIPTION
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* Only available when auto is listed in
"capability_image_c<0~(n-1)>_
exposure_modetype" and
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
exposure_shutterprior
itymode_affect
-,
exposurewin.mode
.blc:hidden:,
defog:disabled:,
wdrpro:disabled:,
exposurelevel:hidd
en:,
defaultgain:fixed:x
or others
<x>: nonnegative
integer
<product
dependent>
0/7 When exposure shutter priority mode
is enabled, some features may
become malfunction or be forced to a
given value. The affected functions
are list here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
VIVOTEK
User's Manual - 349
© 2022 VIVOTEK INC. All Right Reserved
197
NAME VALUE SECURITY
(get/set)
DESCRIPTION
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* Only available when shutterpriority
is listed in
"capability_image_c<0~(n-1)>_
exposure_modetype" and
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
exposure_irispriority
mode_affect
-,
exposurewin.mode
.blc:hidden:,
defog:disabled:,
wdrpro:disabled:,
exposurelevel:hidd
en:,
0/7 When exposure iris priority mode is
enabled, some features may become
malfunction or be forced to a given
value. The affected functions are list
here.
The format is "Affect API
name":"Policy":"Description"
VIVOTEK
350 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
198
NAME VALUE SECURITY
(get/set)
DESCRIPTION
defaultgain:fixed:x
or others
<x>: nonnegative
integer
<product
dependent>
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* Only available when irispriority is
listed in
"capability_image_c<0~(n-1)>_
exposure_modetype" and
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0302a.
exposure_qualityprior -, 0/7 When exposure quality priority mode
VIVOTEK
User's Manual - 351
© 2022 VIVOTEK INC. All Right Reserved
199
NAME VALUE SECURITY
(get/set)
DESCRIPTION
itymode_affect
exposurewin.mode
.blc:hidden:,
defog:disabled:,
wdrpro:disabled:,
exposurelevel:hidd
en:,
defaultgain:fixed:x
or others
<x>: nonnegative
integer
<product
dependent>
is enabled, some features may
become malfunction or be forced to a
given value. The affected functions
are list here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* Only available when qualitypriority
is listed in
"capability_image_c<0~(n-1)>_
exposure_modetype" and
VIVOTEK
352 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
200
NAME VALUE SECURITY
(get/set)
DESCRIPTION
"capability_image_c<0~(n-1)>_
exposure_mode" is 1.
* We support this parameter when
the version number (httpversion) is
equal or greater than 0305a.
exposure_manualmod
e_affect
-,
exposurewin.mode
.blc:hidden:,
defog:disabled:,
wdrpro:disabled:,
exposurelevel:hidd
en:,
icrmode.auto:nots
upport:
or others
<x>: nonnegative
integer
<product
dependent>
0/7 When exposure manual mode is
enabled, some features may become
malfunction or be forced to a given
value. The affected functions are list
here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
Loading page 353...
VIVOTEK
354 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
202
NAME VALUE SECURITY
(get/set)
DESCRIPTION
in "capability_image_c<0~(n-1)>_
exposure_winmode".
exposure_hlcmode_af
fect
-,
sir:hidden:
or others
<x>: nonnegative
integer
<product
dependent>
0/7 When hlc mode is enabled, some
features may become malfunction or
be forced to a given value. The
affected functions are list here.
The format is "Affect API
name":"Policy":"Description"
"Policy" can be categorized into
following groups:
- (disabled) : UI turns grey and users
can't select it.
- (unchanged) : UI keeps the status as
before and
user can't change it.
- (hidden) : UI is hidden.
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* Only available when
"capability_image_c<0~(n-1)>_
Loading page 355...
Loading page 356...
Loading page 357...
Loading page 358...
VIVOTEK
User's Manual - 359
© 2022 VIVOTEK INC. All Right Reserved
207
NAME VALUE SECURITY
(get/set)
DESCRIPTION
- (fixed) : UI is fixed to one selection or
value.
- (ranged) : UI is fixed to multiple
selections or values.
- (enabled) : UI is checked.
- (notsupport) : the affected function
is not available.
"Affect API name" can be described in
hierarchy, such as
"exposurewin.mode.blc:disabled:"
which means blc exposure window is
disabled. API name can be one word
as well, such as
"exposurelevel:fixed:6" which means
exposurelevel is fixed to level 6.
"Description" can be a nonnegative
integer or string or NULL.
"-" means no feature is affected.
* When "flickerless" = 0, this value
must be "-"
defog_mode 0,1 0/7 0: Non-support defog
1: Support defog
defog_strength
0, 1
0/7
0: Non-support tuning strength of
defog
1: Support tuning strength of defog
* If
"capability_image_c<0~(n-1)>_defog_
mode"=1, this may be either 0 or 1.
defog_supportlevel 0, <positive
integer>
0/7 The value indicate the support
strength level of defog.
defog_affect
-,
wdrc:unchanged:
contrast:hidden:
or others
<x>: nonnegative
integer
0/7
When defog is enabled, some features
may become malfunction or be forced
to a given value. The affected
functions are list here.
The format is "Affect API
name":"Policy":"Description"
Loading page 360...
VIVOTEK
User's Manual - 361
© 2022 VIVOTEK INC. All Right Reserved
209
NAME VALUE SECURITY
(get/set)
DESCRIPTION
ivity
of AE converge speed.
1: Support tuning the sensitivity of AE
converge speed.
* Only available when
"capability_image_c<0~(n-1)>_aespee
d" is 1.
gammacurve 0,1 0/7 0: Non-support tuning Gamma curve
1: Support tuning Gamma curve
lowlightmode
-,0,1
0/7
-: Internal parameter, must not open
to u ser.
0: Non-support low light mode
1: Support low light mode
focusassist 0,1 0/7 0: Non-support focus assist
1: Support focus assist
remotefocus
0,<positive
integer>
0/7
An 4-bit integer, which indicates the
supportive application of remotefocus
in this channel.
If the value of this parameter is larger
than 0, it means that the camera
supports remotefocus function in this
channel.
bit 0 => Indicate whether to support
both zoom and focus function.
bit 1 => Only support zoom function.
bit 2 => Only support focus
function.
bit 3 => Currently, this is a reserved
bit, and the default value is 0.
focuswindomain qvga, px, std, - 0/7 The domain to set a focus window.
"qvga": a 320x240 range to represent
the whole image.
"px": Locate a window in the image
with pixels.
"std": A normalized 0~9999 range.
"-": Not supported.
focuswindow_nwindo
0,<positive
0/7
Number of focus window
Loading page 362...
Loading page 363...
VIVOTEK
364 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
212
NAME VALUE SECURITY
(get/set)
DESCRIPTION
equal or greater than 0310a.
focussystem_mode AFbyzoom,
focusshift, -
<product
dependent>
0/7 Supported features for remotefocus.
"AFbyzoom": Trigger autofocus if
zoom is operated.
"focusshift": Ability to adjust
day/night focus position.
"-": Not supported.
* Only available when
"capability_image_c<0~(n-1)>_remote
focus" > 0
* We support this parameter when
the version number (httpversion) is
equal or greater than 0316a
7.27.10 Capability for Peripheral Device
Group: capability_peripheral_c<0~(n-1)> n denotes the value of "capability_nvideoin"
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
devicecontrol
<boolean>
0/7
Indicate whether to support the
peripheral device control.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0305c.
devicemonitor_support <boolean> 0/7 Indicate whether to support overview
of all sensors and peripheral devices
status on camera.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0319a.
devicemonitor_tempnu
m
<integer>
0/7
Number of temperature sensors that
can be monitored.
* Only available when
"capability_peripheral_c<0~(n-1)>_devi
cemonitor_support" > 0
VIVOTEK
User's Manual - 365
© 2022 VIVOTEK INC. All Right Reserved
213
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
devicemonitor_heatern
um
<integer>
0/7
Number of sensor sensors that can be
monitored.
* Only available when
"capability_peripheral_c<0~(n-1)>_devi
cemonitor_support" > 0
7.27.11 Capability for Extension Modules
Group: capability_extension
PARAMETER
VALUE
SECURITY
(get/set)
DESCRIPTION
di_num <integer> 0/7 The number of supported extension
digital input module.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0316a.
do_num
<integer>
0/7
The number of supported extension
digital output module.
* We support this parameter when the
version number (httpversion
) is equal or
greater than 0316a.
7.27.12 Capability for Onvif
Group: capability_onvif
PARAMETER
VALUE
SECURITY
(get/set)
DESCRIPTION
dbsize <integer> 0/7 Indicate the maximum size (Megabyte)
of persistent notification storage.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0319a.
7.28 Event Setting
Group: event_i<0~(n-1)> n denotes the value of "capability_nevent"
(capability_nevent > 0)
VIVOTEK
366 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
214
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
name
string[40]
6/6
Identification of this entry.
enable 0, 1 6/6 Enable or disable this event.
priority 0, 1, 2 6/6 Indicate the priority of this event:
"0"= low priority
"1"= normal priority
"2"= high priority
delay 1~999 6/6 Delay in seconds before detecting the
next event.
trigger boot,
di,
pir,
motion,
seq,
recnotify,
tampering,
vi,
volalarm,
visignal,
vadp,
smartsd,
presetreached,
casingopen
<product
dependent>
6/6 Indicate the trigger condition:
"boot" = System boot.
"di"= Digital input.
"pir"= PIR detection.
"motion" = Video motion detection.
"seq" = Periodic condition.
"visignal" = Video input signal loss.
"recnotify" = Recording notification.
"tampering" = Tamper detection.
"vi"= Virtual input (Manual trigger).
"volalarm"= Audio detection.
"smartsd"= Lifetime detection of SD card.
"shockalarm" = Shock detection.
"virestore" = Video input signal restore.
"vadp" = VADP trigger.
"presetreached" = When any preset is
reached
"casingopen" = Casing open detection
* "smartsd" is only valid when smart SD
card is inserted
triggerstatus string[40] 6/6 The status for event trigger
Loading page 367...
Loading page 368...
Loading page 369...
VIVOTEK
370 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
218
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
foldername
string[128]
6/6
Path to store media.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0312a.
action_cf_media NULL, 0~4,101 6/6 Index of the attached media.
101 means “Recording Notify”
* Only available when
"capability_supportsd" > 0
action_cf_datefolder
<Not support anymore>
<boolean>
6/6
Enable this to create folders by date,
time, and hour automatically.
* Only available when
"capability_supportsd" > 0
action_cf_backup <Boolean> 6/6 Enable or disable the function that send
media to SD card for backup if network is
disconnected.
* Only available when
"capability_supportsd" > 0
action_server_i<0~4>_en
able
<boolean>
6/6
Enable or disable this server action.
action_server_i<0~4>_m
edia
NULL, 0~4,101 6/6 Index of the attached media.
101 means "Recording Notify"
action_server_i<0~4>_da
tefolder
<Not support anymore>
<boolean>
6/6
Enable this to create folders by date,
time, and hour automatically.
action_goto_enable
<product dependent>
<boolean> 6/6 Enable/disable ptz goto preset position
on event triggered.
* Only available when
"capability_ptzenabled" > 0.
action_goto_name
<product dependent>
string[40]
6/6
Specify the preset name that ptz goto on
event triggered.
* Only available when
"capability_ptzenabled" > 0.
VIVOTEK
User's Manual - 371
© 2022 VIVOTEK INC. All Right Reserved
219
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
action_goto_sync
<product dependent>
<boolean>
6/6
Capture media after moving to the
location.
* Only avaliable when the bit4 of
capability_ptzenabled is 1 and the bit7 of
capability_ptzenabled is 0, or
capability_camctrl_c0_zoommodule > 0
action_autotrack_enable
<product dependent>
<boolean> 6/6 Enable/disable auto tracking when an
event is triggerd.
* Only avaliable when the bit4 of
capability_ptzenabled is 1 and the bit7 of
capability_ptzenabled is 0
action_autotrack_name
<product dependent>
string[40]
6/6
Indicate the source name of smart
tracking advanced when an event is
triggered.
* Only avaliable when the bit4 of
capability_ptzenabled is 1 and the bit7 of
capability_ptzenabled is 0, and the
camera supports “Smart Tracking
Advanced” feature. (Please refer to PTZ
Control API for more details)
* We support this parameter when the
version number (httpversion) is equal or
greater than 0317d.
action_tour_enable
<product dependent>
<boolean> 6/6 Enable/disable auto tour function when
an event is triggered.
* Only avaliable when the bit4 of
capability_ptzenabled is 1 and the bit7 of
capability_ptzenabled is 0
action_tour_name
<product dependent>
string[40]
6/6
Indicate the source name of auto tour
when an event is triggered.
* Only avaliable when the bit4 of
capability_ptzenabled is 1 and the bit7 of
capability_ptzenabled is 0
VIVOTEK
372 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
220
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
action_audioclip_enable
<boolean>
6/6
Enable/disable the function the play an
audio clip when an event is triggered.
* Only avaliable when
"capability_audio_audioclip" is 1.
action_audioclip_media 0,<positive
integer>
6/6 Indicate the source id of audioclip event
notification.
* Only avaliable when
"capability_audio_audioclip" is 1.
tampering
0,<positive
integer>
6/6
Indicate the source channel id of
tampering detection.
A 4-bit integer, each bit represents each
channel.
bit 0 => tampering detection for first
channel.
bit 1
=> tampering detection for second
channel.
bit 2 => tampering detection for third
channel.
bit 3 => tampering detection for fourth
channel.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0311c.
action_cameralink_id <string> 6/6 Refer to the receiver camera id when an
event is triggered.
ex. cameralink_i0 refers to the
information in cameralink_i0 group.
* Only available when
"capability_cameralink_support" is 1.
7.29 Server Setting for Event Action
Group: server_i<0~4>
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
name
string[40]
6/6
Identification of this entry
VIVOTEK
User's Manual - 373
© 2022 VIVOTEK INC. All Right Reserved
221
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
type
email,
ftp,
http,
ns,
sftp
6/6
Indicate the server type:
“email” = email server
“ftp” = FTP server
“http” = HTTP server
“ns” = network storage
“sftp” = secure FTP
* “sftp” is only available when bit 1 of
“capability_protocol_ftp_client” is 1.
http_url string[128] 6/6 URL of the HTTP server to upload.
http_username string[64] 6/6 Username to log in to the server.
http_passwd string[64] 7/6 Password of the us er.
ftp_address string[128] 6/6 FTP server address.
ftp_username string[64] 6/6 Username to log in to the server.
ftp_passwd string[64] 7/6 Password of the user.
ftp_port 0~65535 6/6 Port to connect to the server.
ftp_location
string[128]
6/6
Location to upload or store the media.
ftp_passive <boolean> 6/6 Enable or disable passive mode.
0 = disable passive mode
1 = enable passive mode
email_address string[128] 6/6 Email server address.
email_sslmode <boolean> 6/6 Enable support SSL.
email_port 0~65535 6/6 Port to connect to the server.
email_username string[64] 6/6 Username to log in to the server.
email_passwd string[64] 7/6 Password of the user.
email_senderemail string[128] 6/6 Email address of the sender.
email_recipientemail string[640] 6/6 Email address of the recipient.
VIVOTEK
374 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
222
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
ns_location
string[128]
6/6
Location to upload or store the media.
* For httpversion is equal or greater than
0312a:
The media storage path format is “\<mac
address>\date\hour”.
(Only available when
“nas” is included in
“capability_storage_management_device”)
* For httpversion smaller than 0312a:
The media storage format is “\date\hour”.
* Note: “\date\hour” format is
“\YYYYMMDD\hh”.
ns_username string[64] 6/6 Username to log in to the server.
ns_passwd string[64] 7/6 Password of the user.
ns_workgroup string[64] 6/6 Workgroup for network storage.
7.29.1. Server Setting for Event Action of sftp
Group: server_i<0~4>_sftp
* Only available when bit 1 of “capability_protocol_ftp_client” is 1.
PARAMETER
VALUE
SECURITY
(get/set)
DESCRIPTION
address string[128] 6/6 Server address
loginmode
passwd,
publickey
6/6
authentication method:
”passwd” = password authentication.
You have to setup sftp_passwd for this
login mode to work.
”publickey” = Public key authentication
is more secure than password
authentication.
Please see sftpclient.cgi for more detail
settings.
username string[64] 6/6 Username
passwd
string[64]
7/6
User password
port 0~65535 6/6 Server port
location
string[128]
6/6
Login path on server
VIVOTEK
User's Manual - 375
© 2022 VIVOTEK INC. All Right Reserved
223
fingerprint_enable boolean 6/6 Verify server fingerprint to avoid
connect to fake server.
fingerprint_content
<128-bit hash
value>
6/6
Server fingerprint(MD5).
You can get it by calculate server host
key(public) md5.
publickey_pairmode auto,
download,
upload
6/6 "autopair": Autopair mode is selected
for this event server.
"downloadkey": Download key pair
mode is selected for this event server.
"uploadkey": Upload key pair mode is
selected for this event server.
publickey_downloadkeytype
ed25519,
rsa,
ecdsa
6/6
The keytype used for key pair.
"ed25519": faster to generate with
higher security level, some old server
might not support.
"rsa": slower to generate with slightly
lower security level than ed25519.
"ecdsa": low security level.
publickey_passphrase_enable boolean 6/6 The private key file be encrypted or
not.
publickey_passphrase_content
string[128]
7/6
The encryption passphrase.
7.30 Media Setting for Event Action
Group: media_i<0~(n-1)> n denotes the value of "capability_media_num"
(capability_media_num > 0)
PARAMETER
VALUE
SECURITY
(get/set)
DESCRIPTION
Name string[40] 6/6 Identification of this entry
Type snapshot,
systemlog,
videoclip,
recordmsg
6/6 Media type to send to the server
or store on the server.
VIVOTEK
376 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
224
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
snapshot_channel
0~"capability_nvideoin"-1
6/6
Indicate the source of media
channel.
0 means the first channel.
1 means the second channel.
2 means the third channel.
3 means the fourth channel.
* We support this parameter
when the version number
(httpversion) is equal or greater
than 0311c.
snapshot_source 0~"capability_nmediastream
"-1
6/6 Indicate the source of media
stream.
0 means the first stream.
1 means the second stream and
etc.
2 means the third stream and etc.
3 means the fourth stream and
etc.
snapshot_prefix
string[16]
6/6
Indicate the prefix of the
filename.
media_i0=> Snapshot1_
media_i1=> Snapshot2_
media_i2=> Snapshot3_
media_i3=> Snapshot4_
media_i4=> Snapshot5_
snapshot_datesuffix 0, 1 6/6 Add date and time suffix to
filename:
1 = Add date and time suffix.
0 = Do not add.
snapshot_preevent
0~"
capability_media_snapshot_
maxpreevent"
6/6
Indicates the number of pre-event
images.
snapshot_postevent 0~"
capability_media_snapshot_
maxpostevent"
6/6 Indicates the number of
post-event images.
VIVOTEK
User's Manual - 377
© 2022 VIVOTEK INC. All Right Reserved
225
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
videoclip_channel
0~"capability_nvideoin"-1
6/6
Indicate the source of media
channel.
0 means the first channel.
1 means the second channel.
2 means the third channel.
3 means the fourth channel.
* We support this parameter
when the version number
(httpversion) is equal or greater
than 0311c.
videoclip_source 0~"capability_nmediastream
"-1
6/6 Indicate the source of media
stream.
0 means the first stream.
1 means the second stream and
etc.
2 means the third stream and etc.
3 means the fourth stream and
etc.
videoclip_prefix
string[16]
6/6
Indicate the prefix of the
filename.
videoclip_preevent 0 ~ "
capability_media_videoclip_
maxpreevent"
6/6 Indicates the time for pre-event
recording in seconds.
videoclip_maxduration
1 ~ "
capability_media_videoclip_
maxlength"
6/6
Maximum duration of one video
clip in seconds.
videoclip_maxsize 50 ~ "
capability_media_videoclip_
maxsize"
6/6 Maximum size of one video clip
file in Kbytes.
videoclip_profiletoken
string[64]
6/6
Indicate the source for media
profile.
* We support this parameter
when the version number
(httpversion) is equal or greater
than 0314b.
VIVOTEK
378 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
226
7.31 Recording
Group: recording_i<0~(n-1)> n denotes the value of "capability_nrecording"
(capability_nrecording > 0)
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
name
string[40]
6/6
Identification of this entry.
trigger schedule,
networkfail
6/6 The event trigger type
schedule: The event is triggered by
schedule
networkfail: The event is triggered by
the failure of network connection.
enable <boolean> 6/6 Enable or disable this recording.
priority 0, 1, 2 6/6 Indicate the priority of this recording:
“0” indicates low priority.
“1” indicates normal priority.
“2” indicates high priority.
channel 0~"capability_nvideoin"-1 6/6 Indicate the source of recording
channel.
0 means the first channel.
1 means the second channel.
2 means the third channel.
3 means the fourth channel.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0311c.
source 0~"capability_nmediastrea
m"-1
6/6 Indicate the source of media stream.
0 means the first stream.
1 means the second stream and so on.
VIVOTEK
User's Manual - 379
© 2022 VIVOTEK INC. All Right Reserved
227
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
maxretentiontime
<string>
6/6
To specify the expired time for
automatic clean up, and it only takes
effect for video clip generated by
recording_i <0~1>.
Format is
“‘P[Y]Y[MM]M[DDD]DT[hh]H[mm]M[ss]
S’
, similar with ISO8601 with symbols P
Ex. P7D, it means 7 days. P1DT10H, it
means 1 days and 10 hours.
The parameter takes effect when
autocleanup_
maxretentiontime_recording_enabled
is enabled.
notify <boolean> 6/6 0: Disable recording notification
1: Enable recording notification
notifyserver
0~31
6/6
Indicate which notification server is
scheduled.
One bit represents one application
server (server_i0~i4).
bit0 (LSB) = server_i0.
bit1 = server_i1.
bit2 = server_i2.
bit3 = server_i3.
bit4 = server_i4.
For example, enable server_i0,
server_i2, and server_i4 as notification
servers; the notifyserver value is 21.
Loading page 380...
VIVOTEK
User's Manual - 381
© 2022 VIVOTEK INC. All Right Reserved
229
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
adaptive_enable
<boolean>
6/6
Indicate whether the adaptive
recording is enabled
adaptive_preevent
0~9 6/6 Indicate when is the adaptive recording
started before the event trigger point
(seconds)
adaptive_postevent
0~10
6/6
Indicate when is the adaptive recording
stopped after the event trigger point
(seconds)
recordingjob_Sourc
eToken_Token
string[64] 6/6 Indicate the source for media profile.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0314b.
7.32 HTTPS
Group: https (capability_protocol_https > 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
6/6
To enable or disable secure HTTP.
policy <Boolean> 6/6 If the value is 1, it will force HTTP
connection redirect to HTTPS
connection
method auto,
manual,
install
6/6 auto =>Create self-signed certificate
automatically.
manual =>Create self-signed certificate
manually.
install =>Create certificate request and
install.
status -3 ~ 1 6/6 Specify the https status.
-3= Certificate not installed
-2 = Invalid public key
-1 = Waiting for certificate
0= Not installed
1 = Active
countryname string[2] 6/6 Country name in the certificate
information.
VIVOTEK
382 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
230
NAME VALUE SECURITY
(get/set)
DESCRIPTION
stateorprovincen
ame
string[128]
6/6
State or province name in the
certificate information.
localityname string[128] 6/6 The locality name in thecertificate
information.
organizationname
string[64]
VIVOTEK Inc.
6/6
Organization name in the certificate
information.
unit string[64]
VIVOTEK Inc.
6/6 Organizational unit name in
thecertificate information.
commonname
string[64]
www.vivotek.com
6/6
Common name in the certificate
information.
validdays 0 ~ 825 6/6 Valid period for the certification.
7.33 Storage Management Setting
Group: disk_i<0~(n-1)> n denotes the value of "capability_storage_management_ndevice"
(capability_storage_management_ndevice > 0)
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
cyclic_enabled <boolean> 6/6 Enable cyclic storage method.
cyclic_reserve 10 ~ 99 6/6 The reserved percentage of this disk.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0312a.
type sd, nas
<product
dependent>
6/7 The storage device type.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0312a.
VIVOTEK
User's Manual - 383
© 2022 VIVOTEK INC. All Right Reserved
231
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
autocleanup_mode
targetbase,
sourcebase
6/6
Specify the automatic clean up method
for storage devices, where “targetbase”
indicate the automatic clean up is based
on the attached devices such as nas or sd
card, whereas “sourcebase” indicate
automatic clean up is based on the
selected recording track.
* We support this parameter when the
version number (httpversion) is equal or
greater than 0312a.
autocleanup_enabled
<Not recommended to
use this>
<boolean> 6/6 Enable automatic clean up method.
Expired and not locked media files will be
deleted.
* For forward compatibility reservations,
but only group disk_i0_autocleanup is
effective.
* Not recommended to use this. Please
refers "autocleanup" group.
* This parameter will not be used after
the version number (httpversion) is equal
or greater than 0400a.
autocleanup_maxage
<Not recommended to
use this>
<positive integer>
6/6
To specify the expired days for automatic
clean up.
* For forward compatibility reservations,
but only group disk_i0_autocleanup is
effective.
* Not recommended to use this. Please
refers "autocleanup" group.
* This parameter will not be used after
the version number (httpversion) is equal
or greater than 0400a.
VIVOTEK
384 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
232
7.34 Region of Interest
Group: roi_c<0~(n-1)> for n channel product and m is the index of video stream which support ePTZ.
(capability_eptz > 0)
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
s<0~(m-1)>_home
<W,H>
<product
dependent>
1/6
ROI left-top corner coordinate.
* If the minimal window size is 64x64,
then the "home"=(0~resolution_W-64,
0~resolution_H-64), which the resolution
is equal to the captured size by device in
this video mode.
* If the stream doesn’t support ePTZ, the
permissions of this parameter must be
set as 1/7.
s<0~(m-1)>_size <WxH>
<product
dependent>
1/6 ROI width and height. The width value
must be multiples of 16 and the height
value must be multiples of 8
*If the minimal window size is 64x64,
then the "size"=(64~resolution_W,
64~resolution_H), which the resolution is
equal to the captured size by device in
this video mode.
* If the stream doesn’t support ePTZ, the
permissions of this parameter must be
set as 1/7.
7.35 ePTZ Setting
Group: eptz_c<0~(n-1)> for n channel product. (capability_eptz > 0)
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
VIVOTEK
User's Manual - 385
© 2022 VIVOTEK INC. All Right Reserved
233
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
osdzoom
<Not recommended to
use this>
<boolean>
1/4
Indicates multiple of zoom in is
“on-screen display” or not.
* Reserved for compatibility, and suggest
don't use this since [httpversion] > 0302a
* We replace
"eptz_c<0~(n-1)>_osdzoom" with "
videoin_c<0~(n-1)>_zoomratiodisplay".
smooth <boolean> 1/4 Enable the ePTZ "move smoothly"
feature
tiltspeed
-5 ~ 5
1/7
Tilt speed
(It should be set by eCamCtrl.cgi rather
than by setparam.cgi.)
panspeed -5 ~ 5 1/7 Pan speed
(It should be set by eCamCtrl.cgi rather
than by setparam.cgi.)
zoomspeed
-5 ~ 5
1/7
Zoom speed
(It should be set by eCamCtrl.cgi rather
than by setparam.cgi.)
autospeed 1 ~ 5 1/7 Auto pan/patrol speed
(It should be set by eCamCtrl.cgi rather
than by setparam.cgi.)
7.35.1. ePTZ Settings for Each Stream
Group: eptz_c<0~(n-1)>_s<0~(m-1)> for n channel product and m is the index of video stream.
(capability_eptz > 0)
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
patrolseq
string[120]
1/4
The patrol sequence of ePTZ. All the
patrol position indexes will be separated
by ","
Loading page 386...
Loading page 387...
VIVOTEK
388 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
236
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
maxconnection
3
1/7
Maximum number of connected seamless
streaming.
* We replace this parameter with
“seamlessrecording_c<0~(n-1)>_maxconnecti
on” when the version number (httpversion) is
equal or greater than 0312a.
* We do not support this parameter when
"capability_nvideoin > 1".
* This parameter will not be used after the
version number (httpversion) is equal or
greater than 0400a.
enable
<boolean> 1/7 Indicate whether seamless recording is
recording to local storage or not at present.
(Read only)
* We replace this parameter with
“seamlessrecording_c<0~(n-1)>_triggerrecord
” when the version number (httpversion) is
equal or greater than 0312a.
* We do not support this parameter when
"capability_nvideoin > 1".
* This parameter will not be used after the
version number (httpversion) is equal or
greater than 0400a.
guid<0~2>_id
string[127]
1/7
The connected seamless streaming ID.
(Read only)
* We replace this parameter with
“seamlessrecording_c<0~(n-1)>_guid<0~2>_i
d” when the version number (httpversion) is
equal or greater than 0312a.
* We do not support this parameter when
"capability_nvideoin > 1".
* This parameter will not be used after the
version number (httpversion) is equal or
greater than 0400a.
Loading page 389...
VIVOTEK
390 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
238
triggerrecord <boolean> 1/7 Indicate whether seamless recording is
recording to local storage or not at
present.
(Read only)
* We support this parameter when the
version number (httpversion
) is equal or
greater than 0312a.
guid<0~(k-1)>_id
string[127]
1/7
The connected seamless streaming ID.
(Read only)
* k denotes the value of
"seamlessrecording_c<0~(n-1)>_maxco
nnection"
* We support this parameter when the
version number (
httpversion) is equal or
greater than 0312a.
guid<0~(k-1)>_number 0~3 1/7 Number of connected seamless
streaming with guid<0~(k-1)>_id.
(Read only)
* k denotes the value of
"seamlessrecording_c<0~(n-1)>_maxco
nnection"
* We support this parameter when the
version number (httpversion) is equal or
greater than 0312a.
7.38 VIVOTEK Application Development Platform Setting
Group: vadp
NAME VALUE SECURITY
(get/set)
DESCRIPTION
version
<string>
6/7
Indicate the VADP version.
resource_total_memory 0,<positive
integer>
6/7 Indicate total available memory size
for VADP modules.
resource_total_storage
0,<positive
integer>
6/7
Indicate total size of the internal
storage space for storing VADP
modules.
resource_free_memory 0,<positive
integer>
6/7 Indicate free memory size for VADP
modules.
VIVOTEK
User's Manual - 391
© 2022 VIVOTEK INC. All Right Reserved
239
NAME VALUE SECURITY
(get/set)
DESCRIPTION
resource_free_storage
0,<positive
integer>
6/7
Indicate current free storage size for
uploading VADP modules.
module_number 0,<positive
integer>
6/7 Record the total module number that
already stored in the system.
module_order
string[40]
6/6
The execution order of the enabled
modules.
module_save2sd <boolean> 6/6 Indicate if the module should be
saved to SD card when user want to
upload it.
If the value is false, save module to
the internal storage space and it will
occupy storage size.
* This feature is not supported when
"capability_securecam_support=1"
and the version number of
"capability_securecam_version" <
"1.0.1.0"
number
string[128]
6/7
This number is used to register
license key for VADP application.
status string[40] 6/7 Indicate the hardware restore status
developer_mode
<Boolean>
6/6
Developer mode provide ways to
establish communication between
the developer of VADP vendor and
your camera.
* Only available when
capability_securecam_support=1.
7.38.1. VADP Settings for Each Hyperlink
Group: vadp_hyperlink_i<0~(n-1)>
Maximum of n=10 hyperlink is supported.
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
moduleidx 0,<positive
integer>
1/7 Refer to the package index.
title
string[40]
1/7
Name of the vadp hyperlink.
VIVOTEK
392 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
240
NAME VALUE SECURITY
(get/set)
DESCRIPTION
url
string[120]
1/7
The URL address of vadp hyperlink.
status string[40] 1/7 Value of “on” indicates a valid
connection of vadp hyperlink.
Value of “off” indicates a invalid
connection of vadp hyperlink.
7.38.2. VADP Settings for Each Package
Group: vadp_module_i<0~(n-1)> for n VADP package number (capability_vadp_npackage > 0)
n denotes the value of "capability_vadp_npackage".
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
6/6
Indicate if the module is enabled or
not.
If yes, also add the index of this module
to the module_order.
name string[40] 6/6 Module name
extendedname
string[40]
6/6
Extended module name. If this value is
not blank, it will be shown on the VADP
UI first instead of
vadp_module_i<n>_name.
url string[120] 6/6 Define the URL string after the IP
address if the module provides it own
web page.
vendor
string[40]
6/6
The provider of the module.
vendorurl string[120] 6/6 URL of the vendor.
version
string[40]
6/6
Version of the module.
license string[40] 6/6 Indicate the license status of the
module.
licmsg
string[128]
6/6
Indicate the message that will be show
on license status when mouse over.
path string[40] 6/7 Record the storage path of the module.
initscr
string[40]
6/7
The script that will handle operation
commands from the system.
status string[40] 6/6 Indicate the running status of the
module.
VIVOTEK
User's Manual - 393
© 2022 VIVOTEK INC. All Right Reserved
241
NAME VALUE SECURITY
(get/set)
DESCRIPTION
statmsg
string[128]
6/6
Indicate the message that will be show
on the running status when mouse
ove r.
vvtklicensemec string[40] 6/7 Indicate the module use VIVOTEK
license mechanism
7.38.3. VADP Schedule Settings
Group: vadp_schedule_i<0~(n-1)> for n VADP package number
n denotes the value of "capability_vadp_npackage".
(Only available when "capability_vadp_npackage" > 0 and the version number of "vadp_version" >=
"1.3.2.0")
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
enable
<boolean>
6/6
Enable or disable the schedule mode to
control the execution of the VADP
package
begintime
hh:mm
6/6
Begin time of the schedule
endtime
hh:mm
6/6
End time of the schedule
7.38.4. VADP Event Settings
Group: vadp_event
NAME VALUE SECURITY
(get/set)
DESCRIPTION
ntrigger
0,<positive
integer>
6/7
Indicate the number of topics to be
transferred to event manager for
trigger.
triggerlist_i<0~(n-1)>_t
opic
string[256] 6/6 Indicate the event notification with this
topic will be transferred to event
manager as trigger.
n is equal to ntrigger above.
7.39 Camera PTZ Control
Group: camctrl
(capability_camctrl_ptztunnel > 0)
VIVOTEK
394 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
242
NAME VALUE SECURITY
(get/set)
DESCRIPTION
enableptztunnel
<boolean>
1/4
Enable PTZ tunnel for camera control.
Group: camctrl_c<0~(n-1)> for n channel products (capability_ptzenabled > 0)
n denotes the value of "capability_nvideoin" and k denotes the value of "capability_npreset"
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
panspeed -5 ~ 5 1/4 Pan speed
tiltspeed
-5 ~ 5
1/4
Tilt speed
zoomspeed -5 ~ 5 1/4 Zoom speed
focusspeed
-5 ~ 5
1/4
Auto focus speed
patrolseq string[120] 1/4 (For external device)
The indexes of patrol points, separated
by “,”
patroldwelling
string[160]
1/4
(For external device)
The dwelling time of each patrol point,
separated by “,”
* only available when
capability_camctrl_c0_rs485=2
preset_i<0~(k-1)>_nam
e
string[40] 1/4 Name of the preset location.
preset_i<0~(k-1)>_
dwelling
0 ~ 999
1/4
The dwelling time of each preset
location
* only available when
capability_camctrl_c0_rs485=2
uart 0 ~ "
capability_nuar
t"-1
1/4 Select corresponding uart
(capability_nuart>0).
* only available when
capability_camctrl_c0_rs485=2
cameraid
0~255
1/4
Camera ID controlling external PTZ
camera.
isptz 0 ~ 2 1/4 0: disable PTZ commands.
1: enable PTZ commands with PTZ
driver.
2: enable PTZ commands with UART
tunnel.
* only available when
Loading page 395...
VIVOTEK
396 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
244
NAME VALUE SECURITY
(get/set)
DESCRIPTION
listed in
"capability_cam
ctrl_c<0~(n-1)>
_focusmode"
uart 0 ~
"capability_nua
rt"-1
1/4 Select corresponding uart
(capability_nuart>0).
* only available when
capability_camctrl_c0_rs485=2
isptz
0 ~ 2
1/4
0: disable PTZ commands.
1: enable PTZ commands with PTZ
driver.
2: enable PTZ commands with UART
tunnel.
* only available when
capability_camctrl_c0_rs485=2
preset_i<0~(k-1)>_name string[40] 1/4 Name of the preset location.
preset_i<0~(k-1)>_zoom
capability_ptz_
c<0~(n-1)>_min
zoom ~
capability_ptz_
c<0~(n-1)>_ma
xzoom
1/4
Zoom position at each preset location.
preset_i<0~(k-1)>_focus capability_ptz_
c<0~(n-1)>_min
focus ~
capability_ptz_
c<0~(n-1)>_ma
xfocus
1/4 Focus position at each preset location.
preset_i<0~(k-1)>_
dwelling
0 ~ 999
1/4
The dwelling time of each preset
location
* only available when
capability_camctrl_c0_rs485=2
preset_i<0~(k-1)>_focus
setting
sync,
fixcurrent
1/4 The focus mode of each preset, which is
essential and should be grouped with
“preset_i<0~(k-1)>_name.”
* We support this parameter when the
Loading page 397...
Loading page 398...
Loading page 399...
Loading page 400...
VIVOTEK
User's Manual - 401
© 2022 VIVOTEK INC. All Right Reserved
249
NAME VALUE SECURITY
(get/set)
DESCRIPTION
tour_i<0~19>_speed
-5 ~ 5
1/4
Preset tour: pan and tilt speed
when moving between presets.
Recorded tour: unnecessary.
tour_i<0~19>_direction forward,backward,ra
ndom
1/4 User can choose which direction
the preset tour goes.
"forward": preset tour goes in
forward order.
"backward": preset tour goes in
backward order.
"random": the presets of the tour
will be recalled randomly.
* Only available when
"capability_presettourdirection"
is 1.
* We support this parameter
when the version number
(httpversion) is equal or greater
than 0307a.
tour_i<0~19>_checklist
string[512]
1/4
The indexes of preset positions,
separated by “,”
tour_i<0~19>_dwelltim
e
string[512] 1/4 Preset tour: time to wait before
moving to the next preset
position, separated by “,”
Recorded tour: number of
seconds to wait
before continuing a loop tour.
tour_i<0~19>_enabletra
ck
<boolean>
1/4
Whether the "preset tour" enters
the tracking mode during the
dwell time
* We support this parameter
when the version number
(httpversion) is equal or greater
than 0317a.
PLEASE REFER TO PTZ CONTROL API
VIVOTEK
402 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
250
7.42 UART Control
Group: uart (capability_nuart > 0 and capability_fisheye = 0)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
ptzdrivers_i<0~19,
127>_name
string[40]
1/4
Name of the PTZ driver.
ptzdrivers_i<0~19,
127>_location
string[128] 1/4 Full path of the PTZ driver.
enablehttptunnel
<boolean>
1/4
Enable HTTP tunnel channel to control
UA RT.
Group: uart_i<0~(n-1)> n is uart port count (capability_nuart > 0 and capability_fisheye = 0)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
baudrate 300,600,1200,2400,
4800,9600,19200,38
400,57600,115200
4/4 Set baud rate of COM port.
databit
5,6,7,8
4/4
Data bits in a character frame.
paritybit none,
odd,
even
4/4 For error checking.
stopbit 1,2 4/4 "1": One stop bit is transmitted to
indicate the end of a byte.
"2": Two stop bits are transmitted to
indicate the end of a byte.
If you want to transfer the stopbit for
150% of the normal time used to
transfer one bit, the
uart_i<0~(n-1)>_stopbit should be set
as 2 and the uart_i<0~(n-1)>_databit
set as 5 as well.
uartmode rs485,
rs232
4/4 RS485 or RS232.
customdrvcmd_i<0~
9>
string[128] 1/4 PTZ command for custom camera.
* only available when
capability_camctrl_c0_rs485=2
VIVOTEK
User's Manual - 403
© 2022 VIVOTEK INC. All Right Reserved
251
NAME VALUE SECURITY
(get/set)
DESCRIPTION
speedlink_i<0~4>_n
ame
string[40]
1/4
Additional PTZ command name.
* only available when
capability_camctrl_c0_rs485=2
speedlink_i<0~4>_c
md
string[40] 1/4 Additional PTZ command list.
* only available when
capability_camctrl_c0_rs485=2
ptzdriver
0~19,
127 (custom),
128 (no driver)
1/4
The PTZ driver is used by this COM
port.
* only available when
capability_camctrl_c0_rs485=2
7.43 UART Control (SD Series)
Group: uart_i<0~(n-1)> n is uart port count (capability_nuart > 0 and the bit7 of
capability_ptzenabled is 0, the bit4 of capability_ptzenabled is 1)
NAME
VALUE
SECURITY
(get/set)
DESCRIPTION
cameraid 1~255 4/4 Camera ID controlling external PTZ
camera.
Note:
Please set your speed dome to the
appropriate baud rate, and Camera ID,
e.g. 2400bps, camera ID 1,2,3,,,,etc.
All Camera IDs on the same controlling
system (NVR or rs485 keyboard) have to
be distinct.
Therefore, once you send a controlling
signal, each camera will only accept the
inputs with the corresponding ID.
baudrate
2400,4800,9600,19
200,38400,57600,1
15200
4/4
Set baud rate of COM port.
databit 5,6,7,8 4/4 Data bits in a character frame.
paritybit none,
odd,
even
4/4 For error checking.
VIVOTEK
404 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
252
NAME VALUE SECURITY
(get/set)
DESCRIPTION
stopbit
1,2
4/4
"1": One stop bit is transmitted to
indicate the end of a byte.
"2": Two stop bits are transmitted to
indicate the end of a byte.
If you want to transfer the stopbit for
150% of the normal time used to
transfer one bit, the
uart_i<0~(n-1)>_stopbit should be set
as 2 and the uart_i<0~(n-1)>_databit
set as 5 as well.
uartmode rs485 4/7 RS485 mode.
7.44 UART Control (SC Series)
Group: uart_i<0~(n-1)> n is uart port count (capability_nuart > 0 and capability_ibis = 1)
NAME VALUE SECURITY
(get/set)
DESCRIPTION
baudrate 1200,2400,4800,960
0,19200,38400
4/4 Set baud rate of COM port.
databit 5,6,7,8 4/4 Data bits in a character frame.
paritybit none,
odd,
even
4/4 For error checking.
stopbit 1,2 4/4
"1"
: One stop bit is transmitted to
indicate the end of a byte.
"2": Two stop bits are transmitted to
indicate the end of a byte.
If you want to transfer the stopbit for
150% of the normal time used to
transfer one bit, the
uart_i<0~(n-1)>_stopbit should be set
as 2 and the uart_i<0~(n-1)>_databit
set as 5 as well.
7.45 Lens Configuration
Loading page 405...
VIVOTEK
406 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
254
NAME VALUE SECURITY
(get/set)
DESCRIPTION
revisedcenteraxis
<coordinate>
1/7
The actual center axis coordinate
radius 0, <positive
integer>
1/7 The actual center radius
7.47 Fisheye Local Dewarp Setting
Group: fisheyedewarp_c<0~(n-1)> (capability_fisheyelocaldewarp_c<0~(n-1)> > 0)
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nmediastream"
NAME VALUE SECURITY
(get/set)
DESCRIPTION
panspeed
-5 ~ 5
1/4
Pan speed of regional view
tiltspeed -5 ~ 5 1/4 Tilt speed of regional view
zoomspeed
-5 ~ 5
1/4
Zoom speed of regional
s<0~(m-2)>_panora
ma_panstart
0~359 1/4 Initial pan position of panorama view.
(only available for 1P and 2P mode at
ceiling or floor mount)
s<0~(m-2)>_region_
pan
-90~359
1/4
Pan home angle of regional view (for
1R mode)
Pan range of ceiling/floor mount is
[0~359].
Pan range of wall mount is [-90~90].
s<0~(m-2)>_region_t
ilt
-90~90 1/4 Tilt home angle of regional view (for
1R mode)
Tilt range of ceiling/floor mount is
[0~90].
Tilt range of wall mount is [-90~90].
s<0~(m-2)>_region_
zoom
100~300
1/4
Zoom home ratio of regional view (for
1R mode)
s<0~(m-2)>_region_r
<0~(i-1)>_pan
-90~359 1/4 Pan home angle of regional view (for
4R mode, i is the view index and range
from 0 to 3)
Pan range of ceiling/floor mount is
[0~359].
Pan range of wall mount is [-90~90].
s<0~(m-2)>_region_r
<0~(i-1)>_tilt
-90~90
1/4
Tilt home angle of regional view (for
4R mode, i is the view index and range
Loading page 407...
VIVOTEK
408 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
256
7.50 Wireless
Group: wireless (capability_network_wireless > 0)
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
ssid
string[32]
6/6
SSID for wireless lan settings.
wlmode Infra,
Adhoc
6/6 Wireless mode.
Infra: Infrastructure
channel 1~11 or
1~13 or
10~11 or
10~13 or
1~14
6/6 A list of WLAN channels.
Countries apply their own regulations
to the allowable channels.
1~11: USA and Canada
1~13: Europe
10~11: Spain
10~13: France
1~14: Japan
* Only valid when "wireless_wlmode"
is "Adhoc"
encrypt none,
wep,
wpa,
wpa2
6/6 Encryption method:
none: NONE,
wep: WEP,
wpa: WPA,
wpa2: WPA2PSK
authmode OPEN, SHARED 6/6 Authentication mode.
* Only
valid when "wireless_encrypt" is
"wep"
keylength 64, 128 6/6 Key length in bits.
* Only valid when "wireless_encrypt" is
"wep"
keyformat HEX, ASCII 6/6 Key1 ~ key4 presentation format.
* Only valid when "wireless_encrypt" is
"wep"
keyselect 1 ~ 4 6/6 Default key number.
* Only valid when "wireless_encrypt" is
"wep"
key1 password [26] 6/6 WEP key1 for encryption.
* Only valid when "wireless_encrypt" is
"wep"
Loading page 409...
VIVOTEK
410 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
258
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
fixed
<boolean>
1/7
The value indicates whether the profile
can be deleted or not.
Ex. fixed=1 indicates the profile cannot
be deleted.
occupied <boolean> 1/6 Indicates the action of creating profile.
Ex. If occupied=1 indicates the current
profile is to be created; otherwise, if
occupied=0 indicates the current
profile is to be deleted.
alwaysmulticast
<boolean>
1/6
Enable always multicast.
videoconfiguration_en
able
<boolean> 1/6 To enable the selected
videoconfiguration source for this
profile.
videoconfiguration_so
urce
c<0~(n-1)>s<0~(m-1)
>
* n denotes the value
of
“capability_nvideoin,
and m denotes the
value of
“capability_nmediastr
eam”
1/6 The videoconfiguration source for the
profile.
Ex. videoconfiguration_source=
c<0~(n-1)>s<0~(m-1)> indicates video
stream of channel n stream m is
selected for the profile.
audioconfiguration_en
able
<boolean> 1/6 To enable the selected
audioconfiguration source for this
profile.
* Only available when
capability_naudioin > 0
VIVOTEK
User's Manual - 411
© 2022 VIVOTEK INC. All Right Reserved
259
PARAMETER VALUE SECURITY
(get/set)
DESCRIPTION
audioconfiguration_so
urce
c<0~(n-1)>s0
* n denotes the value
of
"capability_naudioin"
1/6
The audioconfiguration source for the
profile.
Ex. audioconfiguration_source=
c<0~(n-1)>s0 indicates audio stream of
channel n and stream 1 is selected for
the profile.
* Only available when
capability_naudioin > 0
metadataconfiguratio
n_enable
<boolean> 1/6 To enable the selected
metadataconfiguration source for the
profile.
metadataconfiguratio
n_source
c<0~(n-1)>s0
* n denotes the value
of
"capability_nvideoin"
1/6
The metadataconfiguration source for
the profile
Ex. metadataconfiguration_source=
c<0~(n-1)>s0 indicates metadata
stream of channel n and stream 1 is
selected for the profile.
7.53 Multicast Settings for Metadata Streaming
Group: metadata_c<0~(n-1)>_s0_multicast (capability_media_streamprofiles_support = 1)
n denotes the value of "capability_nvideoin"
NAME
VALUE
SECURITY(
get/set)
DESCRIPTION
ipaddress <ip address> 4/4 Multicast metadata IP address.
port
1025 ~ 65535
4/4
Multicast metadata port.
ipversion IPv4, IPv6 4/4 The version of internet protocol.
ttl
1 ~ 255
4/4
Multicast metadata time to live value.
7.54 Camera Link Settings
Group: cameralink_i<0~(n-1)> (capability_cameralink_support = 1)
n denotes the value of "capability_cameralink_num"
Loading page 412...
Loading page 413...
Loading page 414...
VIVOTEK
User's Manual - 415
© 2022 VIVOTEK INC. All Right Reserved
263
8. Useful Functions
8.1 Drive the Digital Output (capability_ndo > 0)
Note: This request requires Viewer privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/dido/setdo.cgi?do0=<value> [&do1=<value>]
[&do2=<value>][&do3=<value>]
Where state is 0 or 1; “0” means inactive or normal state, while “1” means active or triggered state,
and trigger time is indicated in seconds.
PARAMETER VALUE DESCRIPTION
do<num>
state[trigger time]
Where "state" is 0, 1.
“0” means inactive or
normal state while
“1” means active or
triggered state.
Where "trigger time"
is reset time after
state change.
Ex: do0=1
Setting digital output #1 to trigger state.
Ex: do0=0[30]
Setting digital output #1 to normal state, waiting 30
seconds, setting it to trigger state.
Example: Drive the digital output #1 to triggered state, reset do0 after 20 seconds and redirect to
an empty page.
http://myserver/cgi-bin/dido/setdo.cgi?do0=1[20]
8.2 Query Status of the Digital Input (capability_ndi > 0)
Note: This request requires Viewer privileges
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/dido/getdi.cgi?[di0][&di1][&di2][&di3]
If no parameter is specified, all of the digital input statuses will be returned.
VIVOTEK
416 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
264
Return:
HTTP/1.0 200 OK\r\n
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
where <state> can be 0 or 1.
Example: Query the status of digital input #1 .
Request:
http://myserver/cgi-bin/dido/getdi.cgi?di0
Response:
HTTP/1.0 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: 7\r\n
\r\n
di0=1\r\n
8.3 Query Status of the Digital Output (capability_ndo > 0)
Note: This request requires Viewer privileges
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/dido/getdo.cgi?[do0][&do1][&do2][&do3]
If no parameter is specified, all the digital output statuses will be returned.
Return:
HTTP/1.0 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: <length>\r\n
\r\n
[do0=<state>]\r\n
VIVOTEK
User's Manual - 417
© 2022 VIVOTEK INC. All Right Reserved
265
[do1=<state>]\r\n
[do2=<state>]\r\n
[do3=<state>]\r\n
where <state> can be 0 or 1.
Example: Query the status of digital output #1.
Request:
http://myserver/cgi-bin/dido/getdo.cgi?do0
Response:
HTTP/1.0 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: 7\r\n
\r\n
do0=1\r\n
8.4 Capture Single Snapshot
Note: This request requires Normal User privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/viewer/video.jpg?[channel=<value>][&resolution=<value>]
[&quality=<value>][&streamid=<value>]
If the request contains invalid parameters, a full FOV snapshot will return.
PARAMETER VALUE DESCRIPTION
channel
0~(capability_nvideoin -1)
The channel number of the video
source.
Default: 0
resolution Available options are list in
"capability_videoin_c<0~(n-1)>_resolution".
Besides, available options is referred to
"capability_videoin_c<0~(n-1)>_maxresolution
" and
"capability_videoin_c<0~(n-1)>_minresolution"
The resolution of the image.
Default: Returns snapshot of current
resolution by [channel] and
[streamid].
VIVOTEK
418 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
266
PARAMETER VALUE DESCRIPTION
quality
1~5
The quality of the image.
streamid 0~( capability_nmediastream -1) The stream number.
Default: Returns snapshot of
maxmum resolution for current
channel.
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:
HTTP/1.0 200 OK\r\n
Content-Type: image/jpeg\r\n
[Content-Length: <image size>\r\n]
<binary JPEG image data>
8.5 Account Management
Note: This request requires Administrator privileges.
Method: POST
Syntax:
http://<servername>/cgi-bin/admin/editaccount.cgi?
method=<value>&username=<name>[&userpass=<value>][&privilege=<value>][&return=<return
page>]
PARAMETER VALUE DESCRIPTION
method
add
Add an account to the server. When using this method,
the“username” field is necessary. It will use the default
value of other fields if not specified.
delete Remove an account from the server. When using this
method, the “username” field is necessary, and others are
ignored.
edit
Modify the account password and privilege. When using
this method, the“username” field is necessary, and other
fields are optional. If not specified, it will keep the original
settings.
VIVOTEK
User's Manual - 419
© 2022 VIVOTEK INC. All Right Reserved
267
PARAMETER VALUE DESCRIPTION
username
<name>
The name of the user to add, delete, or edit.
userpass <value> The password of the new user to add or that of the old
user to modify. The default value is an empty string.
privilege view The privilege of the user to add or to modify.
“view”: Viewer privilege.
“operator”: Operator privilege.
“admin”
: Administrator privilege.
operator
admin
return <return page> Redirect to the page <return page> after the parameter is
assigned. The <return page> should be the relative path
according to the root of camera. If you omit this
parameter, it will redirect to an empty page.
* If the <return page> is invalid path, it will ignore this
parameter.
Note:
1. Rules of password settings is defined by layout_defaultpassword group.
Example:
Request:
http://myserver/cgi-bin/admin/editaccount.cgi?method=add&username=test&userpass=123&privi
lege=view
Response of success:
HTTP/1.1 200 OK\r\n
Content-Type: text/html\r\n
Content-Length: 2\r\n
\r\n
Response of failure:
HTTP/1.1 200 OK\r\n
Content-Type: text/html\r\n
Content-Length: <Error Message Length>\r\n
\r\n
<Error Message>
List of error message:
ERROR: Add user fail!
ERROR: Delete user fail!
ERROR: Update user's password fail!
VIVOTEK
420 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
268
ERROR: Update user's privilege fail!
8.6 Upgrade Firmware
Note: This request requires Administrator privileges.
Method: POST
Syntax:
http://<servername>/cgi-bin/admin/upgrade.cgi
Post data:
fimage=<file name>[&return=<return page>]\r\n
\r\n
<multipart encoded form data>
Server will accept the file named <file name> to upgradethe firmware and return with <return
page> if indicated.
VIVOTEK
User's Manual - 421
© 2022 VIVOTEK INC. All Right Reserved
269
8.7 ePTZ Camera Control (capability_eptz > 0 and
Capability_fisheye = 0)
Note: This request requires camctrl privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/camctrl/eCamCtrl.cgi?channel=<value>&stream=<value>
[&move=<value>] – Move home, up, down, left, right
[&auto=<value>] – Auto pan, patrol
[&zoom=<value>]
–Zoom in, out
[&zooming=<value>&zs=<value>] –Zoom without stopping, used for joystick
[&x=<value>&y=<value>&w=<value>&h=<value>&resolution=<value>] - Zoom in, out on a specific
area
[&vx=<value>&vy=<value>&vs=<value>] – Shift without stopping, used for joystick
[&x=<value>&y=<value>&videosize=<value>&resolution=<value>&stretch=<value>] –Click on
image
(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=640x480&resolution=640x480&stretch=0
In zoom operation, there are two ways to control it, scale zoom and area zoom.
1. [Scale zoom]: contains two control method, relative movement and continuous movement
a. relative movement -
If you trigger a relative movement, it will only zoom certain ratio and stop by itself.
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?stream=0&zoom=tele
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?stream=0&zoom=wide
The zoom ratio to move by relative movement is according to the setting of speedzoom [-5~5].
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?stream=0&speedzoom=5
VIVOTEK
422 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
270
b. continuous movement -
If you trigger a continuous movement, you have to handle the stop time by yourself.
A continuous movement is convenient to integrate a joystick control.
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?stream=0&zooming=tele&zs=1
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?stream=0&zooming=wide&zs=5
zooming is used to indicate the moving direction, and zs is used to indicate the speed.
To stop a continuous movement, you have to use the command as below:
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?stream=0&zoom=stop&zs=0
2. [Area zoom]: it means to zoom in on a specific area, here is an example for a directly moving
[x, y] is the desired coordinate, and it will be the center after movement
[w, h] is the scaled area size
[resolution] is the base range of this coordinate system
The example shows [w, h] = [864, 488], which means to zoom in to ratio x2.2 based on [1920x1080].
Pay attention to that [x, y, w, h] are essential parameters in an area zoom case, and the stream index
is counted from 0 as the first stream.
http://IPAddr/cgi-bin/camctrl/eCamCtrl.cgi?channel=0&stream=0&x=912&y=297&w=864&h=488&r
esolution=1920x1080
PARAMETER VALUE DESCRIPTION
channel
<0~(n-1)>
Channel of video source.
stream <0~(m-1)> Stream.
move
home
Move to home ROI.
up Move up.
down Move down.
left
Move left.
right Move right.
auto pan Auto pan.
patrol
Auto patrol.
stop Stop auto pan/patrol.
zoom wide Zoom larger view with current speed.
tele Zoom further with current speed.
zooming wide or tele
Zoom without stopping for larger view or further view with
zs speed, used for joystick control.
zs 0 ~ 6 Set the speed of zooming, “0” means stop.
x <integer> The desired coordinate, and it will be the center after
VIVOTEK
User's Manual - 423
© 2022 VIVOTEK INC. All Right Reserved
271
PARAMETER VALUE DESCRIPTION
y
<integer>
movement
w <integer> The scaled area size
h <integer>
resolution
<window size>
The resolution of streaming.
vx <integer> The direction of movement, used for joystick control.
vy <integer>
vs 0 ~ 7 Set the speed of movement, “0” means stop.
x <integer> x-coordinate clicked by user.
It will be the x-coordinate of center after movement.
y <integer> y-coordinate clicked by user.
It will be the y-coordinate of center after movement.
videosize <window size> The size of plug-in (ActiveX)window in web page
resolution <window size> The resolution of streaming.
stretch <boolean> 0 indicates that it uses
resolution
(streaming size) as the
range of the coordinate system.
1 indicates that it usesvideosize(plug-in size) as the range
of the coordinate system.
speedpan -5 ~ 5 Set the pan speed.
speedtilt -5 ~ 5 Set the tilt speed.
speedzoom -5 ~ 5 Set the zoom speed.
speedapp 1 ~ 5 Set the auto pan/patrol speed.
return <return page> Redirect to the page <return page> after the parameter is
assigned. The <return page> should be the relative path
according to the root of camera. If you omit this
parameter, it will redirect to an empty page.
* If the <return page> is invalid path, it will ignore this
parameter.
VIVOTEK
424 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
272
8.8 ePTZ Recall (capability_eptz > 0 and capability_fisheye = 0)
Note: This request requires camctrl privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/camctrl/eRecall.cgi?channel=<value>&stream=<value>&
recall=<value>[&return=<return page>]
PARAMETER VALUE DESCRIPTION
channel
<0~(n-1)>
Channel of the video source.
stream
<0~(m-1)>
Stream.
recall Text string less than
40 characters
One of the present positions to recall.
return
<return page>
Redirect to the page <return page> after the parameter is
assigned. The <return page> should be the relative path
according to the root of camera. If you omit this
parameter, it will redirect to an empty page.
* If the <return page> is invalid path, it will ignore this
parameter.
8.9 ePTZ Preset Locations (capability_eptz > 0 and
capability_fisheye = 0)
Note: This request requires Operator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/operator/ePreset.cgi?channel=<value>&stream=<value>
[&addpos=<value>][&delpos=<value>][&return=<return page>]
PARAMETER
VALUE
DESCRIPTION
channel <0~(n-1)> Channel of the video source.
stream
<0~(m-1)>
Stream.
VIVOTEK
User's Manual - 425
© 2022 VIVOTEK INC. All Right Reserved
273
PARAMETER VALUE DESCRIPTION
addpos
<Text string less than
40 characters>
Add one preset location to the preset list.
delpos <Text string less than
40 characters>
Delete preset location from the preset list.
return <return page> Redirect to the page <return page> after the parameter is
assigned. The <return page> should be the relative path
according to the root of camera. If you omit this
parameter, it will redirect to an empty page.
* If the <return page> is invalid path, it will ignore this
parameter.
8.10 IP Filtering for ONVIF
Syntax:<product dependent>
http://<servername>/cgi-bin/admin/ipfilter.cgi?type[=<value>]
http://<servername>/cgi-bin/admin/ipfilter.cgi?method=add<v4/v6>&ip=<ipaddress>[&index=<val
ue>][&return=<return page>]
http://<servername>/cgi-bin/admin/ipfilter.cgi?method=del<v4/v6>&index=<value>[&return=<retu
rn page>]
PARAMETER VALUE DESCRIPTION
type
NULL
Get IP filter type
allow, deny Set IP filter type
method
addv4
Add IPv4 address into access list.
addv6 Add IPv6 address into access list.
delv4 Delete IPv4 address from access list.
delv6 Delete IPv6 address from access list.
ip <IP address> Single address: <IP address>
Network address: <IP address / network mask>
Range address:<start IP address - end IP address>
index
<value>
The start position to add or to delete.
8.11 UART HTTP Tunnel Channel (capability_nuart > 0)
Note: This request requires Operator privileges.
Method: GET and POST
VIVOTEK
426 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
274
Syntax:
http://<servername>/cgi-bin/operator/uartchannel.cgi?[channel=<value>]
-------------------------------------------------------------------------
GET /cgi-bin/operator/uartchannel.cgi?[channel=<value>]
x-sessioncookie: string[22]
accept: application/x-vvtk-tunnelled
pragma: no-cache
cache-control: no-cache
-------------------------------------------------------------------------
POST /cgi-bin/operator/uartchannel.cgi
x-sessioncookie: string[22]
content-type: application/x-vvtk-tunnelled
pragma : no-cache
cache-control : no-cache
content-length: 32767
expires: Sun, 9 Jam 1972 00:00:00 GMT
User must use GET and POST to establish two channels for downstream and upstream. The
x-sessioncookie in GET and POST should be the same to be recognized as a pair for one session. The
contents of upstream should be base64 encoded to be able to pass through a proxy server.
This channel will help to transfer the raw data of UART over the network.
Please see UART tunnel spec for detail information
PARAMETER VALUE DESCRIPTION
channel
0 ~ (n-1)
The channel number of UART.
8.12 Event/Control HTTP Tunnel Channel
(capability_evctrlchannel > 0)
Note: This request requires
Administrator privileges.
Method: GET and POST
Syntax:
http://<servername>/cgi-bin/admin/ctrlevent.cgi
VIVOTEK
User's Manual - 427
© 2022 VIVOTEK INC. All Right Reserved
275
-------------------------------------------------------------------------
GET /cgi-bin/admin/ctrlevent.cgi
x-sessioncookie: string[22]
accept: application/x-vvtk-tunnelled
pragma: no-cache
cache-control: no-cache
-------------------------------------------------------------------------
POST /cgi-bin/admin/ ctrlevent.cgi
x-sessioncookie: string[22]
content-type: application/x-vvtk-tunnelled
pragma : no-cache
cache-control : no-cache
content-length: 32767
expires: Sun, 9 Jam 1972 00:00:00 GMT
User must use GET and POST to establish two channels for downstream and upstream. The
x-sessioncookie in GET and POST should be the same to be recognized as a pair for one session. The
contents of upstream should be base64 encoded to be able to pass through the proxy server.
This channel will help perform real-time event subscription and notification as well as camera
control more efficiently. The event and control formats are described in another document.
See Event/control tunnel spec for detail information
8.13 Get SDP of Streams
Note: This request requires Viewer access privileges.
Method: GET/POST
Syntax:
http://<servername>/<network_rtsp_s<0~(n*m)-1>_accessname>
n denotes the value of "capability_nvideoin", m denotes the value of "capability_nmediastream".
Example:
For m=2, the values are shown as
network_rtsp_s0_accessname = live1s1.sdp
network_rtsp_s1_accessname = live1s2.sdp
VIVOTEK
428 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
276
network_rtsp_s2_accessname = live2s1.sdp
network_rtsp_s3_accessname = live2s2.sdp
etc.
* For version number(httpversion) above 0311c, the default RTSP access name format is
“live<n>s<m>.sdp”. Please refer to the “subgroup of network: rtsp” for setting the accessname of
S D P.
* You can get the SDP by HTTP GET.
* When using scalable multicast, Get SDP file which contains the multicast information via HTTP.
Note:
* We recommend to use new format to access streaming when
capability_media_streamprofiles_support=1, please refer to Methods for Accessing Streaming
8.14 Open the Network Stream
Note: This request requires Viewer access privileges.
Syntax:
For HTTP push server (MJPEG):
http://<servername>/<network_http_s<0~m-1>_accessname>
For RTSP (MP4), the user needs to input theURL below into an RTSP compatible player.
rtsp://<servername>/<network_rtsp_s<0~m-1>_accessname>
“m” is the stream number.
For details on streaming protocol, please refer to the “control signaling” and “data format”
documents.
8.15 Send Data (capability_nuart > 0)
Note: This request requires Viewer privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/viewer/senddata.cgi?
[com=<value>][&data=<value>][&flush=<value>] [&wait=<value>] [&read=<value>]
PARAMETER VALUE DESCRIPTION
com
1 ~ <max. com port
number>
The target COM/RS485 port number.
VIVOTEK
User's Manual - 429
© 2022 VIVOTEK INC. All Right Reserved
277
data <hex decimal
data>[,<hex decimal
data>]
The <hex decimal data> is a series of digits from 0 ~ 9, A ~
F. Each comma separates the commands by 200
milliseconds.
flush
yes,no
yes: Receive data buffer of the COM port will be cleared
before read.
no: Do not clear the receive data buffer.
wait 1 ~ 65535 Wait time in milliseconds before read data.
read
1 ~ 128
The data length in bytes to read. The read data will be in
the return page.
Return:
HTTP/1.0 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: <system information length>\r\n
\r\n
<hex decimal data>\r\n
Where hexadecimal data is digits from 0 ~ 9, A ~ F.
8.16 Storage Managements (capability_storage_dbenabled > 0)
Method: GET and POST
Note: This request requires administrator privileges.
In the past time, all the recorded files could be searched/updated/deleted independently. However,
this implementation provides no abstraction of recorded video clips, and which is not easy to use.
Thus edge storage API try to provide a higher abstraction of these video clips.
Ability to change database content from lsctrl.cgi was removed, lsctrl.cgi is changed to read-only.
PLEASE REFER TO EDGE STORAGE API
Syntax:
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=<cmd_type>[&<parameter>=<value>…]
The commands usage and their input arguments are as follows.
PARAMETER
VALUE
DESCRIPTION
cmd_type <string> Required.
Command to be executed, including search and
queryStatus.
VIVOTEK
430 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
278
Command: search
PARAMETER VALUE DESCRIPTION
label
<integer primary key>
Optional.
The integer primary key column will automatically be
assigned a unique integer.
triggerType <text> Optional.
Indicate the event trigger type.
Please embrace your input value with single quotes.
Ex. triggerType=’vi’
mediaType
<text>
Optional.
Indicate the file media type.
Ex. mediaType=videoclip
* logical “OR” is not supported for this parameter.
destPath <text> Optional.
Indicate the file location in camera.
Please embrace your input value with single quotes.
Ex. destPath =’/mnt/auto/CF/NCMF/abc.mp4’
resolution
<text>
Optional.
Indicate the media file resolution.
Please embrace your input value with single quotes.
Ex. resolution=’800x600’
isLocked <boolean> Optional.
Indicate if the file is locked or not.
0: file is not locked.
1: file is locked.
A locked file would not be removed from UI or cyclic
storage.
triggerTime
<text>
Optional.
Indicate the event trigger time. (not the file created
time)
Format is “YYYY-MM-DD HH:MM:SS”
Please embrace your input value with single quotes.
Ex. triggerTime=’2008-01-01 00:00:00’
If you want to search for a time period, please apply
“TO” operation.
Ex. triggerTime=’2008-01-01 00:00:00’+TO+’2008-01-01
23:59:59’ is to search for records from the start of Jan 1
st
2008 to the end of Jan 1
st
2008.
VIVOTEK
User's Manual - 431
© 2022 VIVOTEK INC. All Right Reserved
279
PARAMETER VALUE DESCRIPTION
limit
<positive integer>
Optional.
Limit the maximum number of returned search records.
offset <positive integer> Optional.
Specifies how many rows to skip at the beginning of the
matched records.
Note that the offset keyword is used after limit keyword.
To increase the flexibility of search command, you may use “OR” connectors for logical “OR” search
operations. 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’
&triggerTime=’2008-01-01 00:00:00’+TO+’2008-01-01 23:59:59’
Command: queryStatus
PARAMETER VALUE DESCRIPTION
retType xml or javascript Optional.
Ex. retype=javascript
The default return message is in XML format.
Ex. Query local storage status and call for javascript format return message.
http://<servername>/cgi-bin/admin/lsctrl.cgi?cmd=queryStatus&retType=javascript
There are two cgi commands for download and composing jpegs to avi format.
For download single selected file, you can use “/cgi-bin/admin/downloadMedias.cgi”. Just assign
the request file path to this cgi.
Syntax:
http://<servername>/cgi-bin/admin/downloadMedias.cgi?<File_Path>
The <File_Path> is in queryststus return message.
Ex.
http://<servername>/cgi-bin/admin/downloadMedias.cgi?/mnt/auto/CF/NCMF/20090310/07/02.
mp4
Syntax:
Loading page 432...
Loading page 433...
VIVOTEK
434 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
282
setvi.cgi?vi0=0(15000)1
setvi.cgi?vi0=1
Request 2 will not be accepted during the execution time(15 seconds).
8.18 Open Timeshift Stream (capability_timeshift > 0,
timeshift_enable=1, timeshift_c<n>_s<m>_allow=1)
Note: This request requires Viewer access privileges.
Syntax:
For HTTP push server (MJPEG):
http://<servername>/<network_http_s<m>_accessname>?maxsft=<value>[&tsmode=<value>&reft
ime=<value>&forcechk&minsft=<value>]
For RTSP (MP4 and H264), the user needs to input theURL below into an RTSP compatible player.
rtsp://<servername>/<network_rtsp_s<m>_accessname>?maxsft=<value>[&tsmode=<value>&refti
me=<value>&forcechk&minsft=<value>]
“n” is the channel index.
“m” is the timeshift stream index.
For details on timeshift stream, please refer to the “TimeshiftCaching” documents.
PARAMETER VALUE DEFAULT DESCRIPTION
maxsft
<positive
integer>
0
Request cached stream at most how many seconds
ago.
The value must be a positive integer. (>0)
tsmode normal,
adaptive
normal Streaming mode:
normal => Full FPS all the time.
adaptive => Default send only I-frame for MP4 and
H.264, and send 1 FPS for MJPEG. If DI or motion
window are triggered, the streaming is changed to
send full FPS for 10 seconds.
(*Note: this parameter also works on non-timeshift
streams.)
tsmode must exactly match well-defined wording
(normal, adaptive), unknown parameters are always
ignored.
VIVOTEK
User's Manual - 435
© 2022 VIVOTEK INC. All Right Reserved
283
PARAMETER VALUE DEFAULT DESCRIPTION
reftime
mm:ss
The time
camera
receives the
request.
Reference time for maxsft and minsft.
(This provides more precise time control to eliminate
the inaccuracy due to network latency.)
Ex: Request the streaming from 12:20
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 and if minsft is achievable.
If false, return “415 Unsupported Media Type”.
minsft
<positive
integer>
0
How many seconds of cached stream client can
accept at least.
(Used by forcechk)
The value must be a positive integer. (>0)
Return Code
Description
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 timeshift feature of the target stream is not enabled.
8.19 RemoteFocus
(capability_image_c<0~(n-1)>_remotefocus=1)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax: (for control API)
http://<servername>/cgi-bin/admin/remotefocus.cgi?channel=<value>&[function=<value>][&direct
ion=<value>][&position=<value>][&steps=<value>][&iris]
PARAMETER
VALUE
DESCRIPTION
channel 0~"capability_nvideoin"-1
Channel of the video source.
VIVOTEK
436 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
284
PARAMETER VALUE DESCRIPTION
function
zoom,
focus,
auto,
scan,
stop,
positioning,
irisopen,
irisenable
zoom - Move focus motor
focus – Move focus motor
auto – Perform auto focus
scan – Perform focus scan
stop – Stop current operation
positioning – Position the motors
irisopen – Fully open iris. It will maintain fully open iris
status until sending function=irisenable cgi.
irisenable – return back to user setting status of iris.
direction direct,
forward,
backward
Motor’s moving direction.
It works only if function=zoom or function=focus.
position
<motor_start> ~
<motor_end>
Motor’s position.
It works only if function=zoom or function= focus and
direction=direct.
<motor_start> : remote_focus_zoom_motor_start or
remote_focus_focus_motor_start,
<motor_end> : remote_focus_zoom_motor_end or
remote_focus_focus_motor_end replied from
"function=getstatus"
steps 1 ~ 30 Motor’s moving steps.
It works only if function=zoom or function=focus and
direction=forward and direction=backward.
* Motor will stop when it reaches to <motor_start> or
<motor_end>.
* This parameter is for additional fine-tune, the value is
from 1 to 30.
iris
N/A
Open iris or not.
It works only if function=auto or function=scan.
Syntax: (for query API)
http://<servername>/cgi-bin/admin/remotefocus.cgi?channel=<value>&[function=<value>]
Loading page 437...
VIVOTEK
438 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
286
PARAMETER VALUE DESCRIPTION
function
focus,
auto,
scan,
stop,
positioning,
irisopen,
irisenable,
resetfocus
focus – Move focus motor
auto – Perform auto focus
scan – Perform focus scan
stop – Stop current operation
positioning – Position the motors
resetfocus – reset focus position to default
irisopen – Fully open iris. It will maintain fully open iris
status until sending function=irisenable cgi.
irisenable – return back to user setting status of iris.
direction direct,
forward,
backward
Motor’s moving direction.
It works only if function= focus.
position
<motor_start> ~
<motor_end>
Motor’s position.
It works only if function=focus and direction=direct.
<motor_start> : remote_focus_zoom_motor_start or
remote_focus_focus_motor_start,
<motor_end> : remote_focus_zoom_motor_end or
remote_focus_focus_motor_end replied from
"function=getstatus"
steps 1 ~ 30 Motor’s moving steps.
It works only if function=focus and direction=forward or
direction=backward.
* Motor will stop when it reaches to <motor_start> or
<motor_end>.
* This parameter is for additional fine-
tune, the value is from 1
to 30.
iris
N/A
Open iris or not.
It works only if function=auto or function=scan.
Syntax: (for query API)
http://<servername>/cgi-bin/admin/remotefocus.cgi?channel=<value>&[function=<value>]
Loading page 439...
Loading page 440...
VIVOTEK
User's Manual - 441
© 2022 VIVOTEK INC. All Right Reserved
289
Server will accept the file named <file name> to upload this one to camera.
8.23 Update Lens Configuration
(capability_image_c<0~(n-1)>_lensconfiguration_support > 0)
Note: This request requires Administrator privileges.
Method: GET
Syntax:
For list a name of lens currently used:
http://<servername>/cgi-bin/admin/update_lens.cgi?get_currentlens
For list all names of lens installed in camera:
http://<servername>/cgi-bin/admin/update_lens.cgi?list_lens
For choose selected lens configuration:
http://<servername>/cgi-bin/admin/update_lens.cgi?choose_lens=<value>
You need to reboot manually after you choose another lens configuration.
For choose selected lens configuration and reboot camera:
http://<servername>/cgi-bin/admin/update_lens.cgi?choose_reboot_lens=<value>
The camera will reboot after using this cgi.
For delete selected lens configuration:
http://<servername>/cgi-bin/admin/update_lens.cgi?delete_lens=<value>
PARAMETER VALUE DESCRIPTION
value
<string>
Available lens name.
Please refer to:
lens_default_i<0~(n-1)>_name
lens_user_i<0~(n-1)>_name
n is a positive integer.
Method: POST
Syntax:
VIVOTEK
442 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
290
For upload user-defined lens configuration:
http://<servername>/cgi-bin/admin/update_lens.cgi?upload_lens
Post data:
upload_lens_profile_input = <file name>\r\n
\r\n
<multipart encoded form data>
Server will accept the file named <file name> to upload the lens profile to camera.
8.24 Media on Demand (capability_localstorage.modnum > 0)
Media on demand allows users to select and receive/watch/listen to metadata/video/audio
contents on demand.
Note: This request requires Viewer access privileges.
Syntax:
rtsp://<servername>/mod.sdp?[&stime=<value>][&etime=<value>][&length =<value>][&loctime
=<value>][&file=<value>][&tsmode=<value>]
PARAMETER VALUE DEFAULT DESCRIPTION
stime
<YYYYMMDD_HHMMSS.MMM>
N/A
Start time.
etime <YYYYMMDD_HHMMSS.MMM>
N/A End time.
length
<positive integer>
N/A
The length of media of interest.
The unit is second.
loctime <boolean> 0 Specify if start/end time is local time
format.
1 for local time, 0 for UTC+0
file
<string>
N/A
The media file to be played.
tsmode <positive integer> N/A Timeshift mode, the unit is second.
Ex.
stime
etime
length
file
Description
V
V
X
X
Play recordings between stime and etime
rtsp://10.10.1.2/mod.sdp?stime=20110312_040400.000&etime=2011_0312_040
510.000
V
X
V
X
Play recordings for length seconds which start from
stime
rtsp://10.10.1.2/mod.sdp?stime=20110312_040400.000&length=120
VIVOTEK
User's Manual - 443
© 2022 VIVOTEK INC. All Right Reserved
291
X
V
V
X
Play recordings for length seconds which ends at
etime
rtsp://10.10.1.2/mod.sdp?etime=20110312_040400.000&length=120
X
X
X
V
Play file file
rtsp://10.10.1.2/mod.sdp?filename=/mnt/link0/
Loading page 444...
VIVOTEK
User's Manual - 445
© 2022 VIVOTEK INC. All Right Reserved
293
8.26 Camera Control
(capability_camctrl_c<0~(n-1)>_zoommodule = 1)
Note: This request requires Viewer privileges.
Method: GET/POST
Syntax: (for control API)
http://<servername>/cgi-bin/camctrl/camctrl.cgi?[channel=<value>][&camid=<value>]
[&move=<value>] – Move home, up, down, left, right
[&focus=<value>] – Focus operation
[&zoom=<value>] – Zoom in, out
[&zooming=<value>&zs=<value>] – Zoom without stopping, used for joystick
[&vx=<value>&vy=<value>&vs=<value>] – Shift without stopping, used for joystick
[&x=<value>&y=<value>&videosize=<value>&resolution=<value>&stretch=<value>] – Click on
image
(Move the center of image to the coordination (x,y) based on resolution or videosize.)
[ [&speedpan=<value>][&speedtilt=<value>][&speedzoom=<value>][&speedapp=<value>][&speedl
ink=<value>] ] – Set speeds
[&return=<return page>]
Example:
http://myserver/cgi-bin/camctrl/camctrl.cgi?channel=0&camid=1&move=right
http://myserver/cgi-bin/camctrl/camctrl.cgi?channel=0&camid=1&zoom=tele
http://myserver/cgi-bin/camctrl/camctrl.cgi?channel=0&camid=1&x=300&y=200&resolution=704x
480&videosize=704x480&strech=1
Example: (set the ptz preset with focus mode)
* We support this function when the version number of the PTZ control module is equal or greater
than 5.0.0.20.
http://myserver/cgi-bin/camctrl/camctrl.cgi?name=xxx&focussetting=sync&cam=getsetpreset
PARAMETER VALUE DESCRIPTION
channel
<0~(n-1)>
Channel of video source.
camid 0,<positive integer> Camera ID.
move
home
Move to camera to home position.
up Move camera up.
VIVOTEK
446 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
294
PARAMETER VALUE DESCRIPTION
down
Move camera down.
left Move camera left.
right Move camera right.
speedpan
-5 ~ 5
Set the pan speed.
speedtilt -5 ~ 5 Set the tilt speed.
speedzoom -5 ~ 5 Set the zoom speed.
speedfocus
-5 ~ 5
Set the focus speed.
speedapp -5 ~ 5 Set the auto pan/patrol speed.
auto pan Auto pan.
patrol Auto patrol.
stop Stop camera.
zoom wide Zoom larger view with current speed.
tele Zoom further with current speed.
stop Stop zoom.
zooming wide or tele
Zoom without stopping for larger view or further view with
zs speed, used for joystick control.
zs 0 ~ 8 <SD8362> Set the speed of zooming, “0” means stop.
vx <integer , excluding
0>
The slope of movement = vy/vx, used for joystick control.
vy
<integer>
vs 0 ~ 127 Set the speed of movement, “0” means stop.
x <integer> x-coordinate clicked by user.
It will be the x-coordinate of center after movement.
y <integer> y-coordinate clicked by user.
It will be the y-coordinate of center after movement.
videosize <window size> The size of plug-in (ActiveX) window in web page
resolution <window size> The resolution of streaming.
stretch <boolean> 0 indicates that it uses resolution (streaming size) as the
range of the coordinate system.
1 indicates that it uses videosize (plug-in size) as the range
of the coordinate system.
VIVOTEK
User's Manual - 447
© 2022 VIVOTEK INC. All Right Reserved
295
PARAMETER VALUE DESCRIPTION
focus auto Auto focus.
far
Focus on further distance.
near Focus on closer distance.
focusseting sync Applies the selected focus mode in
camctrl_c<0~(n-1)>_focusmode to this preset.
fixcurrent
Applies the current focus position to this preset.
* We support this function when the version number of the PTZ control module is
equal or greater than 5.0.0.20.
cam getsetpreset Adds a named preset at current position, and return the
preset index.
* We support this function when the version number of
the PTZ control module is equal or greater than 5.0.0.20.
Syntax: (for query API)
http://<servername>/cgi-bin/camctrl/camctrl.cgi?[<parameter>] [&<parameter>...]
Example:
http://myserver/cgi-bin/camctrl/camctrl.cgi?getpan
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
pan=4117\r\n
PARAMETER VALUE DESCRIPTION
getversion <string> Get the version of the PTZ control module.
getaction idle,
autopan,
tracking,
tour,
patrol,
Get the current status of the camera.
* We support this parameter when the version number
(getversion) is equal or greater than 5.0.0.12
getpan 0, <positive integer> Get the current pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
VIVOTEK
448 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
296
PARAMETER VALUE DESCRIPTION
getpanangle
<integer>
Get the current pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
gettilt 0, <positive integer> Get the current tilt position.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
gettiltangle
<integer>
Get the current tilt angle.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getzoom 0, <positive integer> Get the current zoom position.
getratio
<decimal>
Get the current zoom ratio.
getfocus 0, <positive integer> Get the current focus position.
getminspeedlv
0, <positive integer>
Get the minimum speed level of the PTZ control. Normally,
the speed level is ‘0,’ which denotes halting a continuous
movement.
getmaxptspeedlv
0, <positive integer> Get the maximum speed level of pan/tilt moving.
*Only available when
"capability_camctrl_c<0~(n-1)>_buildinpt" > 0
getmaxzspeedlv
0, <positive integer>
Get the maximum speed level of zoom moving.
getmaxfspeedlv 0, <positive integer> Get the maximum speed level of focus moving.
getminpan
0, <positive integer>
Get the lower limit for pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxpan 0, <positive integer> Get the upper limit for pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getminpanangle
<integer>
Get the lower limit for pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxpanangle <integer> Get the upper limit for pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmintilt
0, <positive integer>
Get the lower limit for tilt position.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxtilt 0, <positive integer> Get the upper limit for tilt position.
*Only available when bit1 of
VIVOTEK
User's Manual - 449
© 2022 VIVOTEK INC. All Right Reserved
297
PARAMETER VALUE DESCRIPTION
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmintiltangle <integer> Get the lower limit for tilt angle.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxtiltangle
<integer>
Get the upper limit for tilt angle.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getminzoom 0, <positive integer> Get the lower limit for zoom position.
getmaxzoom
0, <positive integer>
Get the upper limit for zoom position.
getmaxdzoom 0, <positive integer> Get the upper limit for digital zoom position.
getmaxratio
<decimal>
Get the maximum ratio of optical zoom.
* We support this parameter when the version number
(getversion) is equal or greater than 5.0.0.14
getmaxdratio <decimal> Get the maximum ratio of digital zoom.
* We support this parameter when the version number
(getversion) is equal or greater than 5.0.0.14
getminfocus
0, <positive integer>
Get the lower limit for focus position.
getmaxfocus 0, <positive integer> Get the upper limit for focus position.
8.27 Recall (capability_camctrl_c<0~(n-1)>_zoommodule = 1)
Note: This request requires Viewer privileges.
Method: GET
Syntax:
http://<servername>/cgi-bin/viewer/recall.cgi?
recall=<value>[&channel=<value>][&return=<return page>]
PARAMETER VALUE DESCRIPTION
recall
string[30]
One of the present positions to recall.
channel
0~"
capability_nvideoin"-1
Channel of the video source.
VIVOTEK
450 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
298
8.28 Preset Locations
(capability_camctrl_c<0~(n-1)>_zoommodule = 1)
Note: This request requires Operator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/operator/preset.cgi?[channel=<value>]
[&addpos=<value>][&delpos=<value>][&return=<return page>]
PARAMETER VALUE DESCRIPTION
addpos
string[30]
Add one preset location to the preset list.
channel
0~"capability_nvideoin"-1
Channel of the video source.
delpos string[30] Delete preset location from preset list.
return <return page>
Redirect to the page <return page> after the parameter
is assigned. The <return page> should be the relative
path according to the root of camera. If you omit this
parameter, it will redirect to an empty page.
* If the <return page> is invalid path, it will ignore this
parameter.
8.29 SmartSD (capability_localstorage_smartsd > 0)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/admin/smartsd.cgi?function=<value>
Loading page 451...
Loading page 452...
VIVOTEK
User's Manual - 453
© 2022 VIVOTEK INC. All Right Reserved
301
PARAMETER VALUE DESCRIPTION
N/A
N/A
Get wireless signal strength.
8.33 WPS Transaction (capability_network_wireless > 0)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/admin/start_wps.cgi
PARAMETER
VALUE
DESCRIPTION
N/A N/A Start WPS transaction.
8.34 Peripheral Control (capability_peripheral_c<0~(n-1)>_
devicecontrol > 0)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax: (for control API)
http://<servername>/cgi-bin/admin/peripheral.cgi?channel=<value>&operation=set
[&washer_mode=<value>] – Set washer mode
[&washer_status=<value>] – Set washer status
[&washer_dwelltime=<value>] – Set washer clean time
[&heater_status=<value>] – Set heater status
Example:
http://myserver/cgi-bin/admin/peripheral.cgi?channel=0&operation=set&washer_mode=wiper&
washer_status=on
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
VIVOTEK
454 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
302
"washer_mode : OK\r\n"
"washer_status : FAIL\r\n"
PARAMETER VALUE DESCRIPTION
channel
0~"capability_nvideoin"-1
Channel of the video source.
washer_mode wiper Apply the wiper to the mode of washer
control system.
washer
Apply the washer to the mode of washer
control system.
washer_status on Enable the functionality of washer control
system.
off
Disable the functionality of washer control
system.
washer_dwelltime 15~999 Apply washer washer control system
operation time (including the time when
spraying and wiper actions take place).
heater_status
auto
automatic control the heater component to
keep the device in a workable environment.
trigger heater component is work in force heater
once.
Syntax: (for query API)
http://<servername>/cgi-bin/admin/peripheral.cgi?channel=<value>&operation=get
[&supportdevice] –Get support peripheral device
[&washer_supportmode] – Get washer support modes
[&washer_mode] – Get washer mode
[&washer_status] – Get washer status
[&washer_dwelltime] – Get washer clean time
[&heater_supportstatus] – Get heater support control status
[&heater_status] – Get heater status
Example:
http://myserver/cgi-bin/admin/peripheral.cgi?channel=0&operation=get&supportdevice&washer_
status
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
VIVOTEK
User's Manual - 455
© 2022 VIVOTEK INC. All Right Reserved
303
Pragma: no-cache\r\n
\r\n
supportdevice=washer,heater\r\n
washer_status=off\r\n
PARAMETER VALUE DESCRIPTION
channel
0~"capability_nvideoin"-1
Channel of the video source.
supportdevice N/A Get support peripheral device.
washer_supportmode
N/A
Get the support mode of washer control system.
washer_mode N/A
Get the current mode of washer control system.
It return the value of "washer_mode"
washer_status
N/A
Get the current status of washer control module.
The status is 'off' as default, which means the
washer is stopped; and the status 'on' means the
washer is running.
washer_dwelltime N/A Get the current washer clean period of washer
control system.
heater_supportstatus
N/A
Get the support status of heater control system.
heater_status N/A
Get the current heater status.
Normally it will be 'auto', it means the heater
device is control by internal algorithm to keep in
a suitable environment; Otherwise is 'trigger', it
means the heater device is force enable to heat
to an internal condition.‘trigger’ status will be
transfer to ‘auto’ after reach the internal
condition.
Loading page 456...
VIVOTEK
User's Manual - 457
© 2022 VIVOTEK INC. All Right Reserved
305
http://myserver/cgi-bin/admin/devicemonitor.cgi
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
devicemonitor_tempsensor_i0_name=front glass
devicemonitor_tempsensor_i0_celsius=30
devicemonitor_tempsensor_i0_fahrenheit=86
devicemonitor_heater_i0_name=front glass
devicemonitor_heater_i0_status=off
8.36 Optimized IR control
(capability_daynight_c<0~(n-1)>_optimizedir > 0)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax:
http://<servername>/cgi-bin/admin/optimizedir.cgi?function=<value>[&channel=<value>]
PARAMETER
VALUE
DESCRIPTION
channel
0~"capability_nvideoin"-1
Channel of the video source.
Loading page 458...
Loading page 459...
VIVOTEK
460 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
308
http://myserver/cgi-bin/admin/optimizedir.cgi?channel=0&operation=set&irmode=auto&strength=
50,70,50,50,50
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
ERROR: Parameter "irmode" must be set as "manual"!
Example:
http://myserver/cgi-bin/admin/optimizedir.cgi?channel=0&operation=set&strength=50,70,50,50,50
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
ERROR: Must have the "irmode=manual" argument!
Syntax: (for query API)
http://<servername>/cgi-bin/admin/optimizedir.cgi?channel=<value>&operation=get
[&support_irmode] – list all adjustment mode that IR supports
[&irmode] – Get current IR mode
[&irnum] – Get the number of IR zone
PARAMETER
VALUE
DESCRIPTION
channel
0~"capability_nvideoin"-1
Channel of the video source.
support_irmode
N/A
List all adjustment mode that IR supports
irmode
N/A
Get the current IR control mode.
irnum
N/A
Get the number of IR that camera supports.
Example:
VIVOTEK
User's Manual - 461
© 2022 VIVOTEK INC. All Right Reserved
309
http://myserver/cgi-bin/admin/optimizedir.cgi?channel=0&operation=get&irmode
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
"optimizedir_c0_irmode='auto'"
8.37 Lens Thermal Control
(capabiltiy_image_c<0~(n-1)>_sensortype=thermalsensor)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax: (for control API)
http://<servername>/cgi-bin/admin/thermalctrl.cgi?operation=set
&action=<value>
Example:
http://myserver/cgi-bin/admin/thermalctrl.cgi?operation=set&action=shuttercompensate
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
OK
Example:
http://myserver/cgi-bin/admin/thermalctrl.cgi?operation=set&action=shuttercompensate
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
ERROR: time out
VIVOTEK
462 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
310
Example:
http://myserver/cgi-bin/admin/thermalctrl.cgi?operation=set&action=shuttercompensate
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
ERROR: fail
PARAMETER
VALUE
DESCRIPTION
action
shuttercompensate
Camera will do shutter compensate.
Syntax: (for query API)
http://<servername>/cgi-bin/admin/thermalctrl.cgi?operation=get&version=<value>
PARAMETER VALUE DESCRIPTION
version N/A
Indicate lensctrl thermal version
Example:
http://myserver/cgi-bin/admin/thermalctrl.cgi?operation=get&version
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
version=1120B15
8.38 Audio Clip Control (capability_audio_audioclip=1)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax:
(for control API)
Loading page 463...
Loading page 464...
VIVOTEK
User's Manual - 465
© 2022 VIVOTEK INC. All Right Reserved
313
Get Get formatting progress(0~100) or
result(error message)
*It is unnecessary when using the
blocking mode.
Example:
Request of get formatting progress(0~100):
http://myserver/cgi-bin/admin/format_sdcard.cgi?operation=get
Response of success:
HTTP/1.1 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: <Success Message Length>\r\n
\r\n
<Success Message>
List of success message:
0~100 and 100 represents formatting completed
List of error message:
ERROR: You cannot format an SD card repeatedly
ERROR: Format SD failed, but removed all contents success
ERROR: Format SD failed, and failed to remove all contents
ERROR: Please insert SD card
ERROR: Please use ext file system
ERROR: File system type is not supported
ERROR: The device does not exist or is busy
ERROR: Formatted successfully, but cannot create database
8.40 Methods for Accessing Streaming
8.39.1 Get Stream URI
(capability_media_streamprofiles_support = 1)
Note: This request requires Viewer access privileges.
Syntax:
For RTSP, the user needs to input the URL below into a RTSP compatible pl aye r.
rtsp://<servername>:<port>/media2/stream.sdp?profile=<streamprofile_i<0~(n-1)>_token>[&<par
ameter>=<value>]
VIVOTEK
466 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
314
“n” is the maximum stream profile number (capability_media_streamprofiles_num)
“streamprofile_i<x>_token” is the unique identifier for each profile, x is within
0~(capability_media_streamprofiles_num)-1.
port is the rtsp port.
Please refer to the streamprofile group for requesting the stream profile token value for each
profile.
PARAMETER VALUE DESCRIPTION
pimssm
1
1: Enable the feature of Protocol
Independent Multicast - Source
Specific Multicast.
* This field is only required when
using PIM-SSM feature.
* Only valid when
network_rtsp_pimssm_enable=1.
Example:
Request the streaming of streamprofile_i0_token=Profile200,
rtsp://192.168.1.1:554/media2/stream.sdp?profile=Profile200
Note:
If the requested certain profile streamprofile_i<x>_occupied=0, which indicates stream profile <x>
has not been created, the above method for requesting RTSP streaming will fail.
8.39.2 Get SDP for always multicast
(capability_media_streamprofiles_support = 1)
Note: This request requires Viewer access privileges.
Method: GET/POST
Syntax:
http://<servername>:<port>/media2/<streamprofile_i<0~(n-1)>_profilename>.sdp?[<parameter>=
<value>]
“n” is the maximum stream profile number (capability_media_streamprofiles_num)
“streamprofile_i<x>_profilename” is a friendly name for certain profile, x is within
0~(capability_media_streamprofiles_num)-1.
port is the http port.
VIVOTEK
User's Manual - 467
© 2022 VIVOTEK INC. All Right Reserved
315
Please refer to the streamprofile group for requesting the stream profile name value for each
profile.
You can get the SDP by HTTP GET.
When using scalable multicast, Get SDP file which contains the multicast information via HTTP.
PARAMETER VALUE DESCRIPTION
pimssm
1
1: Enable the feature of Protocol
Independent Multicast - Source
Specific Multicast.
* This field is only required when
using PIM-SSM feature.
* Only valid when
network_rtsp_pimssm_enable=1.
Note:
1. This method is only valid when always multicast is enabled, i.e.
streamprofile_i<x>_alwaysmulticast=1.
2. If the requested certain streamprofile_i<x>_profilename is empty, which indicates stream profile
<x> doesn’t have a valid SDP file, the above method of requesting SDP file will fail.
3. If there existed two or more streamprofile_i<x>_profilename which have the same value, the
requested SDP file will be overwrite by the last request.
8.41 Accessing SFTP server and client
8.40.1 SFTP server setting for event action
* Only available when bit 1 of "capability_protocol_ftp_client" is 1.
Syntax: (for control API)
http://<servername>/cgi-bin/admin/sftpclient.cgi?operation=<value>[¶meter=<value>]
PARAMETER VALUE DESCRIPTION
operation automode, manualmode "automode": Key pair will be generated, and
automatically copy public key to server.
"manualmode": Key should be downloaded or
uploaded by user.
* This field is required.
key download, upload "download": Download public key.
"upload": Upload private key. Only support HTTP
Loading page 468...
Loading page 469...
VIVOTEK
470 - User's Manual
© 2022 VIVOTEK INC. All Right Reserved
318
Accept: text/html, application/xhtml+xml, */*
Accept-Language: zh-TW
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0) like Gecko
Content-Type: multipart/form-data; boundary=---------------------------7e1309282ed0f1a
Accept-Encoding: gzip, deflate
Host: 172.16.219.217
Content-Length: 6123
Connection: Keep-Alive
Pragma: no-cache
Cookie: webptzmode=continuous; activatedmode=digital; g_mode=1; viewsizemode=Auto;
4x3=false; lan=8
Authorization: Basic cm9vdDpGREQwMDAwMA==
-----------------------------7e1309282ed0f1a
Content-Disposition: form-data; name="parameter"
operation=manualmode&key=upload&index=1
-----------------------------7e1309282ed0f1a
Content-Disposition: form-data; name="uploadKeyFile"; filename="id_rsa"
Content-Type: text/plain
-----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: AES-128-CBC,E6B9F3F257EF2DA03BA8A4832BC6386F
NYzaqdoY7OxS0XhviOKncGbMLpnx6n3VRYbeArSBwn+6wA7Y4lknFoMQiuC4HrCa
oHgEex609584TWFBrkR+DfqKB73RCALTeAqAhEtywq75KQTWyHJcpOu8qZxquoKE
TovnyQQANfyNLykEtP7U7Htxbdqg4dqYdFahJEBNs0QHxhmYHTESccKM4NOB0qMY
5+9gwlMZqNIymxGlGwylTMcV7gV6JaY/bX0K4J0B6AhNHjCIOFErrQivp026TXj9
m+bnnrAt7v5uBMH4oclPC8oDHqd1jWwHIBcbqjRPWL37VW5B+YPZQ7FVUP496OKp
riheNLTF6yOtYFw9syyoOnRF+gxpFpQrSO7skENGyv4CO7kH/S7Kpc7qmMgTk/rL
s12230NogZsqghhTJIpg2vX5Ha3wCDIZZVKPUGItQl0MB6t74nsV1o8YVtRovI5F
YX2d8sPIIkcTDWBO498+v98DQ7DH51/i39JoJouRojz+n3ffsSGjY2AKEcTde2xI
v2f81KqAxkraXllScl1SNEGXQpngXy3IK2GrVw9BzJILMSBuj30Ar2zfTbc0C5VC
YqWK1FcMA5Jb6AvYwmpgijIb52T9P7g07RwFGJpumvaqTchBeSp8pXa3C++DoBdY
9zYohmuSSs52QLoIkTPzDjJJHvncddPi6VuUkSyaK5x75p0+aoljPjlAQHXbXsmt
8HAdPs9Fwab9GbC2aumH4XT1xoWFnYJ9lBHc3iZRiI/nSIPev2YneyyOhJg4tHYD
swUUEydNC8Q5qrbLfHESDrkHlx0sQiM7A/DyY1akkoxKEFW9LxqsJpcf7LM2TrlX
VIVOTEK
User's Manual - 471
© 2022 VIVOTEK INC. All Right Reserved
319
IjSd+RMqL3yCFzM0aqcQNjd77nDP6+u9RYYyGT8dH5ud7pJVofxI+pvpQN3k5Tlb
Pm9IM6OJPDy/Netcu6YEl3ULa6XHkYldqezJDnUfCBHe3OKjhue2FTBRmM2/j9Zl
DkUrO7lQz7X88T/w5+rI2OnDIm3szOhzMCYPtHxf8ygMKXI/DKp3OR2/cu6ayGhb
DezpoSyTjL1fTFINQAymDtP5tbomfESjFDW1fmfD9h1FivqYEy7017djPWrq8mjH
N6nAhlaLVVuTVJ+xxaJAzYiQwMdwWY8SGUq062ksDvfixYCQfhXUd629oEX82fJU
8OxF8CM0WEHFCIotJVbFjDyT5lP4qln5EMeMlPE8jrmUKEEV+AJw9AbaqvCYUNaH
EVZ7nlYjrnQqMCktYlO/Um8vSiVsOaMFLUdiYJwj2pzyceTzyW19/KEo//8ufOFD
LaSp5EGH6lBCTBfQ9PGeOkB2ZVf0jLFB9Sage8Ln5frWYOAROxzumUJWSvOoBael
15OdV5hApqQjGrn1vbc/kC8p478ZCzx2iDyckPqyVpHSke70T5bV6vcDZcCTrwkA
PHdD4Q0cqd7sX0R2OAScwJk2AkaQ+PsLwS05hw1nQBsQrC4m9e8Kmg32RgCGDAES
xpV9dkSkvoaLZmN1qfBwnyOxsjmx9OAOBKWzMlW5PoPCR9z8Z1gsiACBnrT+K5ec
NZdgsxvxMfdI7vfj6mkO89MvwLX8YEtnFrihIZmDnnVMuHfq6g5kbwlHbHVaoImo
-----END RSA PRIVATE KEY-----
-----------------------------7e1309282ed0f1a--
Syntax: (for query API)
http://<servername>/cgi-bin/admin/sftpclient.cgi?operation=<value>[¶meter=<value>]
PARAMETER
VALUE
DESCRIPTION
operation
getserverhostkey
" getserverhostkey ": Auto scan
SFTP server host key.
* This field is required.
address
<sftp server address or hostname>
sftp server address or hostname
* This field is required.
Example of scanning SFTP server host key:
Request:
http://<servername>/cgi-bin/admin/sftpclient.cgi?operation=getserverhostkey&address=<ip>
Response of success:
HTTP/1.1 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: <Success Message Length>\r\n
\r\n
Loading page 472...
VIVOTEK
User's Manual - 473
© 2022 VIVOTEK INC. All Right Reserved
321
finished, you will receive error
message.
Example of get host key:
Request:
http://<servername>/cgi-bin/admin/sftpserver.cgi?operation=gethostkey
Response of success
HTTP/1.1 200 OK\r\n
Content-Type: text/plain\r\n
Content-Length: <Success Message Length>\r\n
\r\n
MD5:a5:8a:7d:e2:2a:f8:c9:a0:ee:93:93:b8:0a:7a:18:97 (RSA)
MD5:7a:f4:07:48:e3:70:d5:89:15:36:6f:d5:25:f2:7e:0d (ED25519)
<End of document>
VIVOTEK
474 - User's Manual
Technology License Notice
Notices from HEVC Advance:
THIS PRODUCT IS SOLD WITH A LIMITED LICENSE AND IS AUTHORIZED TO BE USED ONLY
IN CONNECTION WITH HEVC CONTENT THAT MEETS EACH OF THE THREE FOLLOWING
QUALIFICATIONS: (1) HEVC CONTENT ONLY FOR PERSONAL USE; (2) HEVC CONTENT THAT
IS NOT OFFERED FOR SALE; AND (3) HEVC CONTENT THAT IS CREATED BY THE OWNER OF
THE PRODUCT. THIS PRODUCT MAY NOT BE USED IN CONNECTION WITH HEVC ENCODED
CONTENT CREATED BY A THIRD PARTY, WHICH THE USER HAS ORDERED OR PURCHASED
FROM A THIRD PARTY, UNLESS THE USER IS SEPARATELY GRANTED RIGHTS TO USE THE
PRODUCT WITH SUCH CONTENT BY A LICENSED SELLER OF THE CONTENT. YOUR USE OF
THIS PRODUCT IN CONNECTION WITH HEVC ENCODED CONTENT IS DEEMED ACCEPTANCE OF
THE LIMITED AUTHORITY TO USE AS NOTED ABOVE.
H.264
THIS PRODUCT IS LICENSED UNDER THE AVC PATENT PORTFOLIO LICENSE FOR THE
PERSONAL AND NON-COMMERCIAL USE OF A CONSUMER TO (i) ENCODE VIDEO IN
COMPLIANCE WITH THE AVC STANDARD ("AVC VIDEO") AND/OR (ii) DECODE AVC VIDEO
THAT WAS ENCODED BY A CONSUMER ENGAGED IN A PERSONAL AND NON-COMMERCIAL
ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO PROVIDER LICENSED TO PROVIDE AVC
VIDEO. NO LICENSE IS GRANTED OR SHALL BE IMPLIED FOR ANY OTHER USE. ADDITIONAL
INFORMATION MAY BE OBTAINED FROM MPEG LA, L.L.C. SEE HTTP://WWW.MPEGLA.COM
AMR-NB Standard
THIS PRODUCT IS LICENSED UNDER THE AMR-NB STANDARD PATENT LICENSE AGREEMENT. WITH
RESPECT TO THE USE OF THIS PRODUCT, THE FOLLOWING LICENSORS’ PATENTS MAY APPLY:
TELEFONAKIEBOLAGET ERICSSON AB: US PAT. 6192335; 6275798; 6029125; 6424938; 6058359. NOKIA
CORPORATION: US PAT. 5946651; 6199035. VOICEAGE CORPORATION: AT PAT. 0516621; BE PAT. 0516621;
CA PAT. 2010830; CH PAT. 0516621; DE PAT. 0516621; DK PAT. 0516621; ES PAT. 0516621; FR PAT. 0516621;
GB PAT. 0516621; GR PAT. 0516621; IT PAT. 0516621; LI PAT. 0516621; LU PAT. 0516621; NL PAT. 0516621;
SE PAT 0516621; US PAT 5444816; AT PAT. 819303/AT E 198805T1; AU PAT. 697256; BE PAT. 819303; BR PAT.
9604838-7; CA PAT. 2216315; CH PAT. 819303; CN PAT. ZL96193827.7; DE PAT. 819303/DE69611607T2; DK
PAT. 819303; ES PAT. 819303; EP PAT. 819303; FR PAT. 819303; GB PAT. 819303; IT PAT. 819303; JP PAT. APP.
8-529817; NL PAT. 819303; SE PAT. 819303; US PAT. 5664053. THE LIST MAY BE UPDATED FROM TIME TO
TIME BY LICENSORS AND A CURRENT VERSION OF WHICH IS AVAILABLE ON LICENSOR’S WEBSITE AT
HTTP://WWW.VOICEAGE.COM.
Loading page 475...
