You need to enable JavaScript to run this app. 如何替换Kotlin版Android UAMP示例中的默认音乐JSON文件?
优惠活动
大模型
产品
解决方案
定价
更多

如何替换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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 00:57:02