videoTracks仅反映当前源的原生轨道,普通MP4/WebM仅1个默认轨;多轨道需MediaSource或特定HLS/DASH流,且须等loadedmetadata事件后访问;HLS/DASH清晰度切换应由播放器SDK处理而非videoTracks。

如何用 JavaScript 获取和操作视频的轨道(track)
视频元素的 videoTracks 属性返回一个 VideoTrackList 对象,里面包含所有可用的视频轨道(比如多视角、画中画、辅助视觉轨道等)。但注意:普通 MP4/WebM 文件通常**只有一个默认视频轨道**,且不可切换;只有在使用 MediaSource 或播放带多轨道的 HLS/DASH 流(如含多个分辨率或视角的 .m3u8)时,videoTracks 才可能有多个可选项。
常见错误是直接读取 video.videoTracks 却发现长度为 0 或始终只有 1 个“enabled”为 true 的轨道——这是因为浏览器尚未加载元数据,或媒体本身不带多轨道信息。
- 必须等
loadedmetadata事件触发后才能安全访问videoTracks -
videoTracks是实时更新的,但不能手动新增轨道;只能通过enable/disabled控制启用状态 - 每个
VideoTrack对象有id、kind(如"main"、"alternative")、label、enabled属性 - 修改
track.enabled = true仅对多轨道流有效;对单轨本地文件无效(不会报错,但无视觉变化)
怎样用 JavaScript 动态切换视频播放源(src)
直接赋值 video.src 是最常用方式,但有隐藏陷阱:浏览器可能缓存旧资源、未清除解码器状态、或在切换瞬间黑屏/卡顿。尤其在切换不同编码格式(如 H.264 → AV1)或跨域资源时,问题更明显。
推荐做法是先调用 load() 清理内部状态,再设新 src,最后显式调用 play()(如果需要自动播放):
立即学习“Java免费学习笔记(深入)”;
const video = document.getElementById('myVideo');
video.src = 'https://example.com/video-720p.mp4';
video.load(); // 必须调用,否则可能复用旧解码上下文
video.addEventListener('loadeddata', () => {
console.log('新视频已准备就绪');
});
video.play().catch(e => console.warn('自动播放被阻止:', e));
- 不要省略
video.load()—— 否则旧缓冲、时间戳、轨道列表可能残留 - 切换前可先
video.pause()并video.currentTime = 0避免跳转残留 - 若 src 是 blob URL,记得旧的
URL.revokeObjectURL(oldSrc)防内存泄漏 - HLS 或 MSE 场景下,应销毁旧
MediaSource实例,再创建新的
为什么 videoTracks.length 始终是 1,即使换了多轨道流?
根本原因在于:HTMLVideoElement 的 videoTracks **只反映当前播放源的原生轨道信息**,而大多数流媒体(如标准 HLS)的“多清晰度切换”并非靠多个并行视频轨道实现,而是由播放器(如 hls.js)在 JS 层接管解码与渲染,底层 永远只看到一个动态替换的单轨流。
换句话说:videoTracks 不适用于 HLS/DASH 的清晰度切换控制;那是播放器 SDK 的职责(如 hls.levels、player.selectVideoTrack())。
- 真有多轨道视频(如 WebM with multiple
VideoTrack元数据),需用支持多轨道的编码工具生成,并确保 MIME type 正确(如video/webm; codecs="vp09.00.10.08") - Chrome 和 Firefox 对
videoTracks的支持较完整;Safari 行为不一致,部分版本返回空列表 - 可通过
console.dir(video.videoTracks)查看实际内容,注意length和各track.kind值
用 JavaScript 控制播放源时容易忽略的兼容性点
自动播放策略、跨域资源、MIME 类型校验、编解码器支持,这些都会让看似简单的 src 切换失败,且错误静默(不抛异常,只停在 loading 状态)。
- Chrome 要求用户手势后才能调用
play();否则返回NotAllowedError,需监听play().catch() - 设置
src为跨域地址时,必须同时设置video.crossOrigin = "anonymous",否则videoWidth、videoHeight返回 0,且无法读取帧数据 - 某些 Android WebView 不识别
avif或av1视频,canPlayType()应提前检测:video.canPlayType('video/mp4; codecs="av01.0.05M.08"') - 使用
srcObject(如来自getUserMedia)时,不能与src混用;设srcObject = null才能再切回文件源
videoTracks 的场景极少;多数“切换画面”需求本质是换流、换分辨率、或换 canvas 渲染逻辑。别被 API 名字带偏——先确认媒体是否真的含多轨道,再决定走原生 track 控制,还是交给专业播放器库处理。











