uosc项目中鼠标光标位置冻结问题的分析与解决

问题现象

在使用uosc（一个mpv播放器的现代化用户界面）时，用户报告了一个关于鼠标光标位置的异常行为。当视频播放时（暂停状态下不会触发），如果用户快速将鼠标光标移出mpv播放器窗口，光标位置会被冻结在最后检测到的位置。这种现象会导致UI元素（如按钮高亮、缩略图显示等）在窗口调整大小时出现异常响应。

环境条件

该问题在特定配置下更容易复现：

• 必须启用video-sync=display-resample选项
• 视频必须处于播放状态（暂停时不会触发）
• 需要配合hwdec=d3d11va硬件解码选项（使用其他解码方式如dxva2或no时也能复现，但难度更高）

技术分析

经过深入排查，发现问题根源在于uosc对鼠标位置事件的处理逻辑。在uosc 4.6.0版本引入的一个变更（特别是与触摸屏支持相关的代码）导致了这一行为。

关键问题出现在cursor.lua文件中的鼠标位置处理函数。原始代码通过检查cursor.hover_raw和mouse.hover状态来判断光标是否离开窗口，但这种判断方式在某些情况下（特别是快速移动光标时）会导致状态检测不准确。

解决方案

经过多次测试和验证，最终确定以下修复方案：

function handle_mouse_pos(_, mouse)
    if not mouse then return end
    if cursor.hover_raw and not mouse.hover then
        cursor:leave()
    elseif not cursor.hover_raw and mouse.hover then
        cursor:move(mouse.x, mouse.y)
    end
    cursor.hover_raw = mouse.hover
end

这个修改确保了：

1. 当光标确实离开窗口时（cursor.hover_raw为true且mouse.hover为false），正确触发离开事件
2. 当光标进入窗口时（cursor.hover_raw为false且mouse.hover为true），正确更新光标位置
3. 避免了在快速移动光标时可能出现的状态误判

影响范围

该问题影响uosc 4.6.0及以上版本，在多种mpv版本（从0.33.0到0.39.0）中均能复现。修复后测试表明：

• 解决了光标位置冻结的问题
• 不影响原有的触摸屏支持功能
• 保持了UI对鼠标事件的正常响应

结论

这个案例展示了在多媒体播放器UI开发中，处理输入事件时需要特别注意边界条件和状态转换。特别是在涉及硬件加速、视频同步等复杂场景时，输入事件的处理可能会受到渲染管线的影响。通过精确的状态管理和事件过滤，可以确保用户交互的流畅性和准确性。