VIVOTEK
User's Manual - 375
© 2022 VIVOTEK INC. All Right Reserved
236
PARAMETER VALUE
DEFAULT
DESCRIPTION
(normal, adaptive), unknown parameters are always
ignored.
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>][&direction=<value>][&position=
<value>][&steps=<value>][&iris]
PARAMETER VALUE
DESCRIPTION
channel
0~"capability_nvideoin"-
1
Channel of the video source.
© 2022 VIVOTEK INC. All Right Reserved
237
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>]