Table of Contents  MOBOTIX Online Help

Integration Protocols

Table of Contents
Integration Protocols
Integration Protocols
Protocol
Optimize Settings
Global Settings
Aspect Ratio
Multicast Interface
RTSP Port
RTSP-over-HTTP Tunnel
RTSP User Configuration
MxPEG and M-JPEG Settings
Enable Stream
Frame Rate (fps)
Image Size
Enable Audio
Keyframe Interval
Activate Multicast
Multicast Autostart
Multicast IP
Multicast Port
Multicast TTL
JPEG Quality
Audio Stream Settings
Activate Audio Stream
H.264 Settings
Enable H.264 Stream
Frame Rate (fps)
Minimum Frame Rate (fps)
Image Size
Enable Audio
Activate Multicast
Multicast Autostart
Multicast IP
Multicast Port
Multicast TTL
Quality
Minimum Quality
Bitrate
Constant Quality
Keyframe Interval
Genetec Settings
PTZ
ONVIF Settings
Discoverable
Scopes
Profiles
User
Displaying the H.264 Video Stream
Configuration Hints for VLC

Open the Integration Protocols dialog to configure the interfaces for integrating the camera into the third-party systems as well as the RTP server of the camera.

The interfaces allow finding and configuring the camera on the network using compatible systems of third-party manufacturers. The RTP server provides access to the camera's live image. The server can provide different types of video streams using the RTP protocol. Depending on the codec, you can provide streams with or without audio channel. In addition, you can use Multicast to distribute the stream to several cameras at once without taking too much toll on the camera performance (which would be the case if providing several Unicast streams).

Transmission Types

Note

Unicast and Multicast can be used together. Depending on the specified RTSP URL in the video client, the Unicast or the Multicast streams will be accessed.

Access Control

Note

When accessing the RTP server, authentication uses the different user types as specified by the RTSP URL. All URLs starting with the onvif prefix need to be authenticated using an ONVIF user account, all other URLs require a Standard user account for authentication.

Integration Protocols

Protocol

Sets the active integration protocols of the camera.

Possible Protocols
  • Genetec: Activates the Genetec integration protocol. The camera will be discovered automatically by Genetec Security Center, which also allows configuring the camera. The RTP server is active in this mode.

  • ONVIF: Activates the ONVIF integration protocol. The camera will be discovered automatically by ONVIF-compatible systems, which also allow configuring the camera. The ONVIF configuration requires special users. The factory default includes a preconfigured admin user with default password. If you are not selecting ONVIF at this point, all ONVIF users will be denied access. The RTP server is active in this mode.

    Notes

    Please note the following when activating ONVIF:
    • Change the password of the preconfigured ONVIF user if you are using ONVIF.

    • As opposed to previous software versions, standard users will be denied access via the ONVIF interface!

    • If ONVIF is active, the Multicast stream is only available for ONVIF users by accessing the corresponding ONVIF Multicast URLs.

    • For ONVIF, you should use one of these aspect ratios: 4:3, 3:2, or 16:9. This means that you can use all available ONVIF resolutions later on.

    • If MxWeb has been activated, the ONVIF service is also available via the ports configured for MxWeb.

  • Genetec + ONVIF: Activates both, Genetec and ONVIF as integration protocol. The camera will be discovered automatically by Genetec Security Center and ONVIF-compatible systems, which also allow configuring the camera. In this mode, you should use the camera via ONVIF in read-only mode when accessing the camera via Genetec Security Center at the same time. The RTP server is active in this mode.

  • RTP: Activates only the RTP server of the camera. This server provides MxPEG, H.264 and M-JPEG-encoded video via RTSP/RTP.

  • Off: In this mode, neither the RTP server nor other protocols are active.

Optimize Settings

This option is only available if the protocol supports optimized settings.

The basic idea is that the recommended camera settings for the selected protocol are applied automatically. Clicking on the button shows an overview of the settings that will be optimized. If available, the dialog also shows additional settings that can be configured by the user. The changes that will be applied and the available options depend on the selected protocol. Clicking on Apply & Store will apply the optimized settings and store them in permanent storage, clicking on Cancel will abort the process without any changes.

Notes

  • Applying the optimized settings possibly overwrites other changes you may have applied beforehand. It's a good idea to apply the optimized settings first and then customize the settings as required.

  • Applying the optimized settings will discard changes to the integration protocol settings that have not yet been applied.

Global Settings

Aspect Ratio

Sets the aspect ratio of all video streams supplied by the RTP server.

  • Free: The aspect ratio depends on the settings in the General Image Settings dialog.

  • 4:3: Sets the aspect ratio of all video streams supplied by the RTP server to 4:3.

  • 3:2: Sets the aspect ratio of all video streams supplied by the RTP server to 3:2. The maximum resolution of the 6MP sensor is only reached when using this aspect ratio.

  • 16:9: Sets the aspect ratio of all video streams supplied by the RTP server to 16:9.

