Documentation for Intellect 4.11.0-4.11.3. Documentation for other versions of Intellect is available too.

Previous page Updating the push notifications certificate for Intellect 4.11.1 and earlier versions  Counting the system events Next page


On the page:

General info

The RTSP Server object is used for transmitting video from Server to remote workplaces using the RTSP protocol. Use of the RTSP protocol allows viewing video from IP cameras and video archive on remote clients by means of the Intellect software or using video players that support this protocol. Transmitting Video gate archive and Backup archive is also supported.

If there is sound with live video or the archive is recorded with sound, then video broadcast with sound through RTSP Server is supported—for this specify the ID of microphone from which the archive is recorded when requesting video (see the table with requests examples). For proper operation of this feature set the VLC media player compatibility mode checkbox checked in VLC Media Player (see item 14).

Attention!

Transmitted video stream is to be compressed using H.264, H.265, MPEG4 or MJPEG codecs.

When MJPEG codec is in use, video of height and/or width more than 2048 pixels is not supported.

The client is to reconnect to URL when the codec is changed.

To view the archive via RTSP Server, the archive should be recorded in the same codec. Otherwise, the archived video will not play.

It is to be taken into account that while configuring each rtsp Server loads only one CPU core. To increase the number of rtsp streams several rtsp Server objects are to be created and configured on several cameras. Each RTSP Server entity runs in a separate system process (StreamingServer.run).

Note

All the ports mentioned below are specified using only natural numbers.


Creating the RTSP Server object 

Create the RTSP Server object as follows:

  1. In the context menu of the Computer object select Create object → RTSP Server.
  2. Specify the name and ID of the object in the opened panel.
  3. Click the Apply button to create the object.

Configuring the Unicast mode

  1. Open the settings panel for the RTSP Server object. For this select the created object in the Intellect objects tree.

  2. In the Cameras table set the checkboxes next to video cameras video from which is to be displayed (1). If camera has several streams, the default stream is broadcasted.

    Note.

    If default stream is changed on the corresponding Camera object settings panel after applying RTSP Server settings, it is mandatory to click Apply on the RTSP Server object settings panel to apply changes to it as well. See also Configuration of multistream video.

  3. If video from the camera is to be received through the video gate, then select the Video gate object in the Gate drop-down list (2).
  4. If archive from the camera is to be received from the backup archive, then select the Backup archive object in the Backup arch. drop-down list (3).
  5. Set the Unicast checkbox checked if signals from all cameras are to be broadcast through one port (4).

  6. In the RTSP port field specify the port via which the video is transmitted (5).

    Note.

    The "Windows Media Player Network Sharing" service can use the default port 554. Change the port number or disable this service for broadcast.
    To disable the service go to the Control panel → Administrative Tools → Services and double-click the service name and click the Stop button in the opened window.
  7. In the HTTP port field specify the port that is to be used for transmitting video via http-protocol (6).

Configuring the Multicast mode

Features of the Multicast mode:

  1. To get a multicast video in Intellect (see Configuring multimedia receipt using RTSP protocol) set the multicast value to the RTSP parameter in the HKEY_LOCAL_MACHINE \SOFTWARE\ITV\Intellect\Video\TransportProtocols registry section (for 64-bit system the path is HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ITV\Intellect\Video\TransportProtocols) on computer where the Camera object is created. For detailed information on this parameter, see Changing the transport protocol used by IP-device.
  2. RTSP Server can broadcast simultaneously in Multicast and Unicast modes. Receiving both such streams on the Intellect client is impossible due to RTSP key which determines the connection mode (see above). However, the VLC player allows receiving streams in both modes in the same time.
  3. The ports that are assigned to each camera in this mode will not be displayed in the Windows OS Resource Monitor and other similar operating system resource monitors.

