Versions Compared

Key

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

...

Section


Column
width50%


Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleOn the page:
Table of Contents



Column


General

...

information

The RTSP Server object is used for transmitting video from Server server to remote workplaces workstations using the RTSP protocol. Use The use of the RTSP protocol allows viewing you to view video from IP cameras and video archive on remote Clients clients by means of Axxon PSIM or using use video players that support this protocol. Transmitting Transmission of the archive of the 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 the table with requests examples at the foot of the page Examples of addresses to view video from RTSP Server). For the audio to play correctly in VLC Media Player, set the VLC media player compatibility mode checkbox (see below).

Note
titleAttention!

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

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

The Client must reconnect to URL when the 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 playbackplay 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 system process (StreamingServer.run).

Info
titleNote

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

Creating the RTSP Server

...

object

Create To create the RTSP Server object as follows, do the following:

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

Configuring the Unicast mode

    Open
  1. Go to the settings panel
  2. for
  3. of the RTSP Server
  4. object. For this select the created
  5. object
  6. in the Axxon PSIM objects tree
  7. .
    Image Modified
  8. In the Cameras table, set the checkboxes next to

  9. video
  10. cameras, video from which

  11. is to be displayed (1)
  12. you want to display. If a camera has several streams, the default stream is

  13. broadcasted
  14. transmitted.

    Info
    titleNote

    If the default stream is changed on the

  15. corresponding
  16. settings panel of the corresponding Camera object

  17. settings panel
  18. after

  19. applying
  20. you apply RTSP Server settings,

  21. it is mandatory to click Apply on
  22. you must click the Apply button on the settings panel of the RTSP Server object

  23. settings panel
  24. to apply changes to it as well. See

  25. also Configuration of
  26. also Configuring the multistream video.

  27. If video from the camera must be received through the videogate, then select the Videogate object from the Gate drop-down list
  28. (2)
  29. .
  30. If archive from the camera must be received from the backup archive, then select the Backup archive object from the Backup archive
  31.  drop
  32. drop-down list
  33. (3)
  34. .
  35. Set the Unicast checkbox if signals from all cameras must be broadcast through one port
  36. (4)
  37. .
  38. In the RTSP port field, specify the port via which the video is transmitted

  39. (5)
  40. .

    Info
    titleNote
    The "Windows Media Player Network Sharing"
  41.  service
  42. service can use the default port 554.
  43. Change
  44. To enable broadcasting, you must change the port
  45. number
  46. or disable this service
  47. for broadcast
  48. .
    To disable the service, go to the Control panelAdministrative ToolsServices and double-click the service name and click the Stop button in the
  49. opened
  50. window that opens.
  51. In the HTTP port field, specify the port
  52. that must be used
  53. for transmitting video via
  54. http
  55. HTTP protocol
  56. (6)
  57. .

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,
  2. see
  3. see Changing the transport protocol used by IP-device.
  4. 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
  5. in
  6. at the same time.
  7. 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 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. settings panel
  3. .
  4. Set the Multicast checkbox

  5. (1)
  6. . The Port column is displayed in the Cameras table.

  7. Specify a data transmission port for each

  8. video
  9. camera in the Port field

  10. (2). Bear in mind the following when specifying ports
  11. . When you specify ports, note the following:

    1. The following ports are
  12. in use
    1. used for each camera in the Multicast mode: nPort, nPort + 18000 (rtp), nPort + 19000 (rtcp), where
  13. nPort—port
    1. nPort is a port number specified for camera in
  14. the
    1. the Port column.
      For
  15. proper
    1. the correct operation of RTSP server in the Multicast mode, these ports
  16. are to
    1. must be
  17. vacant
    1. free.
    2. Specified ports are not addressed directly. Use RTSP port to get video from all cameras in the Multicast mode (see step 5).
  18. In spite of specifying
    1. Even if you specify video data port,

  19. it is required to
    1. you still must specify camera number in the data source address (see

  20. the table below
    1. Examples of addresses to view video from RTSP Server).
      Image Modified


  21. In the Receiver IP address field

  22. (3)
  23. , 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.

  24. Bear in mind the following when specifying 
  25. 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.

  26. Destination IP address
    1. You cannot

  27. be
    1. set Receiver IP address from the specified range.

    2. RTSP

  28. -
    1. server can broadcast only to one network simultaneously. The network with minimal metric is selected by default. To change the broadcast network, go to

  29. the
    1. the Advanced settings tab (see below).

  30. Set different
    1. When you configure several RTSP Servers in the Multicast mode, you must specify different values for them in the Receiver IP address and RTSP
  31. port if several RTSP Servers are in Multicast mode
    1. port fields.
  32. In the RTSP port field
  33. (4)
  34. , 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
  35. itself
  36. 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.
    Image Modified
  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

  3. (1). This option can be used in case of problems when
  4. . You can use this option when there are problems with playing back the archive received over RTSP in VLC Media Player.

  5. 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
  6. (2)
  7. .
  8. If there are captions on the video (see Configuring captions display on a video image), set the Use captions track

  9. checkbox (3) to
  10. 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

  11. YYYYMMDDTHHMMSSZ
  12. YYYYMMDDTHHMMSSZ.If the video is

  13. archive
  14. archived (see

  15. request examples below
  16. 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.

    Note
    titleAttention!

    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.

  17. If you want to eliminate a delay of several seconds when requesting a video via RTSP, set the Hot connection mode checkbox
  18. (4)
  19. .
    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.

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

  21. (5)
  22. .

  23. If the RTSP Server is used for broadcasting the video data to the ECHD system, and the Video

  24. Surveillance Servers
  25. 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

  26. (6)
    1. .

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

  27. (7)
    1. .

      Info
      titleNote

      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

  28. in
    1. on the settings panel of the Web

  29. server object—see
    1. -Server object—see Enabling the processing of SDC (ECHD

  30. requests and selecting rtsp server.
    1. ) requests and selecting the RTSP server.

  31. 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.
  32. 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.
  33. 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
  34. Click the
  35. Click the 

  36. Apply button to save the

  37. changes
  38. 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. Set
  3. Specify the value of one or more reference parameters Added, Gate, Port, Backup archive for one of the Camera objects.
    Image Modified
  4. When holding down
  5. Press the Ctrl key
  6. ,
  7. and select the
  8. (
  9. full
  10. )
  11. rows in the table, which must have the same values ​​in the corresponding columns. 
  12. Right-click in the cell of the reference
  13. cell
  14. parameter.
  15. In the
  16. opened
  17. 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. 
  18. 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:

...

Address

...

Example

...

Description

...

rtsp://127.0.0.1/1

...

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

...

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:554/archive?id=1&time_begin=2011.11.11-11:11:11&time_end=2011.11.11-11:12:00

...

Viewing video archive of Camera 1 for specified time period

...

rtsp://Server IP address[:Port]/archive?id=CameraNo.&time_begin=yyyymmddThhmmssZ&time_end=yyyymmddThhmmssZ&z=-1

...

Viewing video archive of Camera 2 for the specified time period in reverse order

Info
titleNote

You can adjust the speed of forward and reverse playback directly in the player that you use.

...

time_begin and time_end in the request are UTC+0 time. If the archive is in a different time zone, you need to specify the time taking into account the time difference. For example, if the archive is located in UTC+4 and you need a period from 15:02:00 to 15:49:00, the above example is suitable.

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

The figure shows how to view video from the Server.

Image RemovedBulk settings are complete.