画质选项缺失时，应依次检查html5播放器启用状态、清除相关缓存、禁用广告屏蔽扩展、强制重载清晰度控件、调整浏览器渲染设置。
如果您在学堂在线网页版观看课程视频时发现画质选项（如标清、高清、超清）缺失，无法手动切换清晰度，则可能是由于页面脚本异常、播放器控件未加载或浏览器兼容性问题导致。以下是修复此问题的步骤：
一、检查并启用HTML5播放器
学堂在线依赖HTML5视频播放器提供清晰度切换功能，若浏览器仍使用旧版Flash播放器或禁用了HTML5支持，画质选项将不显示。需确保当前使用标准HTML5播放环境。
1、在视频播放页面右键点击视频区域，确认弹出菜单中包含“关于HTML5”或未出现“关于Adobe Flash Player”字样。
2、若显示Flash相关选项，访问浏览器设置，禁用所有Flash插件，并强制启用HTML5播放。
3、访问https://html5test.com验证浏览器HTML5支持得分是否高于450分，低于该值可能影响播放器控件渲染。
二、清除视频播放相关缓存与本地存储
浏览器可能缓存了损坏的播放器配置或过期的CDN资源，导致清晰度选择器DOM节点未注入。需清理特定作用域下的临时数据以恢复控件加载逻辑。
1、按 Ctrl+Shift+Delete（Windows/Linux）或 Cmd+Shift+Delete（macOS）打开清除浏览数据面板。
2、时间范围选择“所有时间”，勾选“Cookie及其他网站数据”、“缓存的图片和文件”、“媒体许可证”三项。
3、在“网站”栏输入 xuetangx.com 或 cdn.xuetangx.com，点击“清除数据”。
4、关闭全部学堂在线标签页，重新打开并登录后进入课程视频页验证。
三、禁用广告屏蔽与脚本拦截扩展
部分广告过滤工具（如uBlock Origin、AdGuard）会误判学堂在线的清晰度切换JS模块为追踪脚本并阻止其执行，造成画质按钮不可见。需临时放行核心播放域资源。
1、点击浏览器右上角扩展图标，找到正在运行的广告屏蔽或脚本管理类插件。
2、点击其面板中的“禁用此站点”或“暂停在当前网站运行”选项。
3、刷新页面后，右键视频区域，检查是否出现“清晰度”或“设置”按钮；若出现，说明扩展干扰已确认。
4、如需长期使用该扩展，进入其高级设置，在自定义过滤规则中添加：@@||xuetangx.com/*/player-*.js$script 和 @@||cdn.xuetangx.com/*/videojs-*.js$script。
四、强制触发清晰度控件重载
学堂在线前端采用懒加载策略，部分课程页在初始渲染时未立即初始化清晰度选择器。可通过开发者工具手动调用播放器API使其显式挂载。
1、在视频播放页面按 F12 打开开发者工具，切换至 Console 标签页。
2、粘贴以下代码后回车执行：if (window.videojs && window.player) { window.player.qualityLevels(); window.player.controlBar.addChild('QualitySelector'); }
3、若控制台返回 undefined 且视频右下角出现齿轮图标，点击即可展开清晰度菜单。
4、如提示 player is not defined，等待3秒后再次执行，或先运行 window.player = videojs('course-video'); 再执行上一步。
五、更换浏览器内核或启用兼容模式
部分Chromium 120+版本存在Web Components升级引发的Shadow DOM渲染异常，导致video.js插件的QualitySelector组件无法正确投影到页面。可尝试降级渲染路径或切换引擎。
1、在地址栏输入 chrome://flags/#enable-blink-features（Chrome/Edge），搜索 Blink Features。
2、将该项值修改为 Disabled，重启浏览器。
3、或改用Firefox浏览器访问，地址栏输入 about:config，将 media.videocontrols.picture-in-picture.video-toggle.enabled 设为 true 后刷新页面。
4、若仍无效，尝试在Edge中启用IE模式：点击地址栏右侧“…” → “更多工具” → “在Internet Explorer模式下重新加载”。
