讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

HTML5多媒体元素Seeking事件与位置跳转的逻辑

夏萱大大_7499

夏萱大大_7499

发布时间:2026-03-18 00:29:31

|

340人浏览过

|

来源于php中文网

原创

seeking 表示播放器开始跳转,此时 currentTime 未更新,适合禁用控制或显示加载状态;seeked 表示跳转完成,currentTime 已准确更新,是同步 UI 或续播的可靠时机。

html5多媒体元素seeking事件与位置跳转的逻辑

当用户拖动视频或音频进度条时,seeking 事件被触发,表示播放器正在尝试跳转到新位置;而 seeked 事件则在跳转完成、实际播放位置更新后才触发。两者关键区别在于:seeking 是“开始找”,seeked 是“已经找到”。

seeking 事件的触发时机与用途

seeking 在用户发起跳转(如鼠标松开进度条、调用 currentTime 赋值)后立即触发,此时播放器尚未完成解码或定位,currentTime 可能仍为旧值,画面也未更新。它适合用于临时禁用控制、显示加载状态或记录跳转意图。

  • 不能依赖 seeking 时的 currentTime 获取目标位置——应提前缓存或从事件源推断
  • 频繁拖动可能连续触发多个 seeking,建议防抖处理,避免重复操作
  • 移动端 touchmove 中直接设 currentTime 也可能触发 seeking,需注意手势冲突

seeked 事件才是位置跳转完成的可靠信号

seeked 在播放器完成定位、缓冲至少一帧、且 currentTime 已准确反映新位置后触发。此时可安全执行 UI 同步、日志上报、自动播放恢复等操作。

  • 务必在此事件中读取 currentTime,确保数值真实有效
  • 若跳转失败(如超出范围、资源损坏),seeked 不会触发,但会触发 error 或保持 seeking === false
  • 结合 paused 状态判断:seeked 后若原为播放态,可调用 play() 续播

手动跳转时的典型逻辑链

通过脚本设置 currentTime 实现跳转,完整流程如下:

立即学习“前端免费学习笔记(深入)”;

  • 赋值 video.currentTime = 65.3 → 触发 seeking,video.seeking 变为 true
  • 浏览器加载对应时间码的数据(可能触发 waiting 或 canplay)
  • 定位成功后,currentTime 更新,触发 seeked,video.seeking 变回 false
  • 若该时间点不可达(如未加载、格式不支持),seeked 不触发,可监听 error 或检查 seeking 长时间为 true

常见误区与调试建议

实际开发中容易混淆行为边界,导致 UI 不同步或功能异常:

  • 误在 seeking 中更新进度条显示:会导致“跳转中显示目标位置”,视觉上提前,实际画面未到
  • 忽略 seeked 的异步性:直接在 currentTime = x 后立刻读值,拿到的仍是旧值
  • 未处理 seek 失败:比如 MP4 文件无关键帧索引,拖到非 I 帧位置可能卡住,需降级处理(如跳到最近可播时间)
  • 调试时可用 console.log(e.type, video.currentTime, video.seeking) 监听 seeking/seeked/error,观察状态流转

掌握 seeking 和 seeked 的触发边界,才能让进度控制既响应及时又准确可靠。不复杂但容易忽略。

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

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

热门AI工具

更多
DeepSeek

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

WorkBuddy

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

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Seko
Seko Hot

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

豆包大模型

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2903

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6363

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7250

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

7098

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

1003

2024.05.22

html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

7315

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

4032

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

3690

2023.07.31

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

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

精品课程

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

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