Notes

  • When using the Free setting, only the resolutions (image sizes) defined in the General Image Settings dialog are available. The RTP server scales only this image to the specified target resolution.

  • When using the settings 4:3, 3:2, and 16:9, all resolutions up to 6MP are available. The RTP server automatically adjusts the resolutions and the image quality in the General Image Settings dialog to the requirements of the currently active RTP connection. Caution: When using live image recording, these settings also apply to the recorded video. To circumvent this behavior, you can either select the Free aspect ratio or activate full image recording in the Recording dialog.

  • Note that the camera selection and the display mode in the General Image Settings dialog also influence the aspect ratio and thus the resolutions supported by the RTP server.

  • The full 6MP resolution can pnly be reached when using the settings Free or 3:2.

Multicast Interface

Network interface for the RTP server to use. Depending on the configuration, you can use different (virtual) network interfaces/IP addresses to access the camera. This option allows limiting access to the RTP server to only one of these interfaces. By factory default, all interfaces are available. This means that you can establish Unicast connections to all interfaces of the camera. For Multicast connections, the connection is selected automatically in the following order:

  1. Network interface with fixed (static) IP address

  2. Network interface with an IP address assigned by DHCP

  3. Network interface with the factory IP address (10.x.x.x)

  4. Network interface with the Zeroconf IP address (169.254.x.x.x)

If you select a specific interface for this option, Multicast and Unicast connections are only available via this interface. The RTP server will be deactivated on all other interfaces.

RTSP Port

Port of the RTSP Server. By default, this is port 554.

RTSP-over-HTTP Tunnel

Allows accessing the RTSP/RTP data via an HTTP tunnel. This is available below the web server ports.

RTSP User Configuration

Allows setting the Multicast parameters using the RTSP SETUP command.

MxPEG and M-JPEG Settings

This section is only available if the selected protocol activates the RTP server.

Every one of the four streams has its own configuration section with the corresponding parameters. To provide a better overview, you can click to open and close the individual sections.

Enable Stream

Activates the corresponding video stream. You can use any video player with the corresponding codec that can handle RTSP/RTP streams.

Depending on the codec, you need to use the following URLs for accessing the video streams:

  • MxPEG addresses for accessing the MxPEG streams:

    Unicast access by means of a standard user account:

    rtsp://192.168.1.254:<RTSP port>/stream{0 - 3}/mobotix.mxg

    Multicast access by means of a standard user account:

    rtsp://192.168.1.254:<RTSP port>/multicast/stream{0 - 3}/mobotix.mxg

    It is not possible to access the MxPEG by means of an ONVIF user account.

  • M-JPEG addresses for accessing the M-JPEG streams:

    Unicast access by means of a standard user account:

    rtsp://192.168.1.254:<RTSP port>/stream{0 - 3}/mobotix.mjpeg

    Multicast access by means of a standard user account (*):

    rtsp://192.168.1.254:<RTSP port>/multicast/stream{0 - 3}/mobotix.mjpeg
  • M-JPEG + ONVIF: The following addresses are available if the ONVIF extension has been enabled.

    Unicast access by means of an ONVIF user account:

    rtsp://192.168.1.254:<RTSP port>/onvif/stream{0 - 3}/mobotix.mjpeg

    Multicast access by means of an ONVIF user account (*):

    rtsp://192.168.1.254:<RTSP port>/onvif/multicast/stream{0 - 3}/mobotix.mjpeg

Note

If ONVIF is active, the Multicast stream is only available for ONVIF users by accessing the corresponding ONVIF Multicast URLs. The Multicast addresses for standard users will be deactivated if the ONVIF extension is active.

Frame Rate (fps)

Image rate in frames per second (default value is 30 fps). The maximum attainable frame rate depends on additional configuration parameters of the RTP stream. To reach the maximum frame rate, please set the image size (resolution) and image quality settings for the RTP stream to the same values as in the corresponding dialogs of the Setup Menu:

Image Size

Select the size of the video stream. You can only use one of the image formats (width x height) in the list box.

Note

Image sizes larger than Full HD (1920x1080) can only use M-JPEG if the receiver supports the ONVIF extensions for M-JPEG. If this is not the case, the receiver will not show any images if the image size is larger than Full HD.

Enable Audio

Use this parameter to control the audio channel for this MxPEG video stream. Note that this option is only available if a corresponding audio input has been configured and activated in the Microphone and Speaker dialog. This option is activated by factory default.

Keyframe Interval

Number of frames between two full images. This option is only available when using MxPEG. The default value is 20.

