ponymusic

wangchenyan活跃维护

基于 Media3 和 ExoPlayer 的 Android 在线音乐播放器，界面和交互仿网易云音乐，适合学习或二次开发音乐类 App。

An Android online music player like NetEase Cloud Music, based on Media3 and ExoPlayer

2.4.0-beta01发布于 2025-10-30 09:30 UTC2,856star503fork同步于 2026-11-07 07:34 UTC

音乐播放器 Android 在线音乐 ExoPlayer Media3

对比 GitHub 官网 android music-player netease-cloud-music

怎么上手

由 README 提炼，执行前请确认

原文

pkg install nodejs
npx NeteaseCloudMusicApi@latest

硬件要求按 README 说明

Android 手机需系统版本 6.0 及以上；电脑非必须，仅用于部署后端 API 服务，也可用手机 Termux 代替。README 未提及 GPU 或显存要求。

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

基于 Media3 与 ExoPlayer 的安卓在线音乐播放器，仿网易云，需自建 API 服务

基于 Media3 和 ExoPlayer 的 Android 在线音乐播放器，界面和交互仿网易云音乐，适合学习或二次开发音乐类 App。

核心能力

基于 Media3 + ExoPlayer 构建播放内核
支持登录网易云并同步歌单、每日推荐与排行榜
歌词可拖动调节播放进度，支持通知栏与桌面小组件
支持本地音乐扫描播放与在线歌曲下载、音质设置
提供夜间模式、定时关闭与横屏大屏适配

容易踩的坑

使用非官方网易云 API，必须自行搭建 NeteaseCloudMusicApi 服务端，否则在线功能不可用；需在 APP 抽屉的「域名设置」中填入含端口的服务地址并重启；手机与电脑需处于同一局域网，用 Termux 方案则填 http://localhost:3000/。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

波尼音乐

系列文章

展示

视频

截图

桌面小组件

功能

后续可能会根据大家的反馈增加或调整功能

本地功能

基于 Media3 + ExoPlayer 构建播放能力
添加和播放本地音乐文件
专辑封面显示
歌词显示，支持拖动歌词调节播放进度
通知栏控制
桌面小组件
夜间模式
定时关闭

在线功能

登录网易云（验证码+扫码）
同步网易云歌单
每日推荐
歌单广场
排行榜
搜索歌曲和歌单
添加歌曲到歌单
喜欢歌曲
下载歌曲
管理歌单
设置在线播放/下载音质

体验

欢迎大家体验，如果发现功能问题或兼容性问题，可以提 GitHub Issue

环境要求

Android 手机（系统版本为 Android 6.0 及以上）
电脑（非必须）

安装步骤

搭建网易云服务器由于我们使用的是非官方 API，因此需要自行搭建 API 服务器。打开服务端项目 NeteaseCloudMusicApi (或 NeteaseCloudMusicApiBackup) 主页，根据项目说明安装并运行服务，需要确认电脑和手机处于同一局域网
安装 APP 点击下载最新安装包
设置域名打开 APP，点击左上角汉堡按钮，打开抽屉，点击「域名设置」，输入步骤1中的地址（包含端口）
设置完成即可体验

没有电脑，如何体验？

使用电脑的目的是为了部署后端 API 服务，其实我们的 Android 手机也可以作为服务器！

安装 Termux 这是 Android 平台下的一个开源的终端模拟器，GitHub 下载地址
安装 nodejs 启动 Termux，执行 pkg install nodejs 命令安装 nodejs 完成后可通过 node -v 确认是否安装成功
运行网易云服务器在 Termux 中执行 npx NeteaseCloudMusicApi@latest 命令安装并运行网易云服务器看到控制台打印 server running @ http://localhost:3000 即表示运行成功
设置域名打开波尼音乐APP，输入域名 http://localhost:3000/ 并重启即可

更新说明

2.4.0

新增桌面小组件（Powered by Glance）
新增横屏模式（大屏设备效果更好）
适配 Android 16

2.3.0

播放器内核升级为 Media3 + ExoPlayer
修复歌单内歌曲超过1000首加载失败的问题

2.2.0

增加添加歌曲到歌单
播放页增加喜欢歌曲和下载歌曲
设置页增加设置下载音质
支持删除歌单中的歌曲
优化大屏播放页效果

2.1.0

增加手机验证码登录（需要使用最新版本服务端代码）
支持设置在线播放音质
增加 Banner 实现
增加接口缓存，非首次打开加载更快
适配 Android 14
修复部分设备后台启动 Service 崩溃

2.0.0

使用 Kotlin 重写
接口改为网易云音乐
增加「每日推荐」、「歌单广场」、「排行榜」、「搜索」等在线功能
适配到 Android 13

1.3.0

新增歌词支持上下拖动
新增支持分屏模式
新增本地歌曲支持按大小和时长过滤
新增下载的歌曲文件自动添加专辑封面
新增编辑歌曲信息
新增5.0以上系统支持联动系统媒体中心，锁屏显示播放信息
修复已知bug

1.2.3

新增通知栏播放控制
修复魅族手机扫描不到音乐的问题
修复已知bug

1.2.0

修复在线音乐无法加载的问题
修复弱网时播放网络歌曲导致ANR的问题
修复每日启动图片无法更新的问题
下载在线歌曲可以显示专辑封面了
修复已知bug

1.1.0

支持 Android 6.0 运行时权限
修复已知bug

1.0.0

First Release

TODO

Liked it?

如果你觉得该项目对你有帮助，欢迎给它一个 star⭐️

依赖

站在巨人的肩膀上

License

Copyright 2024 wangchenyan

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.