电视盒子video标签播放失败主因是浏览器内核老旧导致HTML5视频支持不全，需严格匹配.mp4+H.264 Baseline+Level 3.0+AAC-LC格式、正确Content-Type响应头及faststart优化。
电视盒子上 video 标签播放失败的常见原因
多数电视盒子（如当贝、小米盒子、创维酷开）内置浏览器内核老旧，对 HTML5 视频支持不完整，不是“写个 <video></video> 就能播”。典型表现是黑屏、报错 DOMException: The element has no supported sources，或静音但无画面。
根本问题不在分辨率，而在容器格式、编码参数、甚至 HTTP 响应头。电视盒子往往只认特定组合：
-
.mp4容器 +H.264编码（Baseline 或 Main Profile）+AAC-LC音频 - 关键限制：不支持
H.265/HEVC、不支持AV1、不支持MP3作为视频内嵌音频 - 部分盒子拒绝非
application/mp4的Content-Type响应头，哪怕后缀是 .mp4
用 ffmpeg 转成电视盒子友好格式的实操命令
别依赖 GUI 工具自动设置——电视盒子对 Profile、Level、B-frame、moov 位置等敏感。以下命令经实测在多款安卓 TV 盒子（Amlogic S905X3/S922X 平台）可播：
ffmpeg -i input.mp4 \ -c:v libx264 \ -profile:v baseline \ -level 3.0 \ -b:v 2000k \ -maxrate 2000k \ -bufsize 4000k \ -g 30 \ -keyint_min 30 \ -sc_threshold 0 \ -c:a aac \ -b:a 128k \ -ar 48000 \ -movflags +faststart \ output_tv.mp4
重点说明：
立即学习“前端免费学习笔记（深入）”；
-
-profile:v baseline：必须，Main Profile 在部分盒子会卡帧或黑屏 -
-level 3.0：对应 720p@30fps，Level 3.1 或更高可能触发解码失败 -
-movflags +faststart：把 moov box 移到文件开头，否则盒子常卡在“加载中” - 去掉
-preset和-tune：这些参数在老版 ffmpeg（盒子常用）中可能被忽略或报错
video 标签里哪些属性真有用，哪些纯属干扰
电视盒子浏览器（通常是基于 Chromium 60–70 或 WebKit 的定制壳）对 HTML 属性支持极有限。实测有效且必要的只有：
-
src：必须指向直链 MP4（不能是 HLS/m3u8，99% 不支持） -
preload="auto"：部分盒子需显式声明才触发预加载；metadata反而容易卡住 -
playsinline：防止全屏跳转（盒子无标准全屏 API，会崩溃） -
webkit-playsinline和x5-playsinline：国产盒子兼容性补丁，建议加上
以下属性基本无效或有害：
-
poster：多数盒子不渲染封面图，还可能阻塞首帧解码 -
controls：自定义控件更可靠，原生控件在盒子上常错位或失灵 -
muted+autoplay：看似合理，但部分盒子因权限策略直接禁播，不如 JS 中手动play()并捕获NotAllowedError
HTTP 服务端必须配的三项响应头
即使视频文件本身合规，如果服务端没配对，盒子仍会拒绝加载。Nginx 或 Node.js 静态服务务必加：
-
Content-Type: video/mp4：不能是application/octet-stream或空 -
Accept-Ranges: bytes：不支持流式 seek 的盒子会直接放弃播放 -
Cache-Control: public, max-age=31536000：盒子内存小，反复请求同一资源易 OOM，强缓存能显著提升二次加载成功率
额外提醒：别用 Range 请求做分片逻辑——电视盒子几乎不支持 206 Partial Content 恢复播放，首次请求就必须返回完整 200 OK 响应体。
最易被忽略的一点：很多开发者调通了手机和 PC，就默认盒子也行。其实盒子的解码链路是硬解优先，驱动层对 H.264 Level 和 Profile 的校验比软件解码严格得多——差一个参数，就是“能编译”和“能运行”的区别。