Using the Multicast mode allows you to reduce the load on the Server by reducing the amount of transmitted data. To distribute the transmitted signal among different RTSP ports, do the following:

  1. Go to the RTSP Server object settings panel.

  2. Set the Multicast checkbox (1). The Port column is displayed in the Cameras table.

  3. Specify a data transmission port for each video camera in the Port field (2). Bear in mind the following when specifying ports:

    1. The following ports are in use for each camera in the Multicast mode: nPort, nPort + 18000 (rtp), nPort + 19000 (rtcp), where nPort—port number specified for camera in the Port column.
      For proper operation of RTSP server in the Multicast mode these ports are to be vacant.
    2. Specified ports are not addressed directly. Use RTSP port to get video from all cameras in the Multicast mode (see item 12).

    3. In spite of specifying video data port it is required to specify camera number in the data source address (see the table below).

  4. In the Receiver IP address field (3) specify the address from which the broadcast in Multicast mode will be performed. Address is to be in range from 224.0.1.0 to 239.255.255.255. By default, the receiver IP is 224.0.1.150. Bear in mind the following when specifying Receiver IP address:

    1. 224.0.0.0-224.0.0.255 address range is reserved for routing protocols and other service protocols. Destination IP address cannot be set from the specified range.

    2. RTSP-server can broadcast to one network simultaneously. The network with minimal metric is selected by default. To change the broadcast network, go to the Advanced settings tab (see below).

    3. Set different Receiver IP address and RTSP port if several RTSP Servers are in Multicast mode.
  5. In the RTSP port field (4) specify the number of port through which video signal will be sent in the Multicast mode. When requesting video data from the camera using the RTSP protocol, it is necessary to specify this port. The system itself forwards the request to the port of the requested camera.

Additional settings

Perform the additional settings as follows:

  1. Go to the Advanced settings tab.

  2. If the current time is to be sent to VLC Media Player instead of the frame time, then set the VLC player compatibility mode checkbox checked (1). This option is to be used in case of problems when playing back the archive received over RTSP in VLC Media Player.

  3. If there are captions on the video (see Configuring captions display on a video image), set the Use captions track checkbox checked to send them along with video via RTSP Server and to display them in the receiving app—VLC player (2).
    Also, when this checkbox is set, time captions are added to the video image in the format YYYYMMDDTHHMMSSZ. If the video is archive (see request examples below), then the captions show the archive time. However, if the VLC player compatibility mode is set along with the Use captions track check box, the time in the captions is current.

    Attention!

    Correct video and captions operation are enabled only in VLC Media Player 2.0.0. These features are not guaranteed to work in other versions of VLC Media Player or other programs.

  4. From the Source IP interface drop-down list, select the name of the network interface that should be used to broadcast the RTSP server (3).

  5. If the RTSP Server is used for broadcasting the video data to the Single Data Center (ECHD), and the Video Surveillance Servers are behind NAT, then it is necessary to specify the NAT settings:

    1. In the IP address field, specify the IP address of the router that performs the NAT broadcasting (4).

    2. In the Port field, specify the port of the router, which is accessed by the client when executing the Single Data Center (ECHD) requests (5).

      Note

      To enable the substitution of the router's specified IP address and port to the Single Data Center (ECHD) requests, it is necessary to set the corresponding checkbox in the settings panel of the Web server object—see Enabling the processing of ECHD requests and selecting rtsp server.

  6. Click the Apply button to save the changes.

Bulk settings for cameras

In case any changeable setting should be the same for several cameras, there is a possibility of bulk setting. This feature is available for editable columns: Added, Gate, Port, Backup Archive.

Perform bulk setting of cameras as follows:

  1. Go to the settings panel of the RTSP-Server object.
  2. Set the value of one or more reference parameters Added, Gate, Port, Backup Archive for one of the Camera objects.

  3. While holding down the Ctrl key, select the (full) rows in the table, which should have the same values ​​in the corresponding columns.
  4. Right-click in the reference cell.
  5. In the opened function menu, select Set for selected rows: "Value". As a result, the corresponding column in all selected rows are filled the value equal to the reference parameter.
  6. Repeat steps 4-5 for all parameters that need to be applied to the selected lines.

Examples of addresses to receive video from RTSP Server

To connect to Server and display video in the video player that supports RTSP protocol, specify the address of data source in the format given in the table:

Note

The time parameters time_begin and time_end must be specified in UTC+0.


Address

Example

Description

rtsp://Server IP address[:Port]/CameraNo[?stream_id=StreamNo]

 

rtsp://127.0.0.1/1

Viewing default stream from Camera 1 if default port is in use.

rtsp://127.0.0.1:555/1

Viewing default stream from Camera 1 when broadcasting in Multicast mode if default port 555 is in use.

Note. Connection to the RTSP stream is performed via the broadcasting adapter IP-address, not by the destination IP which is specified in the settings panel of the RTSP Server and is used internally

