Pymunk弹球开发：碰撞时修改被撞bumper形状颜色问题

问题根源 #

当前代码存在两个直接导致功能异常的问题：

• 碰撞处理器绑定的碰撞类型不匹配：定义的小球碰撞类型为0、bumper碰撞类型为3，但代码里绑定的是COLLTYPE_BALL和COLLTYPE_GOAL的碰撞，没有正确匹配bumper的碰撞类型。
• 改色操作引用了错误的对象：回调中修改的shape2是bumper创建循环结束后留存的最后一个bumper的全局引用，不是实际触发碰撞的bumper实例，所以永远只有最后创建的单个bumper会变色。
• 碰撞回调参数顺序错误：Pymunk碰撞回调固定第一个参数为arbiter对象，原代码把space放在第一个参数位置，无法正确读取碰撞信息。

修复实现 #

1. 定义统一碰撞类型常量 #

COLLTYPE_BALL = 0
COLLTYPE_BUMPER = 3

2. 修正Bumper创建逻辑（支持自定义标识） #

Pymunk的形状对象支持直接挂载自定义属性，不需要特殊API即可给形状加名称标识：

bumper_positions = [(230, 100), (370, 100), (300, 140)]
for bumper_id, pos in enumerate(bumper_positions):
    body = pymunk.Body(body_type=pymunk.Body.KINEMATIC)
    body.position = pos
    bumper = pymunk.Circle(body, 20)
    bumper.elasticity = 1.5
    bumper.collision_type = COLLTYPE_BUMPER
    bumper.color = (31, 163, 5, 255)
    bumper.name = f"bumper_{bumper_id}"  # 自定义标识字段，可按需赋值
    space.add(body, bumper)

3. 修正小球创建逻辑 #

mass = 1
radius = 14
inertia = pymunk.moment_for_circle(mass, 0, radius, (0, 0))
ballbody = pymunk.Body(mass, inertia)
ballbody.position = 500, 460
shape1 = pymunk.Circle(ballbody, radius, (0, 0))
shape1.elasticity = 0.96
shape1.collision_type = COLLTYPE_BALL
space.add(ballbody, shape1)
balls.append(shape1)

4. 正确编写碰撞回调 #

碰撞回调的arbiter参数会携带本次碰撞的全部信息，其中arbiter.shapes会按碰撞处理器传入的类型顺序返回两个碰撞的形状对象，直接取对应bumper修改即可：

def bounceOnBumpers(arbiter, space, data):
    # 两个形状的顺序和add_collision_handler传入的碰撞类型顺序一致
    ball, hit_bumper = arbiter.shapes
    # 可直接读取自定义的名称标识
    print(f"碰撞到的bumper标识：{hit_bumper.name}")
    # 修改被碰撞bumper的颜色
    hit_bumper.color = (0, 255, 0, 255)
    # begin回调必须返回True，否则物理引擎不会计算本次碰撞的弹力等物理响应
    return True

# 绑定正确的碰撞类型对
collision_handler = space.add_collision_handler(COLLTYPE_BALL, COLLTYPE_BUMPER)
collision_handler.begin = bounceOnBumpers

如果需要实现碰撞后bumper颜色延时恢复的效果，可在回调中加定时任务，到时把对应bumper的颜色改回初始绿色即可。

内容的提问来源于stack exchange，提问作者ghost21blade