1.1. Project Overview

eProsima DDS Replayer is a cross-platform application that allows to play back messages recorded by a DDS Recorder instance.

A user can configure a DDS Replayer instance differently depending on the scenario and purpose, being able to tune parameters concerning the DDS layer as well as playback settings.

Among its many configuration options, the user is able to allow/block a set of topics, and/or define specific QoS (other than the recorded ones) to be applied to certain topics. It is also possible to publish samples at a rate different than the original one, filter messages according to its timestamp, or define a publication begin time, among others.

In addition, eProsima DDS Replayer is able to automatically send the type information recorded in a MCAP file, which might be required for applications relying on Dynamic Types.

1.1.1. Usage Description

DDS Replayer is a terminal (non-graphical) application that creates a replay service given an input data file. Although most use cases are covered by the default configuration, the DDS Replayer can be configured via a YAML file, whose format is very intuitive and human-readable.

  • Run: Only the command that launches the application (ddsreplayer) needs to be executed to run a DDS Replayer. Please, read this section to apply a specific configuration, and this section to see the supported arguments.

  • Interact: Once the DDS Replayer application is running, the allowlist and blocklist topic lists could be changed in runtime by just changing the YAML configuration file.

  • Close: To close the DDS Replayer application just send a Ctrl+C signal to terminate the process gracefully (see Closing Replay Application).

1.1.2. Common Use cases

To get started with DDS Replayer, please visit section Example of usage.