Feature/reset behavior plugin

[hakuturu583]

Description

Abstract

Enable reset behavior plugin of entity.

Background

Previously, no means was provided to reset the behavior plugin, and the state had to be saved and respawned.
This pull request provides functionality to allow plugins to be replaced more easily.

Details

Enable reset behavior plugin of entity.
You can use this feature by function below.

void API::resetBehaviorPlugin(const std::string & name, const std::string & behavior_plugin_name)

First argument is the name of the entity you want to reset behavior plugin.
Second argument is the name of the behavior plugin you want to set.

Internally, the following operations are performed

1. Save entity state and parameters.
2. Despawn and respawn target entity.
3. Reset acceleration/twist/behavior parameters to the target entity.

References

Regression test result

Destructive Changes

N/A

Known Limitations

• API::resetBehaviorPlugin function cannot be called on non-spawned Entity
• API::resetBehaviorPlugin function cannot be called for entities other than vehicle/pedestrian because behavior plugin does not exist for entities other than vehicle/pedestrian.

[github-actions]

Checklist for reviewers ☑️

All references to "You" in the following text refer to the code reviewer.

• Is this pull request written in a way that is easy to read from a third-party perspective?
• Is there sufficient information (background, purpose, specification, algorithm description, list of disruptive changes, and migration guide) in the description of this pull request?
• If this pull request contains a destructive change, does this pull request contain the migration guide?
• Labels of this pull request are valid?
• All unit tests/integration tests are included in this pull request? If you think adding test cases is unnecessary, please describe why and cross out this line.
• The documentation for this pull request is enough? If you think adding documents for this pull request is unnecessary, please describe why and cross out this line.