buffered属性能获取什么信息_媒体已缓冲范围查询【方法】

梦丽君_5365

梦丽君_5365

2026-04-07

845人浏览

原创

buffered 属性返回 timeranges 对象,用于描述已缓冲的时间段集合;其 length 表示段数,start(i) 和 end(i) 分别获取第 i 段起止时间;需用 end(length-1) 获取最远缓冲时间,且与 readystate、networkstate 无严格对应关系。

buffered属性能获取什么信息_媒体已缓冲范围查询【方法】

buffered 属性返回的是 TimeRanges 对象

buffered 是 HTMLMediaElement(如 <video></video> 或 <audio></audio>)的只读属性,它不返回数组、不返回布尔值,也不直接返回数字范围。它返回一个 TimeRanges 实例——这是浏览器原生的、不可构造的类,用于描述媒体资源中已加载(即已缓冲)的时间段集合。

这个对象本身没有 length 以外的可枚举属性,所有时间信息必须通过其方法访问:

  • buffered.length:已缓冲的连续时间段个数(可能为 0)
  • buffered.start(index):第 index 段的起始时间(秒,浮点数)
  • buffered.end(index):第 index 段的结束时间(秒,浮点数)

常见误判:buffered.length === 0 不代表没加载

刚设置 src 后立即读取 buffered,大概率拿到 length === 0,但这不表示“一点都没缓冲”。原因有二:

  • 浏览器尚未触发预加载策略(例如 preload="none" 时,buffered 始终为空,直到用户主动播放)
  • buffered 只反映已解码并存入内存的帧范围,而网络层可能已下载更多字节(但未送入解码器)
  • 某些浏览器(如 Safari)对 buffered 的更新有延迟,需监听 progress 或 timeupdate 事件后再查

如何安全获取当前已缓冲的最远时间点

多数场景下,你真正关心的是“用户拖到哪能立刻播放”,即最后一个缓冲段的 end 值。但不能直接用 buffered.end(0) ——因为可能存在多个不连续段(如跳播后产生碎片缓冲):

function getBufferedEnd() {
  const buffered = video.buffered;
  if (buffered.length === 0) return 0;
  return buffered.end(buffered.length - 1);
}

注意:buffered.end(i) 返回的是媒体时间轴上的绝对时间(单位秒),与视频是否设置了 currentTime 无关;它也不受 playbackRate 影响。

buffered 与 readyState、networkState 的关系容易混淆

buffered 描述“哪些时间范围已准备好播放”,而:

  • readyState 表示媒体元素整体就绪程度(如 HAVE_METADATA 仅表示头信息加载完,此时 buffered.length 很可能还是 0)
  • networkState 反映网络连接状态(如 NETWORK_LOADING 时 buffered 可能正在增长,但未必连续)
  • 三者无严格先后顺序:buffered.length > 0 时 readyState 仍可能是 HAVE_CURRENT_DATA(无法播放下一帧)

真正决定能否播放的是 readyState >= HAVE_FUTURE_DATA 且 buffered 覆盖了 currentTime 所在位置——这点常被忽略,导致“明明有缓冲却卡住”的调试困境。

数码产品性能查询
数码产品性能查询

该软件包括了市面上所有手机CPU,手机跑分情况,电脑CPU,电脑产品信息等等,方便需要大家查阅数码产品最新情况,了解产品特性,能够进行对比选择最具性价比的商品。

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

2026.10.15

0

18

C++ 开发环境怎么搭建
C++ 开发环境怎么搭建

C++开发环境专题汇集Windows、Linux下的编译器与IDE安装配置教程,涵盖GCC、Clang、Visual Studio、CLion和VS Code,以及编译运行首个程序的步骤。

2026.10.15

0

19

Python 虚拟环境是什么
Python 虚拟环境是什么

Python虚拟环境专题介绍项目依赖隔离的作用,汇集venv与uv创建、激活、退出及解释器切换的相关文章,并覆盖Windows、Linux和VS Code中的常见配置问题。

2026.10.15

0

15

Python 怎么安装并配置环境变量
Python 怎么安装并配置环境变量

Python安装与环境变量配置专题汇集Windows、macOS和Linux的安装步骤、PATH设置、pip配置及常见报错排查文章,帮助完成解释器安装并验证命令行可以正常运行。

2026.10.15

0

15

PHP 连接 MySQL 失败怎么办
PHP 连接 MySQL 失败怎么办

PHP连接MySQL失败专题汇集PDO与MySQLi扩展配置、账号权限、主机端口、套接字和认证方式等排查文章,覆盖连接报错、密码变更与容器环境配置,帮助按错误提示定位原因并修复。

2026.10.15

0

18

PHP 表单提交后如何获取数据
PHP 表单提交后如何获取数据

PHP表单提交后如何获取数据专题汇集HTML表单提交、GET与POST接收、$_POST和$_GET读取、跨文件传值、单选与下拉字段获取,以及空值和接收失败排查等文章,帮助新手完成从提交到处理的完整流程。

2026.10.15

0

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习