Differences

This shows you the differences between two versions of the page.

--- http_api [2020/10/30 18:49]
rachel [Decode Command]
+++ http_api [2020/10/30 18:55]
rachel
@@ Line 1: / Line 1: @@
 ====== HTTP API for Z3CAM / HE2K-DCK / HE4K-DCK / FV2K-DCK / FV4K-DCK/ FSDI-DCK / DME-10 / HE1080-RPS / ZCube / ZCube-SDI ======
 For HE4K-01 / HE4K-R4 / MVE-150 / MVE-100R / SME-01 / DME-02/03/04 use [[:http_api_lua|Z3-TI-http_api]]
 ===== Configuration API Syntax =====
 ==== Reading Configuration ====
@@ Line 54: / Line 52: @@
 ----
 ===== Decode Command =====
 decode instance=%d url=%s codec=%s viewport=%s
 ==== max_latency_ms ====
@@ Line 78: / Line 74: @@
 Possible values: h264, h265
 ==== viewport ====
@@ Line 85: / Line 80: @@
 Possible values: <font 16px/inherit;;inherit;;inherit>=</font>original, fit, keep_aspect, scale\\
-\\
 ====== ZIXI URL Parameters ======
 The URL may have parameters passed in as:
-base_url?param1=val1&param2=val2
+base_url?param1=val1¶m2=val2
 ==== fec ====
@@ Line 156: / Line 148: @@
 Possible values: <password>