Activate Multicast

This settings allows using both Unicast and Multicast (simultaneous transmission to an unlimited number of recipients) at the same time. Note that Multicast mode is deactivated by default.

Multicast Autostart

Controls whether or not the RTP stream is supplied always of only if it is actually requested. If autostart has been disabled, the RTP Multicast stream will be started only once an RTSP connection has been established. The stream will stay active as longs as there are active RTSP connections to the stream. If autostart has been enabled, the RTP Multicast stream will always be supplied. Note that Multicast autostart is deactivated by default.

Multicast IP

IP address of the Multicast group, to which the video data are being sent. This address must be within the SSM (Source-Specific Multicast) range (232.0.1.0 to 232.255.255.255), but all other valid Multicast IP addresses will be accepted. If you leave this field empty, the server automatically chooses a valid IP address. The automatic address selection should work fine for most scenarios.

Accessing the Unicast stream is still possible, even if Multicast mode is active. To access the Multicast video streams, you need to use the special rtsp URL. The server automatically sends the Multicast IP and the port to the recipients.

Multicast Port

In Multicast mode, the server uses up to four consecutive ports to send the audio and video data to the recipients. Enter the first port of the range and make sure that the following three ports are not used on your network. Der hier eingetragene Port muss im Bereich 1025 bis 65532 liegen. For MxPEG, the default port is 18892, for M-JPEG it is 18908.

Note

Make sure that the specified port range is not blocked by the recipient's firewall.

Multicast TTL

The TTL ("Time To Live") specifies how many hops (routers) the Multicast packets can pass before being discarded. The valid value range is 1 through 255. The default value (1) means that the Multicast packets are only distributed within the current subnet of the camera.

JPEG Quality

Sets the image quality of the JPEG-compressed images of the video stream. The default value of 0 will use copy the settings from the current live image.

Audio Stream Settings

This section is only available if the selected protocol activates the RTP server.

Activate Audio Stream

Activates a stream that only contains the audio data. You can receive and play the stream using the following address:

rtsp://192.168.1.254:<RTSP port>/mobotix.pcm

H.264 Settings

This section is only available if the selected protocol activates the RTP server.

Enable H.264 Stream

Activates the H.264 video stream. You can use any video player with the corresponding codec that can handle RTSP/RTP streams using one of the following addresses:

  • H.264: The following addresses are available:

    Unicast access by means of a standard user account:

    rtsp://192.168.1.254:<RTSP port>/mobotix.h264

    Multicast access by means of a standard user account (*):

    rtsp://192.168.1.254:<RTSP port>/multicast/mobotix.h264
  • H.264 + ONVIF: The following addresses are available if the ONVIF extension has been enabled.

    Unicast access by means of an ONVIF user account:

    rtsp://192.168.1.254:<RTSP port>/onvif/mobotix.h264

    Multicast access by means of an ONVIF user account (*):

    rtsp://192.168.1.254:<RTSP port>/onvif/multicast/mobotix.h264

Note

If ONVIF is active, the Multicast stream is only available for ONVIF users by accessing the corresponding ONVIF Multicast URLs. The Multicast addresses for standard users will be deactivated if the ONVIF extension is active.

Frame Rate (fps)

Image rate in frames per second (default value is 30 fps). The maximum attainable frame rate depends on additional configuration parameters of the RTP stream. To reach the maximum frame rate, please set the Constant Quality option to Off and set the image size (resolution) setting to the same value as in the corresponding dialog of the Setup Menu:

Minimum Frame Rate (fps)

Minimum image rate in frames per second. Allows setting the lower limit for controlling the frame rate. This parameter is only available if the Constant Quality option has been activated. The default value is 5.

Image Size

Select the size of the video stream. You can only use one of the image formats (width x height) in the list box. Image sizes larger than QXGA (2048x1536) are not supported for H.264.

Enable Audio

Use this parameter to control the audio channel for this MxPEG video stream. Note that this option is only available if a corresponding audio input has been configured and activated in the Microphone and Speaker dialog. This option is activated by factory default.

Activate Multicast

This settings allows using both Unicast and Multicast (simultaneous transmission to an unlimited number of recipients) at the same time. Note that Multicast mode is deactivated by default.

Multicast Autostart

Controls whether or not the RTP stream is supplied always of only if it is actually requested. If autostart has been disabled, the RTP Multicast stream will be started only once an RTSP connection has been established. The stream will stay active as longs as there are active RTSP connections to the stream. If autostart has been enabled, the RTP Multicast stream will always be supplied. Note that Multicast autostart is deactivated by default.

Multicast IP

IP address of the Multicast group, to which the video data are being sent. This address must be within the SSM (Source-Specific Multicast) range (232.0.1.0 to 232.255.255.255), but all other valid Multicast IP addresses will be accepted. If you leave this field empty, the server automatically chooses a valid IP address. The automatic address selection should work fine for most scenarios.

