Open topic with navigation

# 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

© 2018 Micro Focus or one of its affiliates | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm