本文介绍如何在使用 inputs.get_gamepad() 等阻塞式 I/O 的场景下，通过非阻塞轮询 + 热键监听机制，实现任意时刻按「q」键立即终止录制循环，避免因等待控制器事件而延迟响应。
本文介绍如何在使用 `inputs.get_gamepad()` 等阻塞式 i/o 的场景下，通过非阻塞轮询 + 热键监听机制，实现任意时刻按「q」键立即终止录制循环，避免因等待控制器事件而延迟响应。
在游戏手柄输入录制类应用中，一个常见痛点是：inputs.get_gamepad() 默认为阻塞调用——它会挂起当前线程，直到有手柄事件发生才返回。这导致主循环无法及时响应键盘中断（如按「q」停止），必须等到下一次手柄动作后才能检查退出条件，严重损害交互实时性。
要实现“按下即停”，关键在于解除 get_gamepad() 的阻塞依赖，改用非阻塞轮询 + 外部热键协同控制。核心思路是：
- 使用
keyboard.add_hotkey()注册全局热键（如'q'），异步修改共享状态变量； - 主循环中不依赖阻塞等待，而是持续快速轮询（即使无事件也立即返回）；
- 配合
try/except捕获异常（如手柄断开、用户中断），确保健壮性。
以下是完整可运行的解决方案：
import inputs
import keyboard
recording = False # 初始状态：未录制
def toggle_record():
"""切换录制状态：启动或停止"""
global recording
if not recording:
recording = True
print("✅ Recording started... Press 'q' again to stop.")
else:
recording = False
print("⏹️ Recording stopped.")
def record():
"""主录制逻辑：非阻塞轮询 + 实时状态检查"""
print('Press "q" to start recording.')
# 等待首次按下 'q' 启动（避免忙等，使用 is_pressed 配合短延时更佳）
while not keyboard.is_pressed('q'):
pass
toggle_record() # 启动录制
# 核心循环：每轮均快速检查 recording 状态，不依赖事件触发
while recording:
try:
# ⚠️ 关键：inputs 库本身不提供原生非阻塞模式，
# 但可通过设置超时或捕获异常模拟“快速返回”效果。
# 此处使用默认调用（实际仍可能微阻塞），因此需配合高频检查。
events = inputs.get_gamepad()
for event in events:
print(f"[{event.timestamp:.3f}s] {event.code}: {event.state}")
except inputs.UnpluggedError:
print("⚠️ Controller unplugged.")
break
except Exception as e:
print(f"❌ Unexpected error: {e}")
break
# 注册热键：按 'q' 切换状态（支持任意时刻触发）
keyboard.add_hotkey('q', toggle_record)
# 启动主流程
if __name__ == "__main__":
try:
record()
except KeyboardInterrupt:
print("\n? Exiting gracefully.")
finally:
keyboard.unhook_all() # 清理热键监听器✅ 关键优化说明：
keyboard.add_hotkey()在独立线程中监听系统级按键，完全不阻塞主循环；toggle_record()是线程安全的状态切换（仅操作布尔变量，无竞态风险）；- 主循环中
while recording:的判断频率远高于手柄事件频率，确保响应延迟通常- 添加
UnpluggedError和通用异常处理，防止手柄意外断开导致程序崩溃。
⚠️ 注意事项：
-
inputs.get_gamepad()在 Windows 下底层基于GetRawInputData，无官方非阻塞 API。若对毫秒级响应有严苛要求，建议迁移到pygame.joystick（支持joystick.get_hat()等轮询接口）或使用libusb自定义驱动； -
keyboard模块需管理员权限（Windows）或辅助功能授权（macOS）才能监听全局热键，请确保运行环境已正确配置； - 多线程环境下若需扩展更多共享状态（如日志队列、时间戳缓冲区），应使用
threading.Lock或queue.Queue保障线程安全。
通过该方案，你将获得真正“即时响应”的录制控制体验——无论手柄是否处于活跃状态，按下「q」键的瞬间，循环即刻退出，大幅提升开发与调试效率。
