如何在Pygame事件循环外获取Xbox控制器输入并解决代码报错

报错原因 #

你直接调用了pygame.joystick.Joystick类的get_button方法，但get_button是实例方法，必须先创建Joystick对象实例才能调用，不能直接通过类调用，这就是触发AttributeError的原因。

正确实现步骤 #

1. 初始化手柄模块与实例 #

在游戏启动的初始化阶段，必须先初始化Pygame的手柄模块，并创建手柄实例（需检查是否有手柄连接）：

import pygame
pygame.init()

# 初始化手柄模块
pygame.joystick.init()

# 获取已连接的手柄数量，创建第一个手柄实例
joystick = None
if pygame.joystick.get_count() > 0:
    joystick = pygame.joystick.Joystick(0)
    joystick.init()

2. 修改Player类的get_input方法 #

整合手柄与键盘输入逻辑，满足「事件循环外获取输入」的需求（get_axis()和get_button()都是实时获取状态的方法，无需依赖事件）：

def get_input(self):
    # 先重置方向，避免输入冲突
    self.direction.x = 0

    # 手柄输入逻辑（仅当有手柄连接时执行）
    if joystick is not None:
        # 左摇杆X轴控制左右（轴索引0，返回值范围-1到1）
        left_stick_x = joystick.get_axis(0)
        # 设置死区，过滤摇杆微小偏移导致的误触发
        DEAD_ZONE = 0.2
        if abs(left_stick_x) > DEAD_ZONE:
            self.direction.x = left_stick_x
        else:
            self.direction.x = 0

        # Xbox A键（按钮索引0）触发跳跃，和键盘跳跃逻辑一致
        if joystick.get_button(0) and self.on_ground:
            self.jump()

    # 键盘输入逻辑（手柄无输入时生效，避免冲突）
    keys = pygame.key.get_pressed()
    # 合并左右方向键的判断
    right_pressed = keys[pygame.K_RIGHT] or keys[pygame.K_d]
    left_pressed = keys[pygame.K_LEFT] or keys[pygame.K_a]
    
    if right_pressed and not left_pressed and self.direction.x == 0:
        self.direction.x = 1
    elif left_pressed and not right_pressed and self.direction.x == 0:
        self.direction.x = -1
    elif right_pressed and left_pressed:
        self.direction.x = 0

    # 键盘跳跃
    if keys[pygame.K_SPACE] and self.on_ground:
        self.jump()

关键细节说明 #

• 摇杆死区：摇杆会存在微小的硬件偏移，设置死区（比如0.2）可以避免玩家未操作时角色自动移动。
• 输入优先级：上述代码中手柄输入优先，当摇杆有有效输入时，键盘方向控制不会生效；如果需要两者叠加，可以调整逻辑。
• 按钮索引：Xbox手柄的常用按钮索引：A键=0，B键=1，X键=2，Y键=3，左肩键=4，右肩键=5，左摇杆按下=6，右摇杆按下=7，菜单键=8，主页键=9。
• 事件循环外使用：get_axis()和get_button()方法与key.get_pressed()逻辑一致，都是直接读取当前硬件状态，无需放在事件循环内。

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