Jellyfin Android TV版刷新率切换问题分析与解决方案

Jellyfin Android TV版刷新率切换问题分析与解决方案

在Jellyfin Android TV客户端（版本17.1）中发现了一个与显示刷新率切换相关的技术问题。该问题主要影响Nvidia Shield Pro 2019等运行Android 9系统的设备，表现为播放停止后界面导航出现明显卡顿现象。

问题现象

当用户在设置中启用"刷新率切换"功能后：

1. 从媒体库播放视频文件时，系统会按预期切换到视频对应的刷新率
2. 停止播放并返回主界面时
3. 系统界面操作出现明显卡顿
4. 视觉上表现为刷新率未能正确恢复到播放前的状态

技术原理

Android系统的显示刷新率切换机制允许应用根据内容需求动态调整显示输出频率。对于视频播放场景，匹配视频原生帧率的显示刷新率可以带来更流畅的播放体验。Jellyfin客户端通过Android的DisplayManager API实现这一功能。

典型的工作流程应该是：

1. 播放开始时：保存当前刷新率 → 切换到视频帧率
2. 播放结束时：恢复保存的原始刷新率

问题根源

根据开发团队确认，问题出在播放停止后的刷新率恢复逻辑上。当前实现可能存在以下情况之一：

• 恢复原始刷新率的调用被意外跳过
• 恢复操作未能正确执行但未抛出错误
• 系统层面对恢复请求的响应处理异常

解决方案

开发团队已确认该问题并在后续版本中修复。修复方案可能包括：

1. 加强刷新率状态跟踪机制
2. 添加恢复失败时的回退处理
3. 优化与特定设备（如Nvidia Shield）的兼容性处理

用户建议

遇到此问题的用户可以：

1. 暂时禁用刷新率切换功能（设置 → 播放 → 匹配内容帧率）
2. 等待官方发布包含修复的更新版本
3. 关注项目更新日志以获取修复版本发布信息

该修复将确保播放结束后系统能正确恢复原始显示设置，消除界面卡顿现象，提升整体用户体验。