-==== feccol ====
+===== Display Command =====
-Description: Column count for ProMPEG.
+==== display port ====
-Possible values: integer greater than 1
+Description:
-==== feconoff ====
+Possible values: display1, display2, ultrahd, hd
-Description: Enable ProMPEG if supported.
+==== format ====
-Possible values: on, off
+Description:
-==== fecrow ====
+Possible values: format_name
-Description: Row count for ProMPEG.
+Supported names:
-Possible values: integer greater than 1
+<font 10px/inherit;;inherit;;inherit>2160p60</font>
-==== filesize ====
+<font 10px/inherit;;inherit;;inherit>2160p5994</font>
-Description: Size of TSFILE or AUX file recording, in bytes.
+<font 10px/inherit;;inherit;;inherit>2160p50</font>
-A "K" suffix indicates kilobytes (thousands of bytes/second).
+<font 10px/inherit;;inherit;;inherit>2160p30</font>
-A "M" suffix indicates megabytes (millions of bytes/second).
+<font 10px/inherit;;inherit;;inherit>2160p2997</font>
-==== fprefix ====
+<font 10px/inherit;;inherit;;inherit>2160p25</font>
-Description: Relative filename for TSFILE or AUX file recording. Note that "fprefix" does NOT include the absolute media path – the "storage" parameter is the proper place to specify the absolute media path.
+<font 10px/inherit;;inherit;;inherit>1080p60</font>
-==== storage ====
+<font 10px/inherit;;inherit;;inherit>1080p5994</font>
-Absolute path to mounted media device (e.g. /media/sda1/)
+<font 10px/inherit;;inherit;;inherit>1080p50</font>
-==== telopcharsize ====
+<font 10px/inherit;;inherit;;inherit>720p60</font>
-OSD overlay text character size in pixels
+<font 10px/inherit;;inherit;;inherit>720p5994</font>
-Possible values: 16, 32, or 64
+<font 10px/inherit;;inherit;;inherit>720p50</font>
-==== telopenable ====
+<font 10px/inherit;;inherit;;inherit>480p60</font>
-Enable or disable telop (i.e. OSD overlay of text).
+<font 10px/inherit;;inherit;;inherit>576p50</font>
-Possible values: on, off
+<font 10px/inherit;;inherit;;inherit>2560x1600_60</font>
-==== teloplocation ====
+<font 10px/inherit;;inherit;;inherit>2560x1440_30</font>
-Where to overlay text in the encoded video
+<font 10px/inherit;;inherit;;inherit>1920x1200_60</font>
-Possible values: top_left top_right top_center bottom_left bottom_right bottom_center
+<font 10px/inherit;;inherit;;inherit>auto</font>
-==== teloptext ====
+<font 10px/inherit;;inherit;;inherit>auto_pal</font>
-Text string for OSD overlay
+<font 10px/inherit;;inherit;;inherit>auto_ntsc_bcast</font>
-==== vgopsize ====
+==== layout ====
-Description: Distance between I frames (key frames) in GOP sequence
+Description:
-Possible values: 1 through 240
+Possible values: 1x1, 2x2
-==== vbitrate ====
-Description: Video bitrate in bits per second.
-Possible values: A "K" suffix indicates kilobits (thousands of bits/second).
-A "M" suffix indicates megabits (millions of bits/second).
-Note: In UDP transport stream case, the tsrate should be set
-higher than the vbitrate, with at least 15% margin.
-==== vdelay ====
-Description: Video maximum burst size in milliseconds.
-Possible values: 100 to 2000
-==== vdest ====
-Description: Destination URL address for encoded bitstream. May be interpreted differently depending on "vprotocol" setting.
-For UDP and RTP transports:
-client_ip:client_port
-For RTMP transport:
-<code>
- server_ip[:server_port]/application/streamname
-</code>
-==== vframeratediv ====
-Description: Divide video input frame rate by this number to get encode frame rate.\\
-The encoder will discard (frameratediv-1) out of (frameratediv) frames.\\
-\\
-Possible values: 1, 2, 3, 4, 5, 6
-==== vgdr ====
-Description: Enable or disable Gradual Data Refresh. Reduces I-frame size (reduces latency). At lower bitrates, a horizontal rolling artifact may be visible.
-Possible values: on, off
-==== vcodec ====
-Description: Specifiec which codec to encode with.
-Possible values: h265, h264, mjpeg
-==== vprofile ====
-Description: H.264 profile (see [[https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Profiles|https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Profiles]] for full description)
-Possible values: baseline, main, high
-==== vprotocol ====
-Description: Protocol used to transport the encoded bitstream.
-Possible values: rtp, rtmp, udp, asi, tsfile, mts, tsrtp
-==== vquality ====
-Description: Set balance between low latency, and higher quality bitrate compliance.
-Possible values: lowlat, balanced, high
-==== vratectrl ====
-Description: Rate control mode for encoder.
-Possible values: cbr, vbr
-vbr mode may be burstier than cbr.
-==== vres ====
-Description: Video resolution
-Possible values: follow_input preserve video source resolution, no resize
-<code>
-               WxH           resize to width W and height H
-</code>
-==== vsource ====
-Description: Video input from which encoder will source its video
-<font 12.8000001907349px/arial;;#000000;;#ffffff>Possible values: Board-dependent</font>
-==== pipenable ====
-Description: Enable PIP of channel 2 on channel 1 encode. Only available on FV4K/FV2K/FSDI
-Possible values: on, off
-==== piplocaton ====
-Description: Sets the location of the PIP on channel one. Only available on FV4K/FV2K/FSDI
-Possible values: top_left, top_right, bottom_left, bottom_right
-==== vinterlacemode ====
-Description: Sets the interlaced mode for the video input
-Possible values: combined, separated (H265 only)
-==== vmulticastdest ====
-Description: video multicast destination for RTSP. Used by ONVIF StartMulticast/StopMulticast functions
-Possible values: valid multicast addresses
-==== amulticastdest ====
-Description: audio multicast destination for RTSP. Used by ONVIF StartMulticast/StopMulticast functions
-Possible values: valid multicast addresses
-==== rtsp_auth_enable ====
-Description: enables/disables rtsp authorization for stream
-Possible values: on, off
-==== rtsp_auth_username ====
-Description: username for rtsp authorization
-Possible values: alpha numeric string
-==== rtsp_auth_password ====
-Description: password for rtsp authorization
-Possible values: *
-===== Transport Stream Parameters =====
-The following parameters only apply to transport stream encoding (transport is set to udp, asi, tsfile, mts, or tsrtp).
-==== vpid ====
-Description: Video PID for transport stream.
-Possible values: 32 to 8191 – must not conflict with other PID assignments
-==== apid ====
-Description: Audio PID for transport stream.
-Possible values: 32 to 8191 – must not conflict with other PID assignments
-==== pcrpid ====
-Description: PCR PID for transport stream.
-Possible values: 32 to 8191 – must not conflict with other PID assignments
-==== pmtpid ====
-Description: PMT PID for transport stream.
-Possible values: 16 to 31 – must not conflict with other PID assignments
-==== tsrate ====
-Description: Transport stream total transport rate in bits per second.
-Possible values: The 'K' suffix indicates kilobits (thousands of bits/second). The 'M' suffix indicates megabits (millions of bits/second).
-Note: In UDP transport stream case, the tsrate should be set higher than the vbitrate, with at least 15% margin.
-==== tslowlat ====
-Description: Low latency transport stream mode (VBR).
-Possible values: off, on
-==== auxonoff ====
-Describe: Enable AUXillary file recording in UDP mode – allows simultaneous UDP streaming and TS file recording on the same channel. Only valid if transport is UDP and tslowlat is off
-The path to storage is set by the "storage" parameter.
-The filename is set by the "fprefix" parameter. The default value is "MOV1_%F_%T". The "%F" specifier inserts a date stamp, and the "%T" specifier inserts a time stamp.
-The recording file size is set by the "filesize" parameter. When the file reaches this size, a new file will be created.
-==== klvbrate ====
-Description: Bitrate to allocate in transport stream for KLV data.
-==== klvenable ====
-Description: Enable KLV capture from SDI, if supported.
-Possible values: off, on
-==== klvpid ====
-Description: PID for KLV data in transport stream
-==== klvsrc ====
-Description: Source device for KLV metadata
-==== pcrinterval ====
-Description: Interval between PCR packets in milliseconds.
-Possible values: 30 - 100
 ===== Global Configuration =====
