视频弹球¶

这个环境是 Atari 环境的一部分。请先阅读该页面以获取一般信息。


动作空间	离散(9)
观察空间	Box(0, 255, (210, 160, 3), uint8)
导入	`gymnasium.make("ALE/VideoPinball-v5")`

有关具有不同观察和动作空间的更多 VideoPinball 变体，请参阅变体部分。

描述¶

你的目标是尽可能长时间地保持球在比赛中，并尽可能多地得分。

如需更详细的文档，请参阅 AtariAge 页面

动作¶

VideoPinball 具有 Discrete(9) 的动作空间，下表列出了每个动作的含义。要启用 Atari 2600 上可以执行的所有 18 个可能的动作，请在初始化时指定 full_action_space=True，或者通过向 gymnasium.make 传递 full_action_space=True。

值	意义	值	意义	值	意义
`0`	`NOOP`	`1`	`FIRE`	`2`	`UP`
`3`	`RIGHT`	`4`	`LEFT`	`5`	`DOWN`
`6`	`UPFIRE`	`7`	`RIGHTFIRE`	`8`	`LEFTFIRE`

观察¶

Atari 环境有三种可能的观察类型："rgb"、"grayscale" 和 "ram"。

obs_type="rgb" -> observation_space=Box(0, 255, (210, 160, 3), np.uint8)
obs_type="ram" -> observation_space=Box(0, 255, (128,), np.uint8)
obs_type="grayscale" -> Box(0, 255, (210, 160), np.uint8)，这是“rgb”类型的灰度版本

请参阅变体部分，了解每个环境ID默认使用的观察类型。

变体¶

VideoPinball 有以下几种环境 ID 变体，它们在观察、跳帧数量和重复动作概率方面有所不同。

环境-ID	obs_type=	frameskip=	repeat_action_probability=
VideoPinball-v0	`"rgb"`	`(2, 5)`	`0.25`
VideoPinball-ram-v0	`"ram"`	`(2, 5)`	`0.25`
VideoPinball-ramDeterministic-v0	`"ram"`	`4`	`0.25`
VideoPinball-ramNoFrameskip-v0	`"ram"`	`1`	`0.25`
VideoPinballDeterministic-v0	`"rgb"`	`4`	`0.25`
VideoPinballNoFrameskip-v0	`"rgb"`	`1`	`0.25`
VideoPinball-v4	`"rgb"`	`(2, 5)`	`0.0`
VideoPinball-ram-v4	`"ram"`	`(2, 5)`	`0.0`
VideoPinball-ramDeterministic-v4	`"ram"`	`4`	`0.0`
VideoPinball-ramNoFrameskip-v4	`"ram"`	`1`	`0.0`
VideoPinballDeterministic-v4	`"rgb"`	`4`	`0.0`
VideoPinballNoFrameskip-v4	`"rgb"`	`1`	`0.0`
ALE/VideoPinball-v5	`"rgb"`	`4`	`0.25`
ALE/VideoPinball-ram-v5	`"ram"`	`4`	`0.25`

难度和模式¶

可以通过关键字参数 difficulty 和 mode 指定环境的多种风格。风格是游戏模式和难度设置的组合。下表列出了可能的难度和模式值以及默认值。

可用模式	默认模式	可用难度	默认难度
`[0, 2]`	`0`	`[0, 1]`	`0`

版本历史¶

关于版本和配置之间复杂差异的详细讨论，可以在关于Atari环境的通用文章中找到。

v5: 粘性功能被重新加入，随机跳帧功能被移除。环境现在位于“ALE”命名空间中。
v4: 动作的粘性已被移除
v0: 初始版本发布