Mixxx DJ软件中MIDI控制器配置确认弹窗问题分析

问题背景

在Mixxx DJ软件2.5.0版本中，当用户首次尝试进入"选项/偏好设置"时，系统会意外弹出一个确认对话框，提示用户保存未修改的控制器配置。这一现象发生在使用MIDI控制器映射的情况下，特别是当控制器脚本调用了makeInputHandler方法时。

技术原理

Mixxx的控制器系统通过XML文件定义控制器映射，并使用JavaScript脚本处理MIDI输入。makeInputHandler方法是MIDI控制器API的核心功能之一，它允许开发者注册回调函数来处理特定的MIDI消息。

问题的根源在于偏好设置对话框的脏标记检测逻辑。DlgPrefController::isDirty()方法错误地将未修改的控制器配置标记为"脏"(需要保存)，导致系统误认为用户进行了配置更改。

问题复现

要复现这个问题，需要以下两个关键文件：

1. 控制器脚本文件 (Demo-scripts.js):

var Demo = {
    init: () => midi.makeInputHandler(0x90, 0x01, (channel, control, value, status) => {})
};

2. 控制器映射文件 (Demo.midi.xml):

<?xml version="1.0" encoding="UTF-8"?>
<MixxxControllerPreset schemaVersion="1" mixxxVersion="2.5+">
  <info>
    <name>Demo Controller</name>
    <description>Demo Controller</description>
  </info>
  <controller id="DemoController">
    <scriptfiles>
      <file filename="Demo-scripts.js" functionprefix="Demo" />
    </scriptfiles>
   </controller>
</MixxxControllerPreset>

当这些文件被加载后，首次进入偏好设置时就会触发确认对话框。

影响范围

该问题影响所有使用MIDI控制器映射的用户，特别是在以下场景：

• 首次加载控制器配置后立即访问偏好设置
• 使用包含makeInputHandler调用的控制器脚本
• 在Ubuntu 24.04和Windows系统上均会出现

解决方案

该问题已被确认并修复。修复的核心是修正DlgPrefController::isDirty()方法的逻辑，使其能够正确识别真正的配置变更，而不是将初始化的控制器状态误认为用户修改。

用户建议

对于遇到此问题的用户，可以：

1. 等待官方发布包含修复的版本更新
2. 临时解决方案是忽略首次出现的确认对话框
3. 避免在不需要时频繁进入偏好设置界面

该修复已合并到主分支，将在后续版本中发布。这个问题展示了Mixxx开发团队对用户体验细节的关注，以及开源社区快速响应和解决问题的能力。