@@ Line 911: / Line 684: @@
 Encoder channel to apply dynamic command to.
-<font 12.8px/Arial, sans-serif;;#000000;;inherit font-family: Arial, sans-serif; font-weight: bold; font-size: 12.8px;>var</font>
-Variable to modify dynamically. Possible values: vratediv, vrate, gop, analog_gain, telop_text, pip_enable, pip_location, startmulticast, stopmulticast
-=== val ===
 Value to set dynamic variable to.
@@ Line 1045: / Line 812: @@
 </code>
 ==== asamplerate ====
 Description: Audio sample rate
 Possible values: 48000, 44100
 ==== asource ====
 Description: Select audio input
 Possible values: MICL (microphone, line input levels)
+<code>
-<code>
                MIC    (unpowered microphone levels)
                HDMI   (microHDMI input, for HE4K-DCK only)
                HD-SDI (SDI input, for DME-10/FSDI-DCK only)
 </code>
 ==== apid ====
 Description: Audio PID for transport stream.
 Possible values: 32 to 8191 - must not conflict with other PID assignments.
 ==== aport ====
 Description: Destination UDP port for RTP audio
 ==== aptspcr ====
 Description: For transport stream modes only – intial PTS to PCR offset for audio, in milliseconds
 Possible values: 100 to 2000
 ==== auth_passwd ====
 Description: Password for RTMP authentication.
 ==== auth_user ====
 Description: Username for RTMP authentication.
 ==== authonoff ====
 Description: Enable or disable RTMP authentication. Default: off Possible values: on, off
 ==== channel ====
 Description: Encoder channel number
 Possible values: 1, 2, 3
 ==== feccol ====
 Description: Column count for ProMPEG.
 Possible values: integer greater than 1
 ==== feconoff ====
 Description: Enable ProMPEG if supported.
 Possible values: on, off
 ==== fecrow ====
 Description: Row count for ProMPEG.
 Possible values: integer greater than 1
 ==== filesize ====
 Description: Size of TSFILE or AUX file recording, in bytes.
 A "K" suffix indicates kilobytes (thousands of bytes/second).
 A "M" suffix indicates megabytes (millions of bytes/second).
 ==== fprefix ====
 Description: Relative filename for TSFILE or AUX file recording. Note that "fprefix" does NOT include the absolute media path – the "storage" parameter is the proper place to specify the absolute media path.
 ==== storage ====
 Absolute path to mounted media device (e.g. /media/sda1/)
 ==== telopcharsize ====
 OSD overlay text character size in pixels
 Possible values: 16, 32, or 64
 ==== telopenable ====
 Enable or disable telop (i.e. OSD overlay of text).
 Possible values: on, off
 ==== teloplocation ====
 Where to overlay text in the encoded video
 Possible values: top_left top_right top_center bottom_left bottom_right bottom_center
 ==== teloptext ====
 Text string for OSD overlay
 ==== vgopsize ====
 Description: Distance between I frames (key frames) in GOP sequence
 Possible values: 1 through 240
 ==== vbitrate ====
 Description: Video bitrate in bits per second.
 Possible values: A "K" suffix indicates kilobits (thousands of bits/second).
 A "M" suffix indicates megabits (millions of bits/second).
 Note: In UDP transport stream case, the tsrate should be set
 higher than the vbitrate, with at least 15% margin.
 ==== vdelay ====
 Description: Video maximum burst size in milliseconds.
 Possible values: 100 to 2000
 ==== vdest ====
 Description: Destination URL address for encoded bitstream. May be interpreted differently depending on "vprotocol" setting.
 For UDP and RTP transports:
 client_ip:client_port
 For RTMP transport:
 <code>
  server_ip[:server_port]/application/streamname
 </code>
 ==== vframeratediv ====
