Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 Сlients by means of the Axxon PSIM software or using video players that support this protocol.  Transmitting Video gate archive Transmitting the archive of the Videogate and Backup archive is also supported.

If there is sound with live video with audio or the archive is recorded with soundaudio, then video broadcast transmission with sound audio 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 at the foot of the page). For proper operation of this feature set the the audio to play correctly in VLC Media Player, set the VLC media player compatibility mode checkbox checked in VLC Media Player (see item 14below).

Note
titleAttention!

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

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

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

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

It is to be taken into account that while configuring each rtsp Server Note that when 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 , you must create several RTSP Server objects and configure them on several cameras. Each RTSP Server entity runs in a separate system process (StreamingServer.run).

...

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

...

  1. Open the settings panel for the RTSP Server object. For this select the created object in the Axxon PSIM objects tree.
    Image Modified
  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.

    Info
    titleNote

    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 If video from the camera must be received through the videogate, then select the Videogate object from the Gate drop-down list (2).
  4. If archive from the camera is to be received from the camera must be received from the backup archive, then select the then select the Backup archive object in from the Backup arch. droparchive drop-down list (3).
  5. Set the Unicast checkbox checked if signals from all cameras are to must be broadcast through one port (4).
  6. In the RTSP port field, specify the port via which the video is transmitted (5).

    Info
    titleNote
    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 panelAdministrative ToolsServices 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 must 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 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 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).
      Image RemovedImage Added


  4. In the Receiver IP address field (3), specify the address from which the broadcast in Multicast mode will be performed. Address is to must 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 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.

...

Advanced settings

Perform To specify the additional settings as followsadvanced settings of RTSP Server, do the following:

  1. Go to the Advanced settings tab.
    Image RemovedImage Added
  2. If the current time is to must 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 can be used in case of problems when 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 (2).
  4. If there are captions on the video (see Configuring captions display on a video image), set the Use captions track checkbox (3) to send them together 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 checkbox is set along together with the Use captions track check box checkbox, the time in the captions is current.

    Note
    titleAttention!

    Correct video playback and captions operation are enabled only 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. 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 (4).
    Info
    titleNote

    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 From the Source IP interface drop-down list, select the name of the network interface that should must be used to broadcast the RTSP server (35).

  7. If the RTSP Server is used for broadcasting the video data to the Single Data Center ( 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 specify the IP address of the router that performs the NAT broadcasting broadcasting (46).

    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 (5ECHD requests (7).

      Info
      titleNote

      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.


  8. Click the Apply button to save the changes.

...

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

Perform bulk setting of cameras as follows: To specify the bulk settings, do the following: 

  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 Archivearchive for one of the Camera objects.
    Image RemovedImage Added
  3. While When holding down the Ctrl key, select the (full) rows in the table, which should must 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.

...

Address

Example

Description

rtsp://ServerIP 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 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@ServerIP address[:Port]/CameraNortsp://login:pass@127.0.0.1:554/1Viewing video signal from Camera 1 if users and permissions are configured in Axxon PSIM (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 Axxon PSIM
rtsp://Server IP address[:Port]/CameraNo?mic_id=Microphone IDrtsp://127.0.0.1:555/15?mic_id=1Viewing video from Camera 15 with soundaudio
rtsp:// Server IP address[:Port]/?mic_id= Microphone IDrtsp://127.0.0.1:555/?mic_id=1Getting sound audio only from microphone 1 with no video from any camera

rtsp:// ServerIP 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 audio from microphone 1 for specified time period
rtsp://ServerIP 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://ServerIP 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://ServerIP 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://ServerIP 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 Videogate 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

...

Info
titleNote

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 on which the RTSP Server object is instead of 127.0.0.1.

...