Documentation for Axxon PSIM 1.0.0-1.0.1.

Previous page Setting up the Web-server module to act as a gate on a different HTTP-server  Examples of addresses to view video from RTSP Server Next page


On the page:

General information

The RTSP Server object is used for transmitting video from server to remote workstations using the RTSP protocol. The use of the RTSP protocol allows you to view video from IP cameras and video archive on remote clients by means of Axxon PSIM or use video players that support this protocol. Transmission of the archive of the Videogate and Backup archive is also supported.

If there is a live video with audio or the archive is recorded with audio, then video transmission with audio through RTSP Server is supported—for this specify the ID of microphone from which the archive is recorded when requesting video (see Examples of addresses to view video from RTSP Server). For the audio to play correctly in VLC Media Player, set the VLC player compatibility mode checkbox (see below).

Attention!

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

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

Client must reconnect to URL when codec is changed.

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

The time_begin and time_end time parameters must be specified in the UTC+0 format. If the archive is in a different time zone, you must specify the time taking into account the time difference. 

On the settings panel of the RTSP Server object, you must select the specified Backup archive for the corresponding camera.

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

Note that when configuring, each RTSP Server loads only one CPU core. To increase the number of rtsp streams, you must create several RTSP Server objects and configure them on several cameras. Each RTSP Server entity runs in a separate process (StreamingServer.run).

Note

All ports mentioned below are specified using only natural numbers.

Creating the RTSP Server object

To create the RTSP Server object, do the following:

  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 settings panel that opens.
  3. Click the Apply button to create the object.

Configuring the Unicast mode

  1. Go to the settings panel of the RTSP Server object.

  2. In the Cameras table, set the checkboxes next to cameras, video from which you want to display. If a camera has several streams, the default stream is transmitted.

    Note

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

  3. If video from the camera must be received through the videogate, then select the Videogate object from the Gate drop-down list.
  4. If archive from the camera must be received from the backup archive, then select the Backup archive object from the Backup archive drop-down list.
  5. Set the Unicast checkbox if signals from all cameras must be broadcast through one port.

  6. In the RTSP port field, specify the port via which the video is transmitted.

    Note

    The "Windows Media Player Network Sharing" service can use the default port 554. To enable broadcasting, you must change the port or disable this service.
    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 window that opens.
  7. In the HTTP port field, specify the port for transmitting video via HTTP protocol.

Configuring the Multicast mode

Features of the Multicast mode:

  1. To get a multicast video in Axxon PSIM (see Configuring multimedia receipt using RTSP protocol), set the multicast value to the RTSP parameter in the HKEY_LOCAL_MACHINE \SOFTWARE\AxxonSoft\PSIM\Video\TransportProtocols registry section (for 64-bit system the path is HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\AxxonSoft\PSIM\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 Axxon PSIM client is impossible due to RTSP key, which determines the connection mode (see above). However, the VLC player allows receiving streams in both modes at 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 settings panel of the RTSP Server object.

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

  3. Specify a data transmission port for each camera in the Port field. When you specify ports, note the following:

    1. The following ports are used for each camera in the Multicast mode: nPort, nPort + 18000 (rtp), nPort + 19000 (rtcp), where nPort is a port number specified for camera in the Port column.
      For the correct operation of RTSP server in the Multicast mode, these ports must be free.
    2. Specified ports are not addressed directly. Use RTSP port to get video from all cameras in the Multicast mode (see step 5).

    3. Even if you specify video data port, you still must specify camera number in the data source address (see Examples of addresses to view video from RTSP Server).

  4. In the Receiver IP address field, specify the address from which the broadcast in the Multicast mode will be performed. Address must be in the range from 224.0.1.0 to 239.255.255.255. By default, the receiver IP is 224.0.1.150. When you specify Receiver IP address, note the following:

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

    2. RTSP server can broadcast only 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. When you configure several RTSP Servers in the Multicast mode, you must specify different values for them in the Receiver IP address and RTSP port fields.
  5. In the RTSP port field, 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 forwards the request to the port of the requested camera.

Advanced settings

To specify the advanced settings of RTSP Server, do the following:

  1. Go to the Advanced settings tab.

  2. If the current time must be sent to VLC Media Player instead of the frame time, then set the VLC player compatibility mode checkbox. You can use this option when there are problems with playing back the archive received over RTSP in VLC Media Player.

  3. If RTSP Server is used to broadcast video data to the ECHD system, then for the correct operation of navigation through the archive, set the ECHD compatibility mode checkbox.

  4. If there are captions on the video (see Configuring captions display on a video image), set the Use captions track checkbox to send them together with video via RTSP Server and to display them in the receiving app—VLC player.
    Also, when this checkbox is set, time captions are added to the video image in the format YYYYMMDDTHHMMSSZ. If the video is archived (see Examples of addresses to view video from RTSP Server), then the captions show the archive time. However, if the VLC player compatibility mode checkbox is set together with the Use captions track checkbox, the time in the captions is current.

    Attention!

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

  5. If you want to eliminate a delay of several seconds when requesting a video via RTSP, set the Hot connection mode checkbox.

    Note

    The delay when requesting a video via RTSP can also depend on the camera key frame rate (FPS) settings or the frame buffer size settings in the player.

  6. From the Source IP interface drop-down list, select the name of the network interface that must be used to broadcast the RTSP server.

  7. If the RTSP Server is used for broadcasting the video data to the ECHD system, 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.

    2. In the Port field, specify the port of the router, which is accessed by the client when executing the ECHD requests.

      Note

      To enable the substitution of the router's specified IP address and port to the ECHD requests, it is necessary to set the corresponding checkbox on the settings panel of the Web-Server object—see Enabling the processing of SDC (ECHD) requests and selecting the RTSP server.

  8. In the Number of threads (min/) field, specify the value that corresponds to the initial number of threads that are created when the RTSP Server is started. The default value is 1.
  9. In the Number of connections per thread field, specify the value that corresponds to the maximum number of client connections per thread, with equal distribution. If this parameter is exceeded, a new thread is created. The default value is 20.
  10. In the Number of threads (/max) field, specify the value that corresponds to the maximum allowed number of threads that can be created. If there are too many threads, server rejects additional connections. The default value is 100. 

  11. Click the Apply button to save the settings.

Bulk settings for cameras

In case any changeable setting must be the same for several cameras, it can be duplicated. This feature is available for editable columns: Added, Gate, Port, Backup archive.

To specify the bulk settings, do the following: 

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

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

Bulk settings are complete.

  • No labels