+Description: Divide video input frame rate by this number to get encode frame rate.\\
-Description: Divide video input frame rate by this number to get encode frame rate.\\
+The encoder will discard (frameratediv-1) out of (frameratediv) frames.\\
-The encoder will discard (frameratediv-1) out of (frameratediv) frames.\\
+\\
-\\
 Possible values: 1, 2, 3, 4, 5, 6
 ==== vgdr ====
 Description: Enable or disable Gradual Data Refresh. Reduces I-frame size (reduces latency). At lower bitrates, a horizontal rolling artifact may be visible.
 Possible values: on, off
 ==== vcodec ====
 Description: Specifiec which codec to encode with.
 Possible values: h265, h264, mjpeg
 ==== vprofile ====
 Description: H.264 profile (see [[https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Profiles|https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Profiles]] for full description)
 Possible values: baseline, main, high
 ==== vprotocol ====
 Description: Protocol used to transport the encoded bitstream.
 Possible values: rtp, rtmp, udp, asi, tsfile, mts, tsrtp
 ==== vquality ====
 Description: Set balance between low latency, and higher quality+bitrate compliance.
 Possible values: lowlat, balanced, high
 ==== vratectrl ====
 Description: Rate control mode for encoder.
 Possible values: cbr, vbr
 vbr mode may be burstier than cbr.
 ==== vres ====
 Description: Video resolution
 Possible values: follow_input preserve video source resolution, no resize
+<code>
+               WxH           resize to width W and height H
-<code>
-               WxH           resize to width W and height H
 </code>
 ==== vsource ====
 Description: Video input from which encoder will source its video
