当前位置：首页 > news >正文

超过2000款手柄支持！SDL_GameControllerDB覆盖平台与设备清单

news 2026/5/23 5:16:45

超过2000款手柄支持！SDL_GameControllerDB覆盖平台与设备清单

【免费下载链接】SDL_GameControllerDBA community sourced database of game controller mappings to be used with SDL Game Controller functionality项目地址: https://gitcode.com/gh_mirrors/sd/SDL_GameControllerDB

SDL_GameControllerDB是一个社区维护的游戏控制器映射数据库，专为SDL2和SDL3游戏控制器功能设计。这个开源项目包含了超过2000款游戏手柄的配置文件，覆盖了从经典复古手柄到现代高端游戏控制器的完整支持列表。无论你是游戏开发者还是普通玩家，这个数据库都能让你的手柄在各种平台和游戏中获得最佳兼容性体验。🎮

📊 项目规模与统计

SDL_GameControllerDB目前包含2228个有效手柄映射配置，这些配置按照平台进行分类整理，确保每个手柄都能在对应的操作系统上正常工作。

主要平台覆盖

Windows- 主流游戏手柄支持最全的平台
Linux- 开源系统下的手柄兼容性解决方案
macOS- Mac用户的游戏控制器支持
Android- 移动设备的手柄映射
iOS- 苹果设备的手柄兼容性配置

🎯 支持的手柄品牌清单

主流游戏主机手柄

Sony PlayStation系列：PS4、PS5、PS3、PS2、PS1控制器
Microsoft Xbox系列：Xbox 360、Xbox One、Xbox Series X/S、Xbox Elite控制器
Nintendo任天堂系列：Switch Pro、Joy-Con、Wii、Wii U、GameCube、N64控制器
Valve Steam控制器：Steam Deck、Steam Controller

第三方品牌手柄

8BitDo系列：SN30、Pro 2、Ultimate、Lite 2、M30、N30等全系列产品
Logitech罗技：F310、F510、F710等经典游戏手柄
Razer雷蛇：Wolverine、Raiju、Atrox等专业电竞手柄
Hori：格斗手柄、街机摇杆等专业外设
PowerA：授权第三方手柄
Thrustmaster：飞行摇杆和赛车方向盘

复古与怀旧手柄

复古主机控制器：NES、SNES、Genesis/Mega Drive、Saturn、Dreamcast等
街机摇杆：各类USB街机摇杆和格斗手柄
特殊控制器：跳舞毯、光线枪、飞行摇杆等

SDL游戏控制器映射指南示意图 - 展示了标准Xbox布局的映射关系

🔧 如何使用这个数据库

快速集成方法

开发者只需要将 gamecontrollerdb.txt 文件下载到你的应用程序目录，然后在代码中加载即可：

// SDL2 SDL_GameControllerAddMappingsFromFile("gamecontrollerdb.txt"); // SDL3 SDL_AddGamepadMappingsFromFile("gamecontrollerdb.txt");

映射文件结构

每个手柄映射都遵循标准格式：

030000004c050000c405000000010000,PS4 Controller,a:b1,b:b2,back:b8,dpdown:h0.4,dpleft:h0.8,dpright:h0.2,dpup:h0.1,guide:b12,leftshoulder:b4,leftstick:b10,lefttrigger:a3,leftx:a0,lefty:a1,rightshoulder:b5,rightstick:b11,righttrigger:a4,rightx:a2,righty:a5,start:b9,x:b0,y:b3,platform:Mac OS X,

包含以下关键信息：

GUID：设备的唯一标识符
名称：手柄的友好名称
按钮映射：所有按钮和轴的功能对应关系
平台：该映射适用的操作系统

📁 项目文件结构

SDL_GameControllerDB项目结构简洁明了：

SDL_GameControllerDB/ ├── gamecontrollerdb.txt # 主数据库文件（包含2228个映射） ├── README.md # 项目说明文档 ├── mapping_guide.png # 映射指南示意图 ├── duplicates.py # 重复项检测脚本 └── LICENSE # 开源许可证