PHP调用听书插件触发朗读完成回调方法
PHP无法直接触发朗读完成回调，因其运行在服务端，不接触前端音频事件；实际需前端监听onend/onended等事件后，通过AJAX向PHP接口发送完成通知，PHP则需校验来源、字段、签名并做幂等处理。
PHP无法直接触发朗读完成回调，因其运行在服务端，不接触前端音频事件；实际需前端监听onend/onended等事件后，通过AJAX向PHP接口发送完成通知，PHP则需校验来源、字段、签名并做幂等处理。
PHP 本身无法直接触发朗读完成回调
PHP 是服务端脚本语言，不接触浏览器音频播放、TTS（文本转语音）或插件的运行时事件。所谓“听书插件”的朗读完成回调（如 onSpeechEnd、onComplete），实际发生在前端 JavaScript 环境中——比如 Web Speech API、第三方 TTS SDK（如讯飞听见、百度语音合成 JS SDK）、或基于 标签的播放控制逻辑。
PHP 的角色仅限于：生成页面、提供语音资源 URL、返回待朗读文本、或接收前端发来的完成通知（通过 AJAX）。想让 PHP “触发回调”，本质是让前端在朗读结束后主动通知 PHP。
前端如何检测朗读完成并通知 PHP
关键在于监听前端语音播放/合成的结束事件，并用 fetch 或 XMLHttpRequest 向 PHP 接口提交确认。常见情形：
- 使用 Web Speech API：
speechSynthesis的onend回调最可靠；onpause/onerror也需监听以防中断 - 使用
播放预生成的 MP3：onended事件直接可用 - 使用第三方 SDK（如讯飞）：查文档找类似
onCompleted或onEvent中event === 'END'的判断
示例（Web Speech API + PHP 回调）：
const utterance = new SpeechSynthesisUtterance('今天天气不错');
utterance.onend = () => {
fetch('https://yoursite.com/callback.php', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
task_id: '20240520123456',
status: 'completed'
})
});
};
speechSynthesis.speak(utterance);
PHP 如何安全接收并处理这个回调
PHP 不是被动“被触发”，而是作为 HTTP 服务端，暴露一个可被前端 POST 调用的接口。必须做几件事防误报和重放：
- 校验请求来源（
$_SERVER['HTTP_ORIGIN']或 Referer，仅作参考，不可全信） - 验证必要字段（如
task_id是否存在、是否符合格式） - 用 token 或时间戳签名（例如前端传
sign=md5(task_id+secret+timestamp)，PHP 侧复算比对） - 幂等处理：插入前先查数据库是否已存在该
task_id的完成记录
简单但可用的 callback.php 骨架：
prepare('INSERT OR IGNORE INTO tts_log (task_id, status, created_at) VALUES (?, ?, ?)');
$stmt->execute([$data['task_id'], 'completed', date('Y-m-d H:i:s')]);
容易忽略的坑：状态不同步与网络不可靠
前端朗读完成 ≠ 用户真正听完了。用户可能中途关闭页面、切走标签页、或网络中断导致回调未发出。因此：
- 不要把“朗读完成回调”当作业务完成的唯一依据（比如发放积分、解锁章节）
- 建议搭配服务端定时任务：对超过 N 分钟仍为“pending”状态的
task_id主动查播放日志或降级标记 - 前端应加错误重试（如失败后 2s、5s、10s 递增重试最多 3 次），并记录到本地
localStorage防刷新丢失 - 若用 WebSocket 维持长连接，可在服务端主动推送完成事件，但复杂度陡增，一般没必要
真正的难点不在“怎么写回调”，而在于如何定义“完成”——是合成结束？播放指针走到末尾？还是用户点击了「我听完了」按钮？得先跟产品对齐语义，再选技术路径。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