+<font 12.8000001907349px"><font inherit/arial;;inherit;;#ffffff>Possible values: Board-dependent</font>
-<font 12.8000001907349px/arial;;#000000;;#ffffff>Possible values: Board-dependent</font>
 ==== pipenable ====
 Description: Enable PIP of channel 2 on channel 1 encode. Only available on FV4K/FV2K/FSDI
 Possible values: on, off
 ==== piplocaton ====
 Description: Sets the location of the PIP on channel one. Only available on FV4K/FV2K/FSDI
 Possible values: top_left, top_right, bottom_left, bottom_right
 ==== vinterlacemode ====
 Description: Sets the interlaced mode for the video input
 Possible values: combined, separated (H265 only)
 ==== vmulticastdest ====
 Description: video multicast destination for RTSP. Used by ONVIF StartMulticast/StopMulticast functions
 Possible values: valid multicast addresses
 ==== amulticastdest ====
 Description: audio multicast destination for RTSP. Used by ONVIF StartMulticast/StopMulticast functions
 Possible values: valid multicast addresses
 ==== rtsp_auth_enable ====
 Description: enables/disables rtsp authorization for stream
 Possible values: on, off
 ==== rtsp_auth_username ====
 Description: username for rtsp authorization
 Possible values: alpha numeric string
 ==== rtsp_auth_password ====
 Description: password for rtsp authorization
 Possible values: *
 ===== Transport Stream Parameters =====
 The following parameters only apply to transport stream encoding (transport is set to udp, asi, tsfile, mts, or tsrtp).
 ==== vpid ====
 Description: Video PID for transport stream.
 Possible values: 32 to 8191 – must not conflict with other PID assignments
 ==== apid ====
 Description: Audio PID for transport stream.
 Possible values: 32 to 8191 – must not conflict with other PID assignments
 ==== pcrpid ====
 Description: PCR PID for transport stream.
 Possible values: 32 to 8191 – must not conflict with other PID assignments
 ==== pmtpid ====
 Description: PMT PID for transport stream.
 Possible values: 16 to 31 – must not conflict with other PID assignments
 ==== tsrate ====
 Description: Transport stream total transport rate in bits per second.
 Possible values: The 'K' suffix indicates kilobits (thousands of bits/second). The 'M' suffix indicates megabits (millions of bits/second).
 Note: In UDP transport stream case, the tsrate should be set higher than the vbitrate, with at least 15% margin.
 ==== tslowlat ====
 Description: Low latency transport stream mode (VBR).
 Possible values: off, on
 ==== auxonoff ====
 Describe: Enable AUXillary file recording in UDP mode – allows simultaneous UDP streaming and TS file recording on the same channel. Only valid if transport is UDP and tslowlat is off
 The path to storage is set by the "storage" parameter.
 The filename is set by the "fprefix" parameter. The default value is "MOV1_%F_%T". The "%F" specifier inserts a date stamp, and the "%T" specifier inserts a time stamp.
 The recording file size is set by the "filesize" parameter. When the file reaches this size, a new file will be created.
 ==== klvbrate ====
 Description: Bitrate to allocate in transport stream for KLV data.
 ==== klvenable ====
 Description: Enable KLV capture from SDI, if supported.
 Possible values: off, on
 ==== klvpid ====
 Description: PID for KLV data in transport stream
 ==== klvsrc ====
 Description: Source device for KLV metadata
 ==== pcrinterval ====
 Description: Interval between PCR packets in milliseconds.
 Possible values: 30 - 100
 ===== Global Configuration =====
 ----
 ===== Action Syntax =====
 ===== Generic Actions (POST) =====
 Python example code for starting/stopping all channels:
 <code>
@@ Line 1586: / Line 1190: @@
     headers={'Content-Type':'application/x-www-form-urlencoded; charset=UTF-8'}
     r = requests.post(control_cgi_url, data=payload, headers=headers)
     print r.text
 </code>
 The "loadfromdb=true" parameter will load the current settings from the database.
 If you omit the loadfromdb parameter, *none* of the database settings will be used – any parameters you do not supply, will be set to default values.
 For example, this is what a StartChannel request from the web server looks like:
 <code>
 action=StartChannel&chn=1&vsource=&vres=follow_input&vcodec=h265&vgdr=on&vprofile=high&vratectrl=cbr&vbitrate=2M&vframeratediv=1&vgopsize=60&vprotocol=rtsp&vdest=192.168.0.6:8600&storage=&fprefix=MOV1_%F_%T_&vpid=221&vdelay=1000&pcrpid=521&pcrinterval=50&pmtpid=31&tsrate=3000K&tslowlat=on&feconoff=off&fecrow=1&feccol=5&zixioverhead=15&zixiauthen=off&zixisession=test&zixiuser=user&aenable=on&asource=MICL&acodec=fdk_aaclc&abitrate=128000&asamplerate=48000&aport=8700&apid=120&aptspcr=250&klvenable=off&klvmode=sdi&klvsrc=/dev/gv7601.0&klvpid=35&klvbrate=1000&authonoff=off&auth_user=user&auth_passwd=password&auxonoff=off&filesize=1024M&telopenable=off&teloptext=ENCDEV&teloplocation=top_left&telopcharsize=32&vquality=balanced
 </code>
 ==== StartChannel ====
