ConfigInput

The ConfigInput action configures video sources to be ingested by Video Management Server. You can use this action to configure a new video source or stop processing an existing source.

Parameter Description
Input The input to configure. VMS can process up to 16 video inputs. Specify an integer from 0 to 15.
Enable

A Boolean that specifies whether the input is added or deleted. To add a new input, use True. To stop processing an existing input, use False.

SourceType

The type of video source that you want to add.

  • MPEG2TS - MPEG-2 Transport Stream.
  • RTSP - Real Time Streaming Protocol. Many IP cameras and network encoders provide an RTSP service. If your device supports RTSP output, Micro Focus recommends that you ingest video from this service.
  • MJPEG - MJPEG over HTTP.
Source The URL of the source.
StoragePassword (Optional, but you must set both StorageUsername and StoragePassword, or neither) The password that a media player must provide when you enable authentication for requests to the VMS RTSP server.
StorageUsername (Optional, but you must set both StorageUsername and StoragePassword, or neither) The user name that a media player must provide when you enable authentication for requests to the VMS RTSP server.

Additional Action Parameters for adding new a MPEG2TS Input

Name Description
MPEG2TSPID The ID of a specific program in the transport stream. If you do not set this parameter, VMS ingests the first program detected in the stream.
AudioLanguage A three-character language code that specifies the audio stream to use. VMS uses the language codes defined by ISO 639 part 2. If you do not specify this parameter, VMS uses the first audio stream it detects that is associated with the program.
IgnoreDTS A Boolean that specifies whether decoding timestamps are ignored. To ignore decoding timestamps, set this parameter to True. Use this parameter if you require only the video and metadata, or if the stream contains an audio stream where the codec is not supported by VMS.

Additional Action Parameters for adding a new RTSP Input

Name Description
RTSPTransport

To use a TCP connection for receiving the video stream, rather than a UDP connection, set this parameter to TCP.

This can prevent packet loss between the camera and VMS, but might introduce latency when packets are retransmitted. This in turn can lead to the camera reducing its frame rate to compensate for the latency. Use this parameter with caution.

Username The user name and password (if required by the camera). VMS supports basic and digest authentication.
Password

Additional Action Parameters for adding a new MJPEG Input

Name Description
Username The user name and password (if required by the camera).
Password

Examples

To configure an MPEG2TS input with a single program transport stream:

http://localhost:15000/a=ConfigInput
                            &Input=0
                            &SourceType=MPEG2TS
                            &Source=udp://225.0.0.1:5000
                            &Enable=true

To configure an MPEG2TS input with a multi-program transport stream:

http://localhost:15000/a=ConfigInput
                            &Input=0
                            &SourceType=MPEG2TS
                            &Source=udp://239.255.1.43:1234?resuse=1
                            &MPEG2TSPID=6304
                            &AudioLanguage=eng
                            &Enable=true

To configure an RTSP input:

http://localhost:15000/a=ConfigInput
                            &Input=0
                            &SourceType=RTSP
                            &Source=rtsp://10.2.104.114/mpeg4/1/media.amp
                            &Enable=true

Remove an Existing Input

Remove a video input when you no longer want to ingest video from a camera. Removing a video source does not erase any data from the associated storage area. However, VMS will begin overwriting data as soon as a new camera is configured.

http://localhost:15000/a=ConfigInput
                            &Input=7
                            &Enable=False

_FT_HTML5_bannerTitle.htm