听书模块快速启动指南

一、数据库初始化

1. 执行SQL脚本

在Navicat或其他MySQL客户端中执行：

-- 执行听书模块数据库脚本
source book/src/main/resources/db/audiobook_schema.sql;

或者直接复制 audiobook_schema.sql 文件的内容到Navicat中执行。

2. 验证表创建

确认以下表已创建：

audiobooks - 听书专辑表
audiobook_chapters - 听书章节表
user_listening_history - 用户听书历史记录表
user_listening_progress - 用户听书进度表

3. 验证数据

确认示例数据已插入（至少5条听书记录和10条章节记录）。

二、后端启动

1. 检查配置

确保 application.properties 或 application.yml 中的数据库连接配置正确。

2. 启动Spring Boot应用

cd book
mvn spring-boot:run

3. 验证接口

访问以下接口验证后端是否正常：

http://localhost:8080/api/audiobook/recent?limit=8
http://localhost:8080/api/audiobook/popular?limit=10
http://localhost:8080/api/audiobook/{id} (替换{id}为实际的听书ID，如1)

三、前端配置

1. 检查API配置

确保 books/utils/config.js 中的 BASE_URL 指向正确的后端地址：

BASE_URL: 'http://localhost:8080/api'

2. 启动前端项目

使用HBuilderX或其他工具启动uni-app项目。

四、功能测试

1. 听书列表测试

打开小程序，进入"听书"页面
查看横幅推荐是否显示
查看"最近上新"列表是否显示
查看"猜你喜欢"列表是否显示

2. 听书详情测试

点击任意听书进入详情页
查看听书基本信息是否正确显示
查看章节列表是否显示
查看章节是否显示免费/VIP标识

3. 播放功能测试

点击免费章节进入播放器
测试播放/暂停功能
测试快进15秒、快退15秒功能
测试进度条拖动功能
退出播放器后重新进入，验证断点续播功能

4. 进度保存测试

登录用户账号
播放任意章节
播放一段时间后退出
重新进入该章节，验证是否从上次播放位置继续

五、常见问题

1. 听书列表为空

原因: 数据库中没有数据或查询条件不正确解决:

检查数据库表是否有数据
检查后端日志是否有错误
检查前端API调用是否正常

2. 音频无法播放

原因: 音频URL无效或格式不支持解决:

检查音频URL是否可访问
确保音频格式为MP3等小程序支持的格式
检查网络连接是否正常

3. 进度无法保存

原因: 用户未登录或API调用失败解决:

确保用户已登录
检查后端接口是否正常
查看浏览器控制台是否有错误信息

4. 章节列表为空

原因: 数据库中该听书没有章节数据解决:

检查数据库 audiobook_chapters 表是否有对应听书的章节
检查 audiobook_id 是否正确关联

六、数据准备

1. 添加听书数据

可以在Navicat中手动添加听书数据，或使用以下SQL：

INSERT INTO `audiobooks` (`title`, `author`, `narrator`, `cover`, `image`, `brief`, `desc`, `category_id`, `status`, `is_free`, `is_vip`, `chapter_count`, `total_duration`) VALUES
('听书名', '作者名', '主播名', '封面URL', '图片URL', '简介', '描述', 1, 1, 1, 0, 10, 36000);

2. 添加章节数据

INSERT INTO `audiobook_chapters` (`audiobook_id`, `chapter_number`, `title`, `audio_url`, `duration`, `is_free`) VALUES
(1, 1, '第一章', '音频URL', 3600, 1);

七、注意事项

音频文件: 示例数据中的音频URL为占位符，实际使用时需要替换为真实的音频文件URL。
VIP权限: VIP章节需要用户登录且为VIP会员才能播放，测试时注意用户VIP状态。
网络请求: 确保前后端网络连接正常，CORS配置正确。
数据库: 确保数据库表结构正确，外键约束正常。
音频格式: 建议使用MP3格式，确保小程序可以正常播放。

八、下一步

替换示例数据为真实数据
配置真实的音频文件存储和访问
实现上一章、下一章自动切换
添加播放倍速调节功能
添加下载功能（离线播放）
优化音频加载和缓冲
添加评论功能
添加收藏功能

听书模块快速启动指南.md 4.3 KB Geschiedenis Ruwe