Accessing the Unicast stream is still possible, even if Multicast mode is active. To access the Multicast video streams, you need to use the special rtsp URL. The server automatically sends the Multicast IP and the port to the recipients.

Multicast Port

In Multicast mode, the server uses up to four consecutive ports to send the audio and video data to the recipients. Enter the first port of the range and make sure that the following three ports are not used on your network. Der hier eingetragene Port muss im Bereich 1025 bis 65532 liegen. The default value for this port is 18888.

Note

Make sure that the specified port range is not blocked by the recipient's firewall.

Multicast TTL

The TTL ("Time To Live") specifies how many hops (routers) the Multicast packets can pass before being discarded. The valid value range is 1 through 255. The default value (1) means that the Multicast packets are only distributed within the current subnet of the camera.

Quality

Sets the image quality for the compressed H.264 video stream in percent, where 100 % means the best quality.

Minimum Quality

Sets the minimum image quality to use for quality control. This parameter is only used if the Constant Quality option has not been activated. The default value is 20 %.

Bitrate

Bit rate limitation for the H.264 video stream. The bit rate is specified in kbit/s, values are possible up to 32000. In complex scenes, the camera will either reduce the image quality or the frame rate to reach the specified bit rate.

Constant Quality

Switches between reducing the image quality or the frame rate to reach the specified bit rate. On will reduce the frame rate to reach the bit rate limit. Off will reduce the image quality to reach the bit rate limit. The default value is Off.

Keyframe Interval

Number of frames between two full images. The default value is 20, the maximum value is 32000.

Genetec Settings

This section is only available if the selected protocol activates Genetec.

PTZ

Allows controlling the camera vPTZ from Genetec Security Center. If this option is not selected, Genetec Security Center will apply its own vPTZ mechanisms to the received video stream.

ONVIF Settings

This section is only available if ONVIF has been selected as protocol.

The following functions are provided for ONVIF integration:

Discoverable

Activates the service for automatic detection of the camera by other ONVIF devices.

Scopes

Lists the scopes for this camera, one per line. You can configure the scopes list either using the ONVIF interface or the browser-based user interface of the camera.

Profiles

Lists all profiles that had been configured via the ONVIF interface. Use the Reset Profiles function if you want to delete these profiles. The Default MJPEG Profile and the Default H.264 Profile are predefined profiles. If you delete them, they will be recreated automatically using the factory default parameters.

User

Lists all ONVIF user accounts. ONVIF users have access to the ONVIF interface and the RTP live video streams. Accessing other interfaces, such as the web or the eventstream interfaces is not possible for ONVIF users.

According to the ONVIF specification, access to the ONVIF interface is granted using a three-level user level model. The assignment of the user levels to specific access rights follows the Default Access Policy Definition of the ONVIF specification:

  • Users of the Admin level have full access to the configuration and all RTP live video streams. In particular, administrators can manage the ONVIF user accounts.

  • Users of the Operator level have limited access to the system. They can read parts of the configuration and can control actuators (such as PTZ, I/O ports) in the future. These users also have access to all RTP live video streams.

  • Users of the Users level can read the basic configuration and have access to all RTP live video streams.

Changing the User Level

To change the user level, click on the current user level and select the new level from the drop-down field.

Changing the Password

Click on Change Password to change the password of a user. New passwords must have at least six characters.

Deleting Users

Click on the Delete icon next to the password field to delete a user. Note that you cannot delete the last user since there must be at least one ONVIF user on the system.

Adding Users

Click on Add User to add a new user. Enter the user name, select the user level, and enter the password. Unser names must have at least three characters.

Displaying the H.264 Video Stream

To play back the H.264 video stream, open the following URL in a suitable player:

rtsp://192.168.1.254:554/mobotix.h264

Examples for suitable players:

Configuration Hints for VLC

When using the VLC Media Player (www.videolan.org) for playing back the H.264 video stream, problems may appear if the frame rate is below 4 fps. You can avoid these problems by adjusting the setting for network buffering in the VLC configuration.

To do so, open Tools > Settings in VLC and change the settings as shown below:

  1. Show Settings: All (shows the extended view of the settings).

  2. Select Input/Codecs and scroll the right-hand side of the dialog to the Extended section.

  3. Cache value for the network (ms): The default value is 1000 ms. Higher values improve the playback stability, but also increase the delay between recording and playback. Use the following values, depending on the frame rate:

    • Frame rates of 4 fps and slightly lower: 2000 ms.

    • Frame rates of 3 fps and lower: 3000 ms.


© 2001-2024 MOBOTIX · https://www.mobotix.com