音频媒体内容

一、插件简介

音频媒体插件：发帖时可上传本地音频或粘贴解析网易云单曲/歌单；同时在社区顶部提供站点级音乐播放器（曲库 + 抽屉播放列表）。可配置播放模式、随机播放、后缀、大小、用户组与板块权限及储存位置。

二、核心能力

三、依赖与安装

1. 将插件置于 plugins/audio/。
2. 在应用中心安装「音频媒体」。
3. 安装时创建 audio_track（站点曲库）、topic_audio（帖子音频）表并注册后台菜单。
4. 依赖：community（发帖、顶部栏插槽）。
5. 可选：guangya（云盘储存）。

四、应用中心基础配置

五、后台重点配置

曲库管理（/admin/audio）

站点级播放列表，供顶部播放器使用：

六、前台用户流程

顶部播放器

1. 社区顶部签到按钮旁显示音乐图标（需开启「顶部播放开关」）。
2. 点击图标打开抽屉播放列表，显示站点曲库。
3. 选择曲目播放；支持进度拖动、上一首/下一首。
4. 自动播放模式下进入网站即开始播放；随机模式下切歌随机选取。

发帖挂载音频

1. 在允许的用户组与板块下发帖，使用音频拓展。
2. 上传本地文件，或粘贴网易云单曲/歌单链接解析。
3. 发布后音频区块显示在帖子正文下方。

前台路由

七、后台审核与运维

无用户内容审核。运维关注曲库上架状态与储存空间。

帖子生命周期

• afterTopicSave：同步帖子音频数据。
• afterTopicsDeleted：清理帖子音频引用。
• topicMetaMap：列表页音频元信息。
• fileReferenceKeys：/storage/audio/、/guangya/file/。

八、特殊说明

• 插槽：bar_actions_before_post（顶部音乐按钮，优先级 110）、topic_after_content、compose_extra、admin_topic_form、compose_assets；layout_body_end 通过 renderAssets() 注入播放器抽屉 DOM 与 audio-player.js。
• 静态资源：/static/audio/audio.css、audio-player.js、audio-editor.js、topic-audio.js（版本号 assetVersion() 当前为 27）。
• 数据表：audio_track（站点曲库）、topic_audio（帖子挂载）。
• 网易云：NeteaseParseService 处理单曲/歌单解析；发帖可嵌入官方外链播放器或自研播放器直链。
• 播放配置：window.__AUDIO__ 注入 playlistUrl、playUrlApi、playMode、shuffle 等。

九、推荐上线清单

• 启用插件，配置后缀、大小、储存位置
• 在后台「音频媒体」上传站点曲库
• 配置顶部播放开关、播放模式与随机播放
• 设置用户组与板块权限（若需限制）
• 测试顶部播放器、发帖上传、网易云解析
• 确认社区 layout 正确加载 audio.css（head 注入）
• 若使用光鸭储存，完成 guangya 配置

十、常见问题

Q：顶部没有音乐图标？ 检查「启用音频媒体」与「顶部播放开关」；曲库需有上架曲目。

Q：自动播放不生效？ 部分浏览器禁止未交互自动播放，用户需先点击页面；可改用「点击播放」模式。

Q：发帖页没有音频拓展？ 检查用户组权限与板块权限；当前分类是否在「社区分类」白名单中。

Q：网易云解析失败？ 链接格式需为官方分享 URL；歌单解析依赖外部接口，网络异常会导致失败。

Q：帖子音频与顶部曲库的关系？ 顶部曲库（audio_track）为全站播放器；帖子音频（topic_audio）仅在该帖内展示，二者独立。

Q：键盘切歌快捷键？ 在播放器抽屉打开时，↑ 上一首、↓ 下一首。