讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

play函数怎么检测播放结束_结束事件处理方法【操作】

浅枫大大_3563

浅枫大大_3563

发布时间:2026-02-12 20:49:47

|

448人浏览过

|

来源于php中文网

原创

ended事件是捕获音视频自然播放结束的唯一可靠方式,需用addEventListener监听,且须在loadeddata或canplay后注册;iOS Safari自动播放受限时需同时监听error;Audio与Video行为一致,但loop=true会阻止ended触发。

play函数怎么检测播放结束_结束事件处理方法【操作】

play() 后怎么知道音频/视频播完了

浏览器原生 play() 不返回 Promise 的完成状态,也不触发回调,它只管“开始播放”。真正能捕获结束的,是元素自身的 ended 事件。

注意:这个事件只在自然播放到末尾时触发,用户手动暂停、网络中断、load() 失败或调用 pause()/stop() 都不会触发它。

  • ended 是 DOM 事件,必须用 addEventListener('ended', ...) 监听,不能靠 play().then() 或 await
  • 如果媒体资源是动态设置的(比如先 src = 'a.mp3' 再 play()),确保在 loadeddata 或 canplay 之后再监听 ended,否则可能漏掉事件
  • 移动端 iOS Safari 对自动播放限制严格,play() 可能被静默拒绝,此时 ended 永远不会来——得同时监听 error 和检查 error?.message

Audio 和 Video 的 ended 事件行为一致吗

一致。无论是 Audio 实例还是 video 元素,只要播放自然结束,都会触发 ended。但实际使用中差异来自加载方式和属性状态。

  • Audio 构造后立即 play(),若未设置 src 或资源未就绪,会抛 DOMException: The element has no supported sources,而不是触发 ended
  • video 元素若设置了 loop="true",则永远不会触发 ended——哪怕视觉上“播完一圈”,也要先 loop = false 才能监听到
  • 两者都受 preload 影响:设为 'none' 时,ended 可能延迟触发,甚至因缓冲不足提前中断而不触发

为什么 addEventListener('ended', ...) 有时不生效

最常见原因是监听时机太早:元素还没加载元数据,或者 src 是后来才赋值的,导致事件注册时播放器内部状态未初始化。

  • 不要在 new Audio() 后立刻监听,加一层 audio.addEventListener('loadedmetadata', () => { audio.addEventListener('ended', ...) })
  • 如果用 srcObject(比如 MediaStream),ended 不适用——它只针对文件/URL 媒体;此时应监听 inactive 事件或检查 readyState === 0
  • React/Vue 等框架中,组件卸载后忘记 removeEventListener,会导致内存泄漏,且下次挂载时重复绑定,出现“一次播放、多次执行回调”

有没有更可靠的替代方案(比如轮询 currentTime)

不推荐轮询。虽然可以读 currentTime 和 duration 判断是否接近结尾,但有明显缺陷:

  • duration 在加载完成前可能是 NaN 或 Inf,尤其对流媒体或无 CORS 的跨域资源
  • 某些编码下 currentTime 在结尾处跳变(如 MP3 的 ID3 尾部),导致判断失准
  • 轮询增加不必要的 CPU 占用,且需自己处理节流、清理定时器
  • 唯一合理用轮询的场景是:你明确知道 ended 被禁用(如某些 WebRTC 播放器封装层),且无法改底层代码

真要兜底,优先检查 onended 属性是否被意外覆盖,或用 getEventListeners(audio)(Chrome DevTools)确认事件监听器是否真实注册成功。

复杂点在于:不同格式、不同来源(本地文件 / HLS / MSE)、不同平台(iOS / Android WebView)对 ended 的触发时机和条件有细微差别,上线前得实机测一遍主流机型和系统版本。

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

热门AI工具

更多
DeepSeek

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

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

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

UpDream
UpDream Hot

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

豆包大模型

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

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

相关专题

更多
chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

3006

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6319

2023.11.06

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

4527

2026.03.24

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1089

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3560

2023.10.25

DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

6541

2024.08.14

promise的用法
promise的用法

“promise” 是一种用于处理异步操作的编程概念,它可以用来表示一个异步操作的最终结果。Promise 对象有三种状态:pending(进行中)、fulfilled(已成功)和 rejected(已失败)。Promise的用法主要包括构造函数、实例方法(then、catch、finally)和状态转换。

4940

2023.10.12

html文本框类型介绍
html文本框类型介绍

html文本框类型有单行文本框、密码文本框、数字文本框、日期文本框、时间文本框、文件上传文本框、多行文本框等等。详细介绍:1、单行文本框是最常见的文本框类型,用于接受单行文本输入,用户可以在文本框中输入任意文本,例如用户名、密码、电子邮件地址等;2、密码文本框用于接受密码输入,用户在输入密码时,文本框中的内容会被隐藏,以保护用户的隐私;3、数字文本框等等。

4883

2023.10.12

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

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

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