Mayflash Dolphinbar使用指南-一起DIY吧

📖 本文由 Batocera 官方 Wiki 翻译整理，内容可能随版本更新而变化。

传奇外设：Mayflash Dolphinbar 棒状感应器

（该部分内容正在建设中，敬请期待）

如果你使用的是 Batocera v35 或更高版本，且主要目的是玩怀旧的光枪类游戏，我们建议你优先查看专门的“光枪（Light gun）”专题页面。如果你仍在使用老旧硬件，或者只打算玩 Wii 游戏，本页面的内容依然对你有效。

推荐学习： 建议观看 Batocera Nation 制作的高质量光枪教程（第二部分）。

什么是光枪游戏？

有些游戏需要使用一种能对准屏幕瞄准的特殊外设，这就是“光枪”。

生活化类比：这就像是早期的电子打靶。在街机厅里，机器会用专门的追踪技术来“盯着”你的枪口指哪儿；而在老式的大头电视（CRT）时代，每当你扣动扳机，屏幕就会闪一下，系统通过捕获这一闪而过的信号来判断你是否击中了目标。

【注意】由于现代液晶屏幕（LCD）的显示原理完全不同，老式光枪技术在现代屏幕上是无法直接使用的。

幸运的是，凭借“现代科技”的力量，我们在玩模拟器游戏时，不再需要那些笨重的原始设备就能重温当年的射击快感。

核心原理：把鼠标变成光枪

为了模拟那些经典的光枪硬件，大多数模拟器都巧妙地利用了电脑上最常见的配件：鼠标。正因如此，Batocera 默认会将系统的光标（Cursor）作为模拟光枪的媒介——无论你实际上是用什么设备在控制这个光标。

在各种玩法中，最著名的例子莫过于使用 Wii 遥控器（Wiimote） 配合 DolphinBar 接收棒 来模拟鼠标操作。

关键更新：保护你的硬件

由于红外线 LED 灯管（IR LEDs）长时间常亮会导致烧毁，DolphinBar 在 2015 年底发布的 v5 版本固件 中加入了一个非常实用的智能控制功能。

生活化类比：这就像是声控灯。比起那些不管有没有人、定时就关掉的“笨”感应灯，DolphinBar 现在的版本更像是一个聪明的管家——只有当你真正拿起 Wii 遥控器准备玩游戏时，它才会点亮红外灯；当你放下遥控器或切换到不需要指向的功能时，它就会自动熄灯休息。

【提示】固件升级建议
早期的感应棒经常会因为固定时间关机而造成不便，但升级了固件的 DolphinBar 能精准感知遥控器的使用状态。如果你还没有将你的设备更新到支持此功能的版本，我们强烈建议你下载 W010 固件 进行升级，以延长设备寿命。

进一步排查与帮助

如果你在配置过程中遇到困难，或者想了解更多高级技巧：

第一步：查看设备说明
前往专题页面了解 DolphinBar 的四种工作模式。
第二步：反馈问题
如果教程中有些内容让你感到困惑，欢迎在评论区或社区反馈。

进阶操作：使用 DolphinBar 适配 Wii 遥控器

在开始配置之前，有一个非常实用的建议：即便你已经有了专门的光枪模拟外设，手边最好还是准备一个传统的现代控制器（Controller）或键盘。

【提示】这样做是为了确保你能随时使用 Batocera 的热键快捷操作（Hotkey Shortcuts），比如当你玩累了想退出游戏时，传统手柄会比光枪好用得多。

什么是 DolphinBar？

DolphinBar 是一种蓝牙感应器（Bluetooth Sensor），它的作用是将 Wii 遥控器（Wiimote）连接到电脑上。它拥有专门的工作模式，可以直接把遥控器的指向动作转换成鼠标（Mouse）信号。

生活化类比：你可以把它看作是一个“翻译官”。它内置了两个红外灯（IR lamps），就像原版 Wii 游戏机上的感应条一样，为 Wii 遥控器提供定位参考。其中最出名的型号是 Mayflash W010，价格亲民（约 20 欧元/美元）且上手非常简单。

配置前的“心理预期”

如果你决定采用这套方案，请先管理好自己的期望值。由于 Wii 遥控器的红外摄像头精度有限，且视野范围（Field of View）比较窄，在所有的光枪模拟方案中，它的准确度其实是垫底的。

不过，它的优点也非常突出：
* 门槛最低：它是目前最容易买到、成本最低的选择。
* 维护简单：设置非常轻松，而且坏了也很容易维修。

有了它，你再也不用忍受那些繁琐且反人类的模拟调试了。

核心技术：让抖动的光标变平滑

Wii 遥控器（Wiimote）内置的红外摄像头在捕捉固定点位时表现其实相当糟糕。

