Configurator

Related Links

Code Files:

• aimrt_module_cpp_interface/configurator/configurator.h

Reference Examples:

• helloworld_module.cc

Interface Overview

The aimrt::configurator::ConfiguratorRef type is a configuration handle type. Modules can obtain this type of handle by calling the GetConfigurator() interface of the CoreRef handle, and use it to access some configuration-related functionalities. Its core interfaces are as follows:

namespace aimrt::configurator {

class ConfiguratorRef {
 public:
  std::string_view GetConfigFilePath() const;
};

}  // namespace aimrt::configurator

Usage Notes:

• std::string_view GetConfigFilePath() interface: Used to get the path of the module configuration file.

  • Please note that this interface only returns the path of a module configuration file. Module developers need to read and parse the configuration file themselves.

  • For details on what value this interface will return, please refer to the deployment and runtime aimrt.module Configuration Documentation.

Usage Example

A simple usage example is as follows:

#include "yaml-cpp/yaml.h"

class HelloWorldModule : public aimrt::ModuleBase {
 public:
  // ...

  bool Initialize(aimrt::CoreRef core) override {
    // Get configurator handle
    auto configurator = core.GetConfigurator();

    // Get cfg path
    std::string_view cfg_file_path = configurator.GetConfigFilePath();

    // Parse cfg file based on the actual format. In this example, parsing based on yaml
    YAML::Node cfg_node = YAML::LoadFile(std::string(cfg_file_path));

    // ...

    return true;
  }
};