rtsp://127.0.0.1:555/7?stream_id=7.2Viewing second stream from Camera 7
rtsp://Login:Password@Server IP address[:Port]/CameraNortsp://login:pass@127.0.0.1:554/1Viewing video signal from Camera 1 if users and permissions are configured in Intellect (see Rights administration)
rtsp://login:pass@127.0.0.1:555/1Viewing video signal from Camera 1 in Multicast mode if users and permissions are configured in Intellect
rtsp://Server IP address[:Port]/CameraNo?mic_id=Microphone ID rtsp://127.0.0.1:555/15?mic_id=1Viewing video from Camera 15 with sound
rtsp:// Server IP address[:Port]/?mic_id= Microphone IDrtsp://127.0.0.1:555/?mic_id=1Getting sound only from microphone 1 with no video from any camera

rtsp:// Server IP address[:Port]/archive?id= CameraNo.&time_begin=yyyy.mm.dd-hh:mm:ss&time_end= yyyy.mm.dd-hh:mm:ss

rtsp://127.0.0.1:554/archive?id=1&time_begin=2011.11.11-11:11:11&time_end=2011.11.11-11:12:00

Viewing video archive from Camera 1 for specified time period

rtsp:// Server IP address[:Port]/archive?id=CameraNo&mic_id= Microphone ID &time_begin=yyyy.mm.dd-hh:mm:ss&time_end= yyyy.mm.dd-hh:mm:ssrtsp://127.0.0.1:554/archive?id=1&mic_id=1&time_begin=2011.11.11-11:11:11&time_end=2011.11.11-11:12:00Viewing video archive from Camera 1 with sound from microphone 1 for specified time period
rtsp://Server IP address[:Port]/archive?id=CameraNo.&time_begin=yyyymmddThhmmssZ&time_end=yyyymmddThhmmssZrtsp://127.0.0.1:555/archive?id=1&time_begin=20160331T080000Z&time_end=20160331T080800ZViewing video archive from Camera 1 for specified time period
rtsp://Server IP address[:Port]/archive?id=CameraNo.&time_begin=yyyymmddThhmmssZrtsp://127.0.0.1:555/archive?id=4&time_begin=20160316T065000ZViewing video archive from Camera 4 from specific start time till the archive end (as the value of time_end is not specified in the address)
rtsp://Server IP address[:Port]/archive?id=CameraNortsp://127.0.0.1:555/archive?id=4Viewing video archive from Camera 4 from the beginning till the end
rtsp://Server IP address[:Port]/archive?id=CameraNo.&long_term_archive=BackupArchiveNortsp://127.0.0.1:559/archive?id=1&long_term_archive=2Viewing Camera 1 video archive from Backup archive 2
rtsp://Server IP address[:Port]/archive?id=CameraNo.&gate=VideogateNortsp://127.0.0.1:559/archive?id=1&gate=3Viewing Camera 1 video archive from Video gate 3
rtsp://Server IP address[:Port]/archive?id=CameraNo.&time_begin=yyyymmddThhmmssZ&time_end=yyyymmddThhmmssZ&z=PlayBackSpeedrtsp://127.0.0.1:554/archive?id=2&time_begin=20171120T102000Z&time_end=20171120T104000Z&z=-1Speed-down playing back video archive of Camera 2 for the specified period of time.
Value of z parameter greater than 0 (valid values are 2, 4, 6 ... 16) enables speed-up archive playback.
If the parameter z is less than 0 (valid values are -1, -2, ... -16), then the archive is played back in the reverse order with the corresponding acceleration. Only key frames are played back at reverse playing
rtsp://Server IP address[:Port]/archive?id=CameraNo.&time_begin=yyyymmddThhmmssZ&time_end=yyyymmddThhmmssZ&long_term_archive=BackupArchNortsp://127.0.0.1:554/archive?id=2&time_begin=20201117T110200Z&time_end=20201117T114900Z&long_term_archive=1

Retrieve camera 2 records from backup archive 1, starting from 14:02:00 UTC+4 on 11/17/2020 and ending at 14:49:00 UTC+4 on the same day.

time_begin and time_end in the request are UTC+0 times.

The specified Backup archive must be selected for the corresponding camera on the settings panel of the RTSP Server object.

VLC player compatibility mode must be enabled to view in VLC Media Player

Note

If 554 port is in use (default value), it can be not specified in the address line.

In the examples given above specify the IP address of the computer where the RTSP Server object is instead of 127.0.0.1.

The figure shows how to view video from the Server.


  • No labels