+\\
-\\
 Transition the encoder channel into the running state.
+Once you start the channel, it will not transmit data until the\\
-Once you start the channel, it will not transmit data until the\\
 video input is detected.
 ==== StopChannel ====
 Transition the encoder channel into the stopped state.
 ==== SaveUser ====
 Save current settings to non-volatile memory, so they will be used on the next startup.
 ==== RestartBoard ====
 Reboot the board
 ==== PtzContinuousMove ====
 Pan to the left at half speed
-    action=PtzContinuousMove&data={"PanTilt":{"x":-0.5,"y":0},"idx":0}
+<code>
+  action=PtzContinuousMove&data={"PanTilt":{"x":-0.5,"y":0},"idx":0}
+</code>
 Pan to the right at half speed
-    action=PtzContinuousMove&data={"PanTilt":{"x":0.5,"y":0},"idx":0}
+<code>
+  action=PtzContinuousMove&data={"PanTilt":{"x":0.5,"y":0},"idx":0}
+</code>
 Tilt down at max speed
-    action=PtzContinuousMove&data={"PanTilt":{"x":0,"y":1},"idx":0}
+<code>
+  action=PtzContinuousMove&data={"PanTilt":{"x":0,"y":1},"idx":0}
+</code>
 ==== PtzStop ====
@@ Line 1650: / Line 1253: @@
 Stop pan and tilt
-    action=PtzStop&data={"mode":1,"idx":0}
+<code>
+  action=PtzStop&data={"mode":1,"idx":0}
+</code>
 ==== CameraControl ====
@@ Line 1837: / Line 1442: @@
 The values accepted are either 1 or 2
 ==== SaveCamera ====
 Save camera-related settings below.
 === zoom_direct_value ===
 Description: Set camera zoom
 Possible values: 0 (wide) to 0x7ac0 (full zoom)
 === white_balance_mode ===
 Possible values: auto. indoor, outdoor, onepush, autotrace, manual, outdoor_auto,
 <code>
                sodium_lamp_auto, sodium_lamp_fixed, sodium_lamp_outdoor
 </code>
 === color_gain ===
 Possible values: Range from 0 (60%) to 14 (200%)
 === color_hue ===
 Possible values: Range from 0 (60%) to 14 (200%)
 === chroma_suppress ===
 Possible values: 0=none, 1, 2, 3
 === wb_manual_rgain_direct ===
 Possible values: 0 to 255
 === wb_manual_bgain_direct ===
 Possible values: 0 to 255
 === optical_zoom_only ===
 Possible values: 0, 1
 === focus_direct_value ===
 Description: Set manual camera focus distance Possible values: 0x1000 to 0xf000
 === manual_focus ===
 Description: Set focus mode
 Possible values: auto, manual
 ==== SetIp ====
 === local_ip ===
 IPv4 adresss
 === local_netmask ===
 IPv4 netmask
 === default_gw ===
 IPv4 default gateway
 === local_dnsip ===
 DNS server primary
 === local dnsip2 ===
 DNS server secondary
 === do_autostart ===
 Control automatic stream start after bootup
 Possible values: 1 = do autostart 0 = do not autostart
 === enc_adv_setting ===
 Control appearance of advanced settings on WebUI
 Possible values: off, on
 ==== SetDisplay ====
 Controls composite output (passthru video from camera)
 === disp_std ===
 Set display standard for composite output
 Possible values; auto, ntsc, pal
 ==== UpdateTerm ====
 Control serial port terminal server for VISCA
 === term_mode ===
 Possible values: client, server
 === term_protocol ===
 Possible values: clearchannel, telnet
 === term_localport ===
 Local TCP port (for server mode)
 === term_servaddr ===
 Remote IP address (for client mode only)
 === term_servport ===
 Remote TCP port (for client mode only)
 === term_baudrate ===
 Possible values: 9600, 19200, 38400, 57600, 115200
 === term_devicefile ===
 ==== Overlay ====
 Add/Update overlay
 === chn ===
 Encoder channel to add overlay to.
 === rgn_idx ===
 Index to map overlay to.
 === type ===
 Type of overlay to be used possible values: text or png.
 === source ===
 In the case of text overlay this would be the source text for png overlay this is the path to the png on the encoder. Images must be uploaded to board to be used.
 === location ===
 This is the location of the overlay. Possible values: 'top_left', 'top_right', 'top_center', 'bottom_left', 'bottom_right', 'bottom_center', 'x,y' (negative numbers not supported for x or y)
 === char_size ===
 For text overlay this is the character size. Possible values: 16,32,64
 === layer ===
 This will set the layer for the overly higher numbers will overlay over lower numbers if overlapping.
 === alpha ===
 Sets the transparency of the text. Possible values: 0-255
 ==== OverlayStop ====
 === chn ===
 Encoder channel to remove overlay from.
 === rgn_idx ===
 Index of overly for this channel.
 ==== Dynamic ====
 === chn ===
 Encoder channel to apply dynamic command to.
 <font 12.8px/Arial, sans-serif;;#000000;;inherit font-family: Arial, sans-serif; font-weight: bold; font-size: 12.8px;>var</font>
 Variable to modify dynamically. Possible values: vratediv, vrate, gop, analog_gain, telop_text, pip_enable, pip_location, startmulticast, stopmulticast
 === val ===
 Value to set dynamic variable to.
 ==== SetSNTP ====
 === enable ===
 Enable/Disable SNTP.
 === servers ===
 NTP server or list of NTP servers.
 === timezone ===
 Linux TZ database value for Timezone.
 ==== SetOnvif ====
 === enable ===
 Enable/Disable ONVIF.
 === fixed_profile_max ===
 Maximum ONVIF profiles to allow (1 or 2).
 ==== SetTermSrvEnable ====
 === termserve_remote_enable ===
 Enable/Disable remote access to terminal server.
 ==== SetZFinderEnable ====
 === zfinder_enable ===
 Enable/Disable zfinder support.
 ===== Encoder Actions (POST) =====
 ==== SetEncoder ====
 Write encoder settings to active preset. See Python example code for Seting Configuration below
 ==== EncoderStatus ====
 Requests an update to encoder_status_str variable.
