讲师中心 微信公众号
AI工具推荐 视频效率加速

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

梦丽君_5365

梦丽君_5365

发布时间:2026-04-07 19:08:02

|

845人浏览过

|

来源于php中文网

原创

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

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

buffered 属性返回的是 TimeRanges 对象

buffered 是 HTMLMediaElement(如 <video> 或 <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

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

相关专题

更多
Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

0

2026.10.16

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

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

0

2026.10.15

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

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

0

2026.10.15

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

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

0

2026.10.15

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

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

0

2026.10.15

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

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

0

2026.10.15

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

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

0

2026.10.15

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

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

0

2026.10.15

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

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

0

2026.10.15

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn