VIVOTEK
User's Manual - 395
© 2020 VIVOTEK INC. All Right Reserved
263
PARAMETER
VALUE
DESCRIPTION
state while “1” means
active or triggered state.
Where "nstate" is next
state after duration.
Ex: vi0=0(200)1
Setting virtual input 0 to normal state, waiting 200
milliseconds
, setting it to trigger state.
Note that when the virtual input is waiting for next
state, it cannot accept new requests.
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.
Return Code
Description
200
The request is successfully executed.
400
The request cannot be assigned, ex. incorrect parameters.
Examples:
setvi.cgi?vi0=0(10000)1(15000)0(20000)1
No multiple duration.
setvi.cgi?vi3=0
VI index is out of range.
setvi.cgi?vi=1
No VI index is specified.
503
The resource is unavailable, ex. Virtual input is waiting for next state.
Examples:
setvi.cgi?
vi0
=0(15000)1
setvi.cgi?
vi0
=1
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):
© 2020 VIVOTEK INC. All Right Reserved
264
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.
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)