生活化类比：这就像是用没带防抖功能的手机拍远景，画面总会不自觉地晃动。

为了解决这个问题，当年的 Wii 主机在系统里内置了一套非常强悍的平滑算法（Smoothing Algorithm）来稳定屏幕上的光标。好在现在的现代模拟器也都继承了这项“防抖”技术，让操作不再飘忽不定。

智能保护：延长硬件寿命

【提示】早期的感应条经常因为红外 LED 灯管（IR LEDs）长时间常亮而导致过热烧毁。

针对这一痛点，Mayflash 在 2015 年底发布的 v5 版本固件中加入了一个聪明的管家：只有当它检测到 Wii 遥控器正在连接使用，且处于需要指向功能的模式时，才会点亮红外灯。一旦检测到没有连接或处于非指向模式，它就会自动关灯休息。这种基于使用状态的控制，比老式那种机械的定时关灯要靠谱得多。建议用户前往官网下载 W010 固件进行更新。

第一阶段：Mayflash 感应条的物理安装

想要让光枪跑起来，我们分步骤完成基础连接：

第一步：连接电源
将 Mayflash 感应条的 USB 线插入电脑。然后找到机身背面的电源开关（Power Switch）并将其拨至开启状态。
第二步：确认状态
通电成功后，你会看到设备顶部亮起一颗蓝色的 LED 指示灯。
第三步：选择摆放位置
根据你感应条实际摆放的位置，通过开关选择 TOP（顶部） 或 BOTTOM（底部）。

【提示】为了获得最佳的瞄准体验，建议将感应条放在屏幕上方，并选择 TOP 选项。

第二阶段：配对你的 Wii 遥控器（Syncing）

现在我们需要让遥控器和感应条“握个手”，建立连接。

方案一：永久配对（推荐）

如果你打算长期在这个感应条上使用该遥控器，请按照以下步骤操作。配对成功后，即便重启电脑，系统也会记住这个连接。

第一步：开启感应条配对模式
按下 Mayflash 感应条左侧的 SYNC（同步）按钮。
第二步：触发遥控器同步信号
打开 Wii 遥控器背面的电池盖，按下那个红色的 SYNC（同步）小按钮。

通常情况下，遥控器会瞬间与感应条完成配对。

方案二：临时配对

如果你只是偶尔在这台机器上玩玩，不想覆盖遥控器原本在其他设备（比如原版 Wii 主机）上的配对信息，可以使用这个临时模式：

第一步：开启感应条配对模式
同样先按下 Mayflash 感应条左侧的 SYNC 按钮。
第二步：使用组合键连接
同时按下 Wii 遥控器上的 1 和 2 键。
第三步：确认连接成功
观察感应条上的 LED 灯停止闪烁，且遥控器上的 1、2 号灯或 1、4 号灯变为常亮状态，即表示连接成功。

生活化类比：这就像是蓝牙耳机的“常规连接”与“访客连接”。永久配对是让它们成为老夫老妻，以后开机即连；临时配对则像是在朋友家借用，走后互不打扰。

一切准备就绪，你现在可以开始享受游戏了，无需进行额外设置！

【注意】关于“原始输入（Raw Input）”驱动程序是否能支持多鼠标模拟（Multi-mouse Emulation），目前相关信息的适用性仍在确认中。

如何实现双人对战？

如果你想和小伙伴一起玩 双人光枪游戏（2 player Lightgun），你需要准备两根 DolphinBar 接收棒。

生活化类比：这就像是一条跑道只能跑一辆车，当 DolphinBar 处于“键盘鼠标模式”时，它一次只能配对并处理一个 Wii 遥控器的信号。

【提示】建议将两根感应棒分别放置在电视的顶部和底部，并记得拨动 Mayflash 感应棒背后的位置切换按钮（Top/Bottom）进行对应设置。

模式切换指南（Modes）

Mayflash 感应条共有四种工作模式。你可以通过轻按设备顶部的 MODE 按钮在它们之间循环切换。对于大多数模拟系统，我们只需要关注以下两种模式，它们都会将 Wii 遥控器的指向信号作为鼠标信号（Mouse signals）发送给电脑：

模式 1（MODE 1）

适用场景：仅使用 Wii 遥控器，不连接 左右手柄中的双节棍手柄（Nunchuk）。
状态显示：设备上的 LED 1 + 2 或 1 + 3 会亮起。
快捷操作：你可以通过同时按下遥控器上的 [HOME] + 方向键下 来切换子模式。

按键映射参考：
Trigger（扳机） = joystick_button[0,left] A键 = joystick_button[0,right] Home键 = keyboard[0,lwin] plus（+号键） = ? minus（-号键） = ? 1键 = pgup 2键 = pgdn

模式 2（MODE 2）

