如何替换Kotlin版Android UAMP示例中的默认音乐JSON文件?
UAMP项目默认音乐JSON文件定位与更新操作指引
核心文件存放位置
打开本地拉取的Kotlin版本UAMP工程后,默认音乐JSON的固定存放路径为:
- 对应模块路径:
common模块下的src/main/assets目录 - 目标文件名:
media.json
原项目的歌单加载逻辑会优先读取该目录下的文件,未配置远程歌单地址时,所有展示的音频内容都来自这个本地JSON。
具体更新操作方法
- 打开目标文件
按上述路径找到media.json后直接打开,就能看到默认示例歌单的完整结构,不需要改动其他Kotlin代码逻辑。注意:JSON字段必须和原有键名完全匹配,不能随意修改字段名,否则会出现歌单加载失败、播放无响应的问题。核心必填字段包括:
id:每个音频的唯一标识,不可重复title:列表页展示的音频标题subtitle:音频的作者/专辑说明文案songUrl:实际音频播放源地址artworkUrl:音频对应的封面图链接
- 修改替换内容
可以直接在原有JSON结构上调整条目:把示例音频的相关链接替换成你自己的音频资源地址,调整对应展示文案,修改过程中注意保持JSON格式合法,不要遗漏逗号、闭合引号。 - 验证生效
修改完成后直接重新编译运行项目,打开应用歌单页就能看到更新后的内容。
新手操作注意事项
- 不要把
media.json移到其他目录,一旦脱离assets下的固定路径,原有加载逻辑会因为找不到文件直接报错 - 不要随意修改JSON的顶层结构,原结构为音频列表数组直接放在根节点,不要额外嵌套外层对象
- 如果后续需要切换为远程托管JSON的加载模式,可以在
UampApplication类的全局常量配置中替换为你自己的远程JSON地址,配置生效后将不再读取本地assets目录下的media.json
内容的提问来源于stack exchange,提问作者GBCode
相关产品推荐
相关产品推荐