+To read the result, you need to POST the “stats” control as shown<nowiki>\</nowiki> in the Python example code below.
-To read the result, you need to POST the “stats” control as shown%%\%% in the Python example code below.
 ==== StreamStatus ====
 Requests an update to stream_status_str variable.
+To read the result, you need to POST the “stats” control as shown<nowiki>\</nowiki> in the Python example code below.
-To read the result, you need to POST the “stats” control as shown%%\%% in the Python example code below.
 ==== AStreamStatus ====
 Requests an update to astream_status_str variable.
+To read the result, you need to POST the “stats” control as shown<nowiki>\</nowiki> in the Python example code below.
-To read the result, you need to POST the “stats” control as shown%%\%% in the Python example code below.
 ==== SourceStatus ====
 Requests an update to source_status_str variable.
+To read the result, you need to POST the “stats” control as shown<nowiki>\</nowiki> in the Python example code below.
-To read the result, you need to POST the “stats” control as shown%%\%% in the Python example code below.
 ----
 ===== Setting Encoder Configuration =====
 To set the encode configuration per channel the **SetEncoder** action is used with a post. All variables should be present or they will be replaced with a defualt that may not be valid for your application. More than one channel can be set per command. It is recommended you first read the current settings from the encoder then modify them and send the new settings back as in the Python example below:
@@ Line 2244: / Line 1722: @@
 print new_cfg
 requests.post(server_url, data=new_cfg)
 </code>
 ===== Reading Statistics =====
 Python example of updating and reading encoder statistics:
 <code>
@@ Line 2264: / Line 1740: @@
 print requests.get(server_url, params='ctrl=stats&chn=').json()
 </code>
 Example output:
 <code>
@@ Line 2278: / Line 1753: @@
  u'source_status_str': u'+CAMERA 1920x1080p 60.00 fps +OK',
  u'stream_status_str': u'Channel 1 URL rtsp Frames 11524 +OK'}
 </code>

Wiki

User Tools

Site Tools

Differences

Page Tools