适用场景：当你需要配合使用 双节棍手柄（Nunchuk）时选择此模式。
状态显示：LED 1 + 4 会亮起。
功能优势：双节棍手柄（Nunchuk） 能提供更多的实体按键，方便你为系统绑定更多的功能指令。

按键映射参考：
Trigger（扳机） = joystick_button[0,1] A键 = joystick_button[0,2] Home键 = keyboard[0,lwin] plus（+号键） = enter minus（-号键） = esc 1键 = ? 2键 = ?

在模式 2 下，Wii 遥控器的 [-] 按钮 会映射为键盘上的 [Esc] 键，在大多数情况下，按下它即可直接退出当前运行的模拟器。

模式 3（MODE 3）：变身为通用手柄

如果你将 DolphinBar 切换到 模式 3，它可以把 Wii 遥控器、双节棍手柄（Nunchuk）或者 Wii 经典手柄（Wii Classic Controller）模拟成一个标准的 GameCube 游戏手柄。

生活化类比：这就像是给 Wii 遥控器套上了一层“通用外壳”，让它伪装成普通电脑手柄。在 Batocera 中，你可以像配置其他手柄一样对它进行按键映射。如果你手边没有其他控制器，这个模式能解你的燃眉之急。

【注意】虽然这三种手柄在模式 3 下都能用，但它们的按键布局大不相同（甚至连方向键的定义都不一样）。由于系统会将它们统一识别为 “HJZ Mayflash Wiimote PC Adapter”，因此每当你更换连接的手柄类型时，都需要在 Batocera 中重新调整你的控制器配置。

模式 4（MODE 4）：Wii 专用模式

这是专为 Wii 模拟器设计的原生模式。它允许 Dolphin 模拟器直接与 Wii 遥控器“对话”，但这也意味着你无法在 Batocera 的系统菜单（ES 界面）中使用遥控器进行操作。

操作步骤：

第一步：切换模式
按下 DolphinBar 右侧的按钮，将模式切换至 MODE 4。
第二步：启动游戏
使用一个传统的普通手柄在 ES 界面中启动你想玩的 Wii 游戏。
第三步：永久配对（如果尚未连接）
打开 Wii 遥控器背面的电池盖，按住内部红色的 SYNC（同步）按钮。当遥控器上的 LED 指示灯开始闪烁时，即表示正在尝试连接。

【提示】在此模式下，你需要手边同时准备好传统手柄（用于选图）和 Wii 遥控器（用于游玩）。

临时配对 Wii 遥控器：
- 第一步：触发连接信号
  在 Wii 遥控器上同时按住 [1] 和 [2] 键，你会看到遥控器上的 LED 指示灯开始闪烁。
- 第二步：等待自动连接
  保持耐心，直到 LED 灯停止闪烁。此时，遥控器已成功连接至模拟的 Wii 系统。

模拟器配置指南

你可能想问：能不能直接看到所有相关游戏？答案是肯定的！你可以通过以下路径开启光枪游戏合集：
游戏合集设置（GAME COLLECTION SETTINGS） -> 自动游戏合集（AUTOMATIC GAME COLLECTIONS） -> 光枪游戏（LIGHTGUN GAMES）。

关于“抖动”问题的说明

DolphinBar 会将自己伪装成一个电脑远程控制器（PC Remote Controller）来模拟鼠标和键盘。

生活化类比：这就像是你在用激光笔指着远处的屏幕，手部微小的肌肉颤动都会被放大。

在光枪模拟领域，这种“抖动（Jitter）”是一个根深蒂固的问题——无论你离感应条多远或多近，光标总会显得有些摇摆。不过别担心，Mayflash 在优化算法方面做得非常出色，已经最大程度地减轻了这种现象带来的干扰。

MAME 模拟器配置

（适用于绝大多数 2D 街机游戏）

在初始状态下，系统仅配置了移动和第一个射击按键。如果你需要使用次要攻击/第二射击键（Second Shot），请按照以下步骤操作：

第一步：调出设置菜单
在游戏中同时按下 SELECT + B 组合键呼出 Libretro 菜单。
第二步：开启管理权限
进入选项（Options），找到并开启 显示 MAME 菜单（Show MAME Menu） 功能。
第三步：自定义按键
现在你可以进入 MAME 的原生菜单，将 Wii 遥控器上的其他闲置按键分配给“第二射击”功能了。

【提示】通过这种方式，你可以根据自己的手感习惯，把各种特殊操作绑定到最舒服的按键上。

除了射击键，你还可以尝试将遥控器上的其他按键映射为投币（Insert Coin）和开始游戏（Start）。

【提示】如果你发现 Wii 遥控器上的按键不够用，无法配置所有功能，别忘了你的第一个游戏手柄（Gamepad）始终是处于激活状态的。你可以一边用手柄来操作菜单、投币或开始，一边用光枪进行射击。当然，你依然可以随时按下 SELECT + B 组合键来呼出 Libretro 菜单。

