IINA播放器全屏模式下OSC控制栏失效问题分析

问题现象

在macOS 15.1.1系统环境下，IINA播放器1.3.5版本出现了一个影响用户体验的问题：当用户进入全屏模式后，鼠标移动时无法正常显示OSC（On Screen Controller）媒体控制栏。更严重的是，退出全屏模式后，OSC控制栏有时仍然无法恢复显示。

技术背景

IINA播放器提供了两种全屏模式实现方式：

1. 原生全屏模式：使用macOS系统提供的标准全屏API
2. 传统全屏模式（Legacy Full Screen）：IINA自定义实现的全屏方案

问题主要出现在传统全屏模式下。这个模式是通过动态修改窗口样式掩码（window style mask）实现的，具体涉及titled和borderless属性的切换。

问题根源

经过开发团队深入分析，发现这是macOS系统层的一个兼容性问题：

1. 在macOS Big Sur（11.0）版本中，苹果修改了全屏模式的实现机制，导致自定义全屏方案出现兼容性问题
2. 在macOS Sequoia（15.x）中，这个问题进一步恶化，影响了鼠标事件的正常传递
3. 当窗口样式掩码被修改后，AppKit框架有时无法正确恢复事件传递机制

解决方案

开发团队采取了以下措施解决这个问题：

1. 对于macOS 15.x用户，建议暂时禁用"使用传统全屏"选项
2. 在IINA 1.4.0-beta1版本中，通过优化窗口事件处理逻辑修复了此问题
3. 添加了特殊的鼠标事件处理逻辑作为临时解决方案

技术细节

问题的核心在于窗口样式掩码切换时的事件处理：

1. 进入全屏时会移除titled属性
2. 退出全屏时需要恢复titled属性
3. 在这个过程中，AppKit有时会丢失鼠标移动事件的处理能力

开发团队发现，当鼠标移动到屏幕顶部触发菜单栏显示后，OSC控制栏的显示/隐藏功能会恢复正常，这表明系统的事件处理机制存在状态不一致的问题。

后续发展

值得注意的是，在macOS 15.4版本中，开发团队又发现了类似但略有不同的问题表现，特别是在退出全屏模式后。这表明苹果仍在调整全屏相关的底层实现，可能需要持续关注和适配。

用户建议

对于遇到此问题的用户，可以采取以下措施：

1. 升级到IINA 1.4.0或更高版本
2. 如果必须使用传统全屏模式，可以尝试将鼠标移动到屏幕顶部触发菜单栏显示，这通常能恢复OSC功能
3. 关注后续版本更新，以获取更完善的全屏体验

这个问题展示了macOS系统升级对应用程序兼容性的挑战，也体现了开源社区通过协作解决问题的优势。IINA开发团队持续跟踪苹果系统的变化，努力为用户提供最佳的视频播放体验。