Configuring the Universal Driver
In order for the Universal driver to receive video/audio it needs to know the Retrieval Mode, URI, codec and port.
General settings
Setting Name |
Possible values |
Description |
---|---|---|
Include URI options on PLAY |
Yes No |
Controls whether to include query parameters in the URL used for RTSP PLAY command. If “No” the query parameters (everything after “?”) in the Connection URI will be stripped before issuing the RTSP PLAY command. |
HTTPS Enabled |
No Yes |
Used only when HTTP or RTSP/RTP/HTTP/TCP streaming is selected. No – Default value. Connection with the device will be established on the HTTP port during device add. Yes – Connection with the device will be established over HTTPS using the HTTPS port. |
HTTPS Port |
1-65535 |
Used only when HTTPS Enabled is set to Yes. Defines the HTTPS port to be used. Default value is 443. |
HTTPS Validate Certificate |
No Yes |
Used only when HTTPS Enabled is set to Yes. No – Default value. The driver will not check the validity of the certificate. Yes – The driver will check the validity of the certificate of the device it is connecting to. If the certificate cannot be verified (is expired or the certificate chain does not lead to a trusted root), the connection will be dropped. |
HTTPS Validate Hostname |
No Yes |
Used only when HTTPS Enabled is set to Yes. No – Default value. The driver will not check the validity of the hostname. Yes –The driver will check whether the hostname of the device it’s connecting to matches the ones the certificate is issued to. |
Video Channel settings
Setting Name |
Possible values |
Description |
---|---|---|
Delivery Mode |
Multipart Stream Non Multipart Stream |
Used only when HTTP streaming is selected. Controls whether to use HTTP multipart data transfer (see https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html) |
Keep Alive type |
Default OPTIONS OPTIONS (no URL) GET_PARAMETER RTCP Never |
Used only when RTSP streaming is selected. Defines what type of RTSP connection keep alive should be used. Default – selected by the driver as the most appropriate. OPTIONS – RTSP OPTIONS command will be send by the driver periodically. OPTIONS (no URL) – RTSP OPTIONS command without URL will be send by the driver periodically. GET_PARAMETER – RTSP GET_PARAMETER command will be send by the driver periodically. RTCP – Driver will send RTCP client messages. Never – do not use keep alive. The selection for this setting depends on the requirements of the device. If you experience periodic interruptions and reconnections of the stream (once every 30 seconds to once every 5 minutes) try changing this setting. |
Retrieval Mode |
Streaming Snapshot |
Streaming – RTSP streaming or HTTP streaming will be used. Snapshot – JPEG snapshot will be used to retrieve frames. |
Codec |
MJPEG MPEG-4 H264 H265 |
The codec of the incoming video that the driver should expect. This should match the codec selected on the device for the video stream. Can be checked on device’s Web Page or using VLC (see Testing with VideoLan Player (VLC)) |
Connection URI |
URI to be used for establishing a video stream or to request JPEG snapshots. NOTE: the URI must be without the IP/hostname, port and the first slash (“/”) of the URL. Example: If the URL of the video stream for the device is: “rtsp://192.168.0.10:5544/channel1/stream1” then the URI should be set as: “channel1/stream1” (without the quotes) The IP/hostname and port will be taken from the settings. |
|
Frames per second |
0.00028 - 60 |
Used only when the JPEG Snapshot mode is selected. Controls the interval at which to poll the device for JPEGs. Examples: 60 – poll the device 60 times per second 1 – poll the device once every second 0.1 – poll the device once every 10 seconds 0.00028 – poll the device once every hour |
RTSP Port |
1 - 65535 |
Used only if RTSP streaming mode is selected. Sets the RTSP port to be used when connecting to the device. |
Streaming Mode |
RTP/UDP RTP/RTSP/TCP HTTP RTP/UDP multicast RTP/RTSP/HTTP/TCP |
Used only when “Streaming” is selected for Retrieval Mode. RTP/UDP – RTSP will be used and during RTSP SETUP UDP unicast RTP transfer will be requested from the device. RTP/RTSP/TCP - RTSP will be used and during RTSP SETUP TCP unicast interleaved RTP transfer will be requested from the device. HTTP – HTTP streaming mode will be used. The driver will issue a HTTP GET command and will expect in response to get the video data. If HTTPS is enabled, the HTTPS port will be used. RTP/UDP multicast - RTSP will be used and during RTSP SETUP UDP multicast RTP transfer will be requested from the device. RTP/RTSP/HTTP/TCP – RTSP will be used and tunneled through the HTTP port. If HTTPS is enabled, the HTTPS Port will be used. |
Audio Channel settings
Setting Name |
Possible Values |
Description |
---|---|---|
Delivery Mode |
Multipart Stream Non Multipart Stream |
Used only when HTTP streaming is selected. Controls whether to use HTTP multipart data transfer (see https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html) |
Keep Alive type |
Default OPTIONS OPTIONS (no URL) GET_PARAMETER RTCP Never |
Used only when RTSP streaming is selected. Defines what type of RTSP connection keep alive should be used. Default – selected by the driver as the most appropriate. OPTIONS – RTSP OPTIONS command will be send by the driver periodically. OPTIONS (no URL) – RTSP OPTIONS command without URL will be send by the driver periodically. GET_PARAMETER – RTSP GET_PARAMETER command will be send by the driver periodically. RTCP – Driver will send RTCP client messages. Never – do not use keep alive. |
Audio Codec |
PCM RAW PCM mju-law PCM A-law G.711 mju-law G.711 A-law G.721 32 kbps Little-Endian G.721 32 kbps Big-Endian G.723 24 kbps Little-Endian G.723 40 kbps Little-Endian G.723 24 kbps Big-Endian G.723 40 kbps Big-Endian G.726 16 kbps Little-Endian G.726 24 kbps Little-Endian G.726 32 kbps Little-Endian G.726 40 kbps Little-Endian G.726 16 kbps Big-Endian G.726 24 kbps Big-Endian G.726 32 kbps Big-Endian G.726 40 kbps Big-Endian AAC |
The codec of the incoming audio that the driver should expect. |
Connection URI |
URI to be used for establishing an audio streaming connection. NOTE: the URI must be without the IP/hostname, port and the first slash (“/”) of the URL. Example: If the URL of the audio stream for the device is: “rtsp://192.168.0.10:5544/channel1/audio1” then the URI should be set as: “channel1/audio1” (without the quotes) The IP/hostname and port will be taken from the settings. |
|
RTSP Port |
1 - 65535 |
Used only if RTSP streaming mode is selected. Sets the RTSP port to be used when connecting to the device. |
Streaming Mode |
RTP/UDP RTP/RTSP/TCP HTTP RTP/UDP Multicast RTP/RTSP/HTTP/TCP |
Used only when “Streaming” is selected for Retrieval Mode. RTP/UDP – RTSP will be used and during RTSP SETUP UDP unicast RTP transfer will be requested from the device. RTP/RTSP/TCP - RTSP will be used and during RTSP SETUP TCP unicast interleaved RTP transfer will be requested from the device. HTTP – HTTP streaming mode will be used. The driver will issue a HTTP GET command and will expect in response to get the audio data. If HTTPS is enabled, the HTTPS port will be used. RTP/UDP multicast - RTSP will be used and during RTSP SETUP UDP multicast RTP transfer will be requested from the device. RTP/RTSP/HTTP/TCP – RTSP will be used and tunneled through the HTTP port. If HTTPS is enabled, the HTTPS Port will be used. |
Configurations for different stream types:
RTSP/RTP over UDP |
|
---|---|
Retrieval Mode |
Streaming |
Codec |
MJPEG, MPEG4, H264 or H265 |
Streaming Mode |
RTP/HTTP |
RTSP/RTP over TCP |
|
---|---|
Retrieval Mode |
Streaming |
Codec |
MJPEG, MPEG4, H264 or H265 |
Streaming Mode |
RTP/RTSP /TCP |
RTSP/RTP over multicast |
|
---|---|
Retrieval Mode |
Streaming |
Codec |
MJPEG, MPEG4, H264 or H265 |
Streaming Mode |
RTP/UDP multicast |
HTTP streaming |
|
---|---|
Retrieval Mode |
Streaming |
Delivery Mode |
“Multipart Stream” or “Non Multipart Stream” |
Codec |
MJPEG, MPEG4, H264 or H265 |
Streaming Mode |
HTTP |
JPEG Snapshots |
|
---|---|
Retrieval Mode |
Snapshot |
Codec |
MJPEG |
Frames per second |
Needed snapshot interval |
Streaming Mode |
HTTP |
RTSP over HTTP |
|
---|---|
Retrieval Mode |
Streaming |
Codec |
MJPEG, MPEG4, H264 or H265 |
Streaming Mode |
RTP/RTSP/HTTP /TCP |
RTSP over HTTPS |
|
---|---|
Retrieval Mode |
Streaming |
Codec |
MJPEG, MPEG4, H264 or H265 |
Streaming Mode |
RTP/RTSP/HTTP /TCP |
HTTPS Enabled |
Yes |
HTTPS Validate Certificate |
Yes* |
HTTPS Validate Hostname |
Yes* |
*Note: For testing purposes only “HTTPS Validate Certificate” and “HTTPS Validate Hostname” can be disabled.
Note: All configurations except “JPEG Snapshot” are valid for audio streaming as well.