与 Gym 的兼容性

Gymnasium 为各种环境实现提供了一些兼容性方法。

加载 OpenAI Gym 环境

对于仅在 OpenAI Gym 中注册而未在 Gymnasium 中注册的环境，Gymnasium v0.26.3 及更高版本允许通过特殊环境或封装器导入它们。"GymV26Environment-v0" 环境在 Gymnasium v0.26.3 中引入，允许通过 env_name 参数以及其他相关的 kwargs 环境 kwargs 导入 Gym 环境。为了通过封装器执行转换，可以将环境本身传递给封装器 EnvCompatibility，通过 env kwarg。

import gymnasium as gym

env = gym.make("GymV26Environment-v0", env_id="GymEnv-v1")

Gym v0.21 环境兼容性

许多环境尚未更新到最近的 Gym 更改，特别是自 v0.21 以来。此更新对于引入 termination 和 truncation 签名以取代先前使用的 done 非常重要。为了允许向后兼容性，Gym 和 Gymnasium v0.26+ 在调用 make() 时包含一个 apply_api_compatibility kwarg，该 kwarg 自动将 v0.21 API 兼容环境转换为与 v0.26+ 兼容的环境。

import gym

env = gym.make("OldV21Env-v0", apply_api_compatibility=True)

此外，在 Gymnasium 中，我们为兼容性提供了专门的环境，对于 env_id，它将调用 gym.make。

import gymnasium

env = gymnasium.make("GymV21Environment-v0", env_id="CartPole-v1", render_mode="human")
# or
env = gymnasium.make("GymV21Environment-v0", env=OldV21Env())

Step API 兼容性

如果环境实现了（旧的）done step API，Gymnasium 提供了函数 (gymnasium.utils.step_api_compatibility.convert_to_terminated_truncated_step_api()) 和封装器 (gymnasium.wrappers.StepAPICompatibility)，它们会将具有旧 step API（使用 done）的环境转换为新的 step API（使用 termination 和 truncation）。