FCEUMM 模拟器配置

（适用于 NES/红白机游戏，例如《打鸭子》Duck Hunt）

要在该模拟器上正常使用光枪，请呼出 Libretro 菜单并按以下步骤确认设置：

第一步：设置模拟方式
进入选项（Options），将 光枪模式（Zapper Mode） 设置为 mouse（鼠标）。
第二步：显示瞄准准星
在同菜单下，将 显示准星（Show Cross Air） 设为 True（开启）。
第三步：确认设备类型
进入控制（Controls），确保 用户 1 设备类型（User 1 Device Type） 设置为 Auto（自动）。

生活化类比：在 FCEUMM 模拟器中，光标的抖动会比 MAME 明显得多。这就好比你在大风天里端着枪瞄准，虽然准星一直在晃，但只要掌握好节奏，依然可以正常玩耍。

【提示】如果你将“光枪模式”切换为 Lightgun，抖动会奇迹般地消失，画面非常稳。但遗憾的是，目前这样做会导致你无法通过 Wii 遥控器的任何按键触发射击。

Nestopia 模拟器配置

（待完善）

配置思路如下：
* 控制设置：将端口 1（Port 1）设为常规手柄，端口 2（Port 2）设为 光枪（Zapper）。
* 选项设置：开启 显示准星（Show Crosshair）。
* 设备选择：将光枪设备（Zapper device）关联到 指针（Pointer）。

GenesisPlusGX 模拟器配置

（适用于世嘉 Master System 和 MD 游戏）

为了方便瞄准，你需要开启准星显示。操作步骤如下：

第一步：进入高级设置
在系统中找到 高级系统选项（ADVANCED SYSTEM OPTIONS）。
第二步：激活准星
找到 显示准星（SHOW CROSSHAIR） 选项并将其设置为开启状态。

关于控制器类型，我们需要确保配置正确：

第一步：设定设备类型
进入控制（Controls）设置，将 用户 1 设备类型（User 1 Device Type） 设为 MS 光枪（MS Light Phaser）。

【提示】关于如何映射特定的射击按键以及如何开启多人对战模式，相关细节仍待进一步补充。

SNES9X 模拟器配置

（适用于 SNES/超任游戏）

如果你想在超任模拟器上愉快地“打靶”，请按以下步骤操作：

第一步：开启准星
在高级系统选项（ADVANCED SYSTEM OPTIONS）中，将显示准星（SHOW CROSSHAIR）选项设为开启。
第二步：模拟超级瞄准镜
进入控制（Controls）设置，将 用户 2 设备类型（User 2 Device Type） 设为 超级瞄准镜（SuperScope）。

Yabasanshiro 模拟器配置

（适用于世嘉土星 Sega Saturn 游戏）

（待完善）
初步配置思路如下：
* 设备类型：在控制端口 1（Port 1）中，将设备类型设为 Virtua Gun。
* 准星设置：在选项的输入（Input）设置中，找到并开启 光枪准星（Gun Crosshair）。

Model2Emu 模拟器配置

（适用于世嘉 Model 2 游戏，这是最早的一批 3D 街机光枪游戏）

第一步：加载游戏
在配置界面通过 Load Rom... 运行你的游戏。
第二步：基础按键映射
按下 Esc 键，选择 Game -> Configure Controls...，向下滚动找到 Player 1 Start 和 Coin。
第三步：映射快捷键
建议将 开始（START） 和 投币（Coin） 分别映射到遥控器的 1 和 2 键。

【提示】在默认设置下，A 键 会自动绑定为装弹（Reload），B 键 则自动绑定为射击（Shoot）。此外，别忘了在光枪设置中进行光枪校准（Gun Calibration）。

Supermodel 模拟器配置

（适用于世嘉 Model 3 游戏）

第一步：显示辅助准星
在高级系统设置中，将 准星（Crosshairs） 设为 开启（ON）。
第二步：进入服务菜单
在游戏中按下键盘上的 7 进入服务菜单，按下 8 向下移动光标。
第三步：校准设备
进入 AIM SET 测试输入，然后选择 CALIBRATION TEST 或 SETUP CALIBRATION。

生活化类比：这就像是第一次用新手机指纹解锁，你需要按照系统的提示，对着屏幕的不同角度进行几次点击，让模拟器“记住”你的瞄准习惯。请严格遵循屏幕上出现的校准指令完成操作。

Flycast 独立版模拟器（Flycast standalone）

（适用于世嘉 Dreamcast、Naomi 以及 Sammy Atomiswave 街机平台）

（内容正在建设中）

Flycast Libretro 核心版