从 CLI 运行独立环境

从命令行界面 (CLI) 运行 Schola 是与系统交互的强大方式。本指南将引导您完成从 CLI 运行 Schola 的步骤，包括如何设置您的环境和执行命令。

构建您的环境

在能够从命令行运行 Schola 的独立可执行文件之前，您需要将您的 Unreal Engine 项目打包成一个独立的解决方案。这在 官方 Unreal Engine 文档 中有详细介绍。

从 CLI 运行

要启动独立环境（即以 Development 或 Shipping 模式构建的游戏），您可以使用以下命令：

Stable Baselines 3Ray

schola-sb3 --launch-unreal --executable-path <PATH_TO_EXECUTABLE>

schola-rllib  --launch-unreal --executable-path <PATH_TO_EXECUTABLE>

您应该将 `<PATH_TO_EXECUTABLE>` 替换为您的已打包 Unreal Engine 可执行文件的路径。

无头模式

Schola 可以在无头模式下运行，这对于运行脚本或自动化任务非常有用。要以无头模式运行 Schola，请使用以下命令：

Stable Baselines 3Ray

schola-sb3 --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --headless

schola-rllib  --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --headless

此命令将启动 Schola，不显示图形用户界面 (GUI)，从而可以加快模拟速度。

说明

任何需要渲染的功能在无头模式下将无法工作（例如，CameraObserver）。

固定模拟时间步长

Schola 允许您为模拟设置固定的每秒帧数 (FPS)。这有助于确保不同运行之间的一致性能。要设置固定的 FPS，请使用以下命令：

Stable Baselines 3Ray

schola-sb3 --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --fps <FPS>

schola-rllib  --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --fps <FPS>

将 `<FPS>` 替换为您想要的每秒帧数值。例如，要将 FPS 设置为 30，请使用：

Stable Baselines 3Ray

schola-sb3 --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --fps 30

schola-rllib  --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --fps 30

说明

FPS 决定了在计算 Unreal Engine 中的更新时使用的增量，但每秒模拟的时间步长数与此设置无关。例如，如果 —fps=100，而 Unreal 以 1000fps 模拟您的环境，那么在现实世界的每一秒中，将模拟环境中的 10 秒。

控制地图

Schola 允许您在启动环境时指定要加载的地图。为此，请使用 —map 参数，后跟地图的路径。例如：

Stable Baselines 3Ray

schola-sb3 --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --map <MAP_NAME>

schola-rllib  --launch-unreal --executable-path <PATH_TO_EXECUTABLE> --map <MAP_NAME>

地图应指定为相对于 Content 文件夹的相对路径，其中 Content 被替换为 Game。例如，`/Content/LevelOne/Map` 将指定为 `Game/LevelOne/Map`。

说明

地图必须是有效的 Unreal Engine 地图文件。如果未找到地图或未指定地图，Schola 将默认使用项目设置中指定的默认地图。

说明

默认情况下，map 参数不适用于 Shipping 构建。您需要采取额外步骤，允许根据命令行标志加载地图。

其他设置

有关 Stable Baselines 3 和 RLLib 的特定设置，请参阅 schola-rllib 和 schola-sb3。