PHP调用听书插件触发朗读完成回调方法

PHP无法直接触发朗读完成回调，因其运行在服务端，不接触前端音频事件；实际需前端监听onend/onended等事件后，通过AJAX向PHP接口发送完成通知，PHP则需校验来源、字段、签名并做幂等处理。

PHP 本身无法直接触发朗读完成回调

PHP 是服务端脚本语言，不接触浏览器音频播放、TTS（文本转语音）或插件的运行时事件。所谓“听书插件”的朗读完成回调（如 onSpeechEnd、onComplete），实际发生在前端 JavaScript 环境中——比如 Web Speech API、第三方 TTS SDK（如讯飞听见、百度语音合成 JS SDK）、或基于 <audio> 标签的播放控制逻辑。

PHP 的角色仅限于：生成页面、提供语音资源 URL、返回待朗读文本、或接收前端发来的完成通知（通过 AJAX）。想让 PHP “触发回调”，本质是让前端在朗读结束后主动通知 PHP。

前端如何检测朗读完成并通知 PHP

关键在于监听前端语音播放/合成的结束事件，并用 fetch 或 XMLHttpRequest 向 PHP 接口提交确认。常见情形：

• 使用 Web Speech API：speechSynthesis 的 onend 回调最可靠；onpause/onerror 也需监听以防中断
• 使用 <audio> 播放预生成的 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 维持长连接，可在服务端主动推送完成事件，但复杂度陡增，一般没必要

真正的难点不在“怎么写回调”，而在于如何定义“完成”——是合成结束？播放指针走到末尾？还是用户点击了「我听完了」按钮？得先跟产品对齐语义，再选技术路径。