黑屏但有声是h.265编码不兼容、ts分片异常、pat/pmt损坏、硬件加速冲突或hls.js未接管所致：一、将摄像头编码改为h.264；二、用ffmpeg转码修复非标流；三、禁用浏览器/app硬件加速；四、确保hls.js正确加载并监听manifest_parsed事件。
当你在网页、APP或播放器中打开m3u8链接时，视频区域一片漆黑但音频正常播放，说明流媒体已成功拉取并解码音频轨，而视频帧未能渲染——这不是内容缺失，而是视频解码链路或渲染路径在某个环节被阻断。常见诱因包括H.265编码不兼容、TS分片伪装成图片、PAT/PMT表损坏、硬件加速冲突、跨域拦截或hls.js未正确接管。
确认是否为H.265编码导致的兼容性问题
绝大多数HTML5播放器（包括hls.js、video.js、DPlayer）默认只支持H.264解码，而海康、大华等设备推流常默认启用H.265以节省带宽。若源流为H.265，浏览器会静默丢弃视频帧，仅输出音频。
登录摄像头或NVR后台管理界面，进入“视频参数”或“编码设置” → 找到主码流/子码流的“视频编码格式” → 将H.265改为【H.264】 → 保存并重启流服务。
改完后用新生成的m3u8链接测试，无需修改前端代码即可恢复画面。
强制用FFmpeg转码修复非标M3U8流
适用于TS分片被伪装成.jpg/.png、PAT/PMT缺失、时间戳错乱等底层封装问题。该操作可剥离伪装头、重写元数据、统一编码格式，输出标准MP4或合规HLS。
方法一：转为本地MP4文件（适合调试与归档）
执行命令：ffmpeg -i "https://xxx.com/live.m3u8" -c:v libx264 -c:a aac -fflags +genpts -bsf:v h264_mp4toannexb output.mp4
方法二：实时转封装为标准HLS（适合代理分发）
执行命令：ffmpeg -i "https://xxx.com/live.m3u8" -c:v copy -c:a copy -f hls -hls_time 6 -hls_list_size 0 -hls_wrap 0 fixed.m3u8
【注意】若原流含动态密钥或极短切片（如1秒），需额外添加 -max_muxing_queue_size 1024 防止缓冲溢出导致中断。
绕过浏览器硬件加速干扰
当X5内核、Chrome或Edge加载m3u8时出现黑屏有声，大概率是GPU视频解码管线异常——尤其在Android APP或Windows高分屏环境下，硬件加速会跳过YUV→RGB转换步骤，直接向显存提交无效帧缓冲。
第一步：禁用浏览器级硬件加速
Chrome/Edge：设置 → 系统 → 关闭“使用硬件加速模式(如果可用)” → 完全退出进程再启动。
第二步：对APP内X5内核单独关闭硬件加速
在WebView初始化时调用：mWebView.getSettings().setHardwareAccelerated(false); 或在加载播放页前注入JS：document.body.style.transform = 'translateZ(0)'; 触发回退至软件渲染。
第三步：系统级降级（仅Windows）
右键桌面 → 显示设置 → 高级显示设置 → 显示适配器属性 → 疑难解答 → 更改设置 → 将硬件加速滑块拖至“无”。
检查并修复hls.js加载流程
很多黑屏问题表面是流的问题，实则是hls.js未真正接管video标签，导致浏览器试图用原生逻辑解析m3u8——而Chromium系浏览器原生不支持，于是静默失败。
① 确保引入hls.js后立即检测兼容性：if (Hls.isSupported()) { /* 初始化逻辑 */ } else { /* 降级提示或fallback */ }
② video标签必须为空，不能含
③ 必须监听MANIFEST_PARSED事件后再调用play()，否则触发时机过早，视频轨道尚未就绪：hls.on(Hls.Events.MANIFEST_PARSED, () => { video.play(); });
④ 若使用Vue组件（如vue3-video-play），需确保ref绑定的video元素已挂载完成，且hls实例在onMounted中创建。
