一、📌 插件概述
语音朗读助手 是一款专为 emlog 博客系统打造的智能语音合成插件，通过接入百度AI语音合成技术，将文章内容一键转化为自然流畅的语音朗读，让您的博客实现“视听一体”的全新阅读体验。
无论是视力障碍用户、忙碌的职场人士，还是喜欢多任务处理的学习者，都能通过聆听方式轻松获取信息，极大提升网站的可访问性和用户体验。
二、🎯 核心功能
功能模块 详细说明
一键朗读 点击文章页的 🔊 图标，即可自动朗读全文内容
智能合成 基于百度AI语音合成技术，发音自然流畅，接近真人朗读
播放控制 支持 播放/暂停/继续 切换，随时控制朗读进度
音色选择 内置 7 种高品质音色（标准女声/男声、知性女声、温柔女声、亲切女声、度逍遥男声、度丫丫童声等）
参数调节 支持 语速、音调、音量 多维度调节（0-9 级精细控制）
多位置显示 支持在标题下方（meta 区域）、文章底部、右下角浮动按钮等多种显示方式
多钩子兼容 挂载 log_meta、log_related、index_footer 三大钩子，适配所有模板
三、💡 适用场景
知识类博客：长篇文章、深度教程，用户可边听边做笔记
小说/故事站：提供沉浸式听书体验，解放双眼
资讯类网站：快速获取新闻资讯，适合通勤、运动等场景
无障碍优化：帮助视障用户访问网站内容
教育类平台：语言学习、课程讲解的多模态呈现
个人博客：提升站点专业度和用户体验
四、✨ 特点与优势
🚀 开箱即用
上传启用即生效，无需编写任何代码
后台直观可视化设置，音色、语速、音调一键调节
🎨 高兼容性
同时挂载 log_meta、log_related、index_footer 三大钩子
完美兼容 hliutheme 及 emlog 默认模板
即使模板缺少某些钩子，浮动按钮也能保证功能正常
🔧 灵活可配
7 种高品质音色自由切换
语速、音调、音量分别独立调节（0-9 级）
行内按钮 + 浮动按钮双重显示模式
⚡ 性能优化
音频流实时合成，无需预生成文件
异步加载，不影响页面渲染速度
🌐 跨平台支持
兼容桌面端和移动端浏览器
页面离开时自动暂停，节省流量
五、📋 使用说明
- 安装步骤
text - 将插件文件夹上传至 /content/plugins/ 目录
- 登录 emlog 后台 → 插件管理 → 启用「语音朗读助手」
- 点击「设置」→ 填写百度语音 API Key 和 Secret Key
- 调节音色、语速、音调、音量等参数
- 保存设置，刷新文章页面即可
- 配置参数说明
参数 说明 取值范围
API Key 百度智能云语音合成应用的 Client ID 必填
Secret Key 百度智能云语音合成应用的 Client Secret 必填
音色 发音人风格 7 种可选
语速 朗读速度快慢 0（最慢）~ 9（最快），默认 5
音调 声音高低 0（低沉）~ 9（高亢），默认 5
音量 输出音量大小 0（最低）~ 9（最高），默认 9 - 交互操作
点击 🔊：开始朗读全文
再次点击 ⏸：暂停朗读
点击 ▶：继续朗读
朗读结束：自动恢复为初始状态
- 模板兼容提示
模板类型 图标显示位置 备注
hliutheme 标题下方 meta 区域 完美支持 log_meta 钩子
emlog 默认模板 文章内容底部 如需标题下方显示，请在 echo_log.php meta 区域添加 <?php doAction('log_meta', $logData); ?>
其他自定义模板 自动适配 支持三大钩子，浮动按钮作为备选
六、📊 技术规格
项目 规格
支持系统 emlog 6.0+ / Pro
语音引擎 百度AI语音合成（TTS）
音质 16kHz 采样率，MP3 格式
文本长度 单次最大 1024 字节（约 500 中文字符）
响应方式 实时流式合成
浏览器支持 Chrome、Firefox、Edge、Safari 等主流浏览器
七、🔧 常见问题
Q1：点击图标提示“获取语音服务授权失败”怎么办？
A：请检查后台设置中的 API Key 和 Secret Key 是否正确填写，确保百度智能云账号已开通语音合成服务且余额充足。
Q2：插件在某个模板中不显示？
A：插件已挂载三大钩子，请确认您的模板包含以下至少一个钩子：doAction('log_meta', $logData)、doAction('log_related', $logData)、doAction('index_footer')。如果都缺失，可在模板中添加。
Q3：朗读没有声音？
A：请确保浏览器允许自动播放音频，点击页面任意位置后再点击朗读按钮。部分浏览器（如 Chrome）默认禁止自动播放。
Q4：音色切换后没有变化？
A：请在后台设置中保存后，刷新文章页面重新点击朗读。新参数会立即生效。
Q5：默认模板中图标显示在文章底部，如何移到标题下方？
A：在 /content/templates/default/echo_log.php 的 meta 区域添加 <?php doAction('log_meta', $logData); ?> 即可。
八、📞 联系方式
开发者：Leohugh
官方网站：https://www.hliu.cn
插件主页：https://www.hliu.cn
九、📝 更新日志
v1.8（最新）
修复数据库连接兼容性问题，适配更多环境
增加 log_related 钩子支持，兼容默认模板
优化浮动按钮显示逻辑
改进错误处理机制
v1.7
添加音色、语速、音调、音量后台可视化调节
支持播放/暂停/继续切换
采用数据库直读方式，避免 Option 类兼容性问题
v1.6
优化音频合成代理，解决跨域问题
增加调试日志支持
v1.0
初始版本发布
支持百度语音合成
行内按钮 + 浮动按钮双模式
十、🎯 立即体验
让您的博客“开口说话”，为读者带来全新的听觉体验！上传启用插件，即可在文章页看到 🔊 图标。
如需了解更多详情或获取技术支持，请访问：https://www.hliu.cn