Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dufu1991/simple-cloud-music

简洁的的第三方网易云音乐播放器
https://github.com/dufu1991/simple-cloud-music

javascript music-player netease-cloud-music player progressive-web-app pwa pwa-apps rollup svelte web-music-player

Last synced: about 2 months ago
JSON representation

简洁的的第三方网易云音乐播放器

Awesome Lists containing this project

README 

        
# 🉐 停止服务



收到网易云音乐官方邮件，说简易云音乐侵权，将不再对外提供服务，有需要的朋友请自行部署。





  

    Logo

  

  
简易云音乐


  


    简洁的的第三方网易云音乐播放器

    


    


    🌎 访问  |  

    👨🏻‍💻 GitHub

    


    


  



## 🌼 技术与特性



1. 主要技术栈包含 PWA、 Svelte 、rollup、svelte-stack-router、svelte-lazy 等。



2. 支持网易云音乐账号登录（扫码、手机密码或验证码、邮箱密码）。



3. 支持歌词翻译和滚动显示。



4. 支持私人 FM、每日推荐、心动模式等。



5. 支持查看歌曲热评（可开关），过滤评论广告与官方硬塞热评，四楼终于不再是广告了！



6. 每日自动签到（上送 Android 端签到，因为积分最高）。



7. 推荐 PWA 模式使用，Chrome 和 Edge 浏览器根据首次打开时的提示安装，Safari 手动安装。



8. 播放器最大化时支持下滑最小化，最小化模式支持左滑切换下一曲，滑动支持速度判断。



9. 更多特性开发中。



10. 前端菜鸟一枚，水平有限，期待大佬提出改进意见。



## 🍽️ 如何食用



1. 本应用使用了 PWA 技术，本质还是网页应用，只是对比纯网页体验有所提升。请将图标添加至设备桌面使用，相当于将网页书签放置桌面，方便快速打开，且不占用设备存储空间。



2. Android 设备建议使用较新版本的 Chrome 或 Edge 浏览器直接打开 [简易云音乐](https://simplecloudmusic.com) ，根据提示安装至桌面使用。国内手机自带的浏览器及其他第三方浏览器由于对 chromium 内核的魔改与阉割，对 PWA 的支持一言难尽。正常情况进入页面根据提示安装至桌面即可，或按照下图手动添加。很多手机操作系统默认会关闭 APP 将网页标签放到桌面的权限，可按照以下方式（设置--应用设置--应用管理--找到 Chrome 或者 Edge 浏览器--权限管理--添加桌面快捷方式）打开权限，不同品牌手机有些许差异，请以自己的手机系统为准。注：不知是 Microsoft 和 Google 自己不上架还是被国内应用商店出于商业目的限制了，各大主流应用商店要么无法下载，要么下载的版本都是很多年前的旧版。请自行想办法安装较新版本的 Chrome 或 Edge，或到我提供的这个地址下载。[下载 Edge apk](https://simplecloudmusic.com/assets/microsoft-edge-92-0-902-59.apk)，[下载 Chrome apk](https://simplecloudmusic.com/assets/google-chrome-92-0-4515-131.apk)。



3. iOS 设备安装就很简单了，用自带的 Safari 浏览器打开 [简易云音乐](https://simplecloudmusic.com)，按照以下提示即可安装至桌面。





Logo




## 💭 项目背景



想找个项目练手 Svelte，就对比了几个音乐类应用，刚好有开源的网易云 API [Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi) 可用，就搞了这个工程。



内容资源使用网易云音乐，UI 界面参考了 [Apple Music](https://music.apple.com/cn/browse) 与 [YesPlayMusic](https://github.com/qier222/YesPlayMusic)。



写一点自己使用过的一些音乐 APP 感受对比。



### 1. Apple Music



#### 优点



-   无广告，界面简洁。



-   音质不虚标，会员策略简单易懂无套路。



-   资源数量相对来说还比较丰富，内容也比较多元化。



#### 缺点



-   Mac 端不知为何加载超级慢，服务器不是搬到云上贵州了吗？作为亲儿子应用不应该啊。



-   可能是使用的时间少，没有数据支撑，推荐机制的智障程度和 Siri 有的一拼。



-   根据我的个人习惯，喜欢一首歌，但一般不会喜欢这首歌的整张专辑和艺人的所有歌曲。所以 Apple Music 的音乐分类着重突出专辑与艺人维度，总感觉怪怪的。



-   可能是我自己品味太 low 或者主要针对欧美市场，官方整理的歌单与分类口味不对。



### 2. 网易云音乐



#### 优点



-   推荐机制与算法真的牛逼，和 Spotify 有的一拼。



-   歌单机制是真的强大，我认为网易云应该感谢这些无私奉献的网友。



-   评论区真是有意思，你管它段子是真是假，有意思就行。



-   小众音乐、轻音乐、独立音乐人等模块做的比较好。



#### 缺点



-   版权资源相对其他家较少，歌曲变灰很多。



-   功能大杂烩，广告满天飞。



-   在 UI 设计与用户体验方面即使算上 Apple Music 在内，早期版本的网易云音乐也是一流的。注意是之前的版本，现如今，各种广告植入，各种功能乱塞，各种奇怪的设定，举个简单的例子，歌曲评论默认按照推荐而不是点赞数排列，我想了下按推荐排列就可以在里面夹带私活了呀。



-   吃相难看，音质虚标，会员套路多。



### 3. QQ 音乐



#### 优点



-   以 QQ 音乐、酷狗、酷我为代表的的腾讯音乐集团，资源齐全，齐全到国内垄断，垄断到监管部门几次约谈，约谈之后依然可以敷衍了事，不了了之。



#### 缺点



-   界面太乱，花里胡哨，功能杂乱无章。出了个简洁版，只是先把用户当韭菜培养习惯。按照正常商业逻辑，做大做强了就要盈利就一定会夹带私活；没起来？那简单了啊，砍刀部一挥砍刀，这项目没了。不要太相信这些大厂的鬼话了，夸克就是最好的例子。



-   会员没买过，听大家的说法也是套路满满。



### 4. Spotify



#### 优点



-   资源齐全，即使是华语音乐资源都很齐全，Apple 应该学习一下。



-   各个平台的客户端体验都超级棒，尤其是 Spotify Connect 功能，一个第三方开发商能做到这般体验已经相当可以了。



-   推荐机制与算法很强。



#### 缺点



-   官方渠道会员价相对其他平台来说有点离谱，不过扪心自问了一下，这应该是消费者自己的问题。



-   在大陆地区正常网络就能访问，但是官方竟然不给个简体中文版本（可能是我笨，不知道怎么弄）。



## 🤷‍♂️ 已知问题或体验欠佳点



1. 播放器最大化时，由于 Android 无法阻止系统返回，iOS 无法阻止 Safari 右滑返回，进行此操作会返回上一页之后播放器才能最小化，有一点不符合操作预期，暂时无解。



2. 由于 Safari 不支持 CSS 特性 scroll-behavior: smooth（平稳滚动），手动写了 scrollSmoothTo 方法实现歌词平滑滚动，但是似乎是因为 Safari 自带的滚动延迟与自定义滚动的时间计算有冲突，若刚好在切换歌词的极短时间内手动滚动歌词会出现滚动回退现象（看人品）。考虑此需求不重要，暂不予解决（Android 原生支持 smooth，体验良好）。



3. 此应用始终是个网页应用，无法在第一级页面返回时提示即将退出应用的二次确认。



4. 目前浏览器好像没有提供完整的系统级媒体控制 API，所以无法使用线控耳机等后台方式切换下一曲等。



5. 官方歌词格式混乱，已发现的特殊情况都一一处理，可能还存在其他莫名其妙的混乱情况，查看歌词可能导致应用报错或歌词显示错误。



6. PWA 模式已经设置了仅竖屏使用，但手机横屏打开应用时页面计算的高度是横屏高度，播放器最大化与最小化就一定概率出现问题，请关闭浏览器进程（注意是浏览器进程）竖屏重新打开。



7. 虽然很多地方都做了懒加载，但是某些不适合懒加载的情况下，歌曲列表超级长的时候，由于短时间内页面要渲染大量数据，根据手机性能，可能会有延迟。



8. iOS 设备右滑返回上一页是 Safari 浏览器自带的功能，但是在 PWA 模式下右滑返回上一页会自动加载一下页面，体验不好但不影响功能。



9. iOS 的 Safari 在 PWA 模式下不能后台播放音乐？我在 Mac 的 Simulator 里面是完全没问题的，没法玩了啊。实在有此需求的可以直接在网页上使用。



10. Android 端使用的时候，会在通知栏显示如下提示，这是浏览器自带的通知，查了下好像没有关闭的 API 。强迫症看不下去可以关闭浏览器的通知权限，但对应的通知栏控制功能也会关闭。





notice




## ⚙️ 部署



如果你有自己的服务器，建议将此应用与网易云 API 都部署至你自己的服务器，减轻我的服务器压力。



1. 部署网易云 API，详情参见 [Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)。



2. 执行`git clone https://github.com/dufu1991/simple-cloud-music.git`克隆本仓库代码。



3. 设备安装好 node 环境之后，进入工程目录，执行 `npm i` 安装依赖。



4. 修改 `src/utils/request.js` 文件里面的 baseURL 为你的网易云 API 地址，执行 `npm run dev` 启动本地联调，此时访问的是 public 下面的文件。



5. 执行 `npm run build` 编译打包文件至 html 目录下，然后将 html 文件夹里面的文件上传到你的 Web 服务器即可访问。



6. 如果要直接部署，执行 `npm run deploy` 根据命令行提示输入自己的服务器地址、账号、密码、静态文件部署路径等信息，将直接将打包好的工程部署至 Web 服务器。



7. 要实现 PWA 的 Service Workers（离线访问），必须要 HTTPS 证书，关于域名、证书、服务器等相关内容请自行了解。



## 📜 开源许可



本项目仅供个人学习研究使用，禁止用于商业及非法用途。



基于 [MIT license](https://opensource.org/licenses/MIT) 许可进行开源。



## 🌊 灵感来源与大感谢



非常感谢 API 源代码，来自 [Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi) 。



-   [Apple Music](https://music.apple.com/)



-   [Spotify](https://www.spotify.com/)



-   [网易云音乐](https://music.163.com/)



-   [YesPlayMusic](https://github.com/qier222/YesPlayMusic)



## 📷 部分截图





screen1





screen2





screen3





Loscreen4go




## 🎨 Design





cover




## 🪢 杂谈



-   因为 UI 界面图片区域较多，暂时不考虑暗黑模式（主要是暗黑模式对设计要求较高，做不好了啦）。

-   哦，如果想请我喝杯咖啡或是赞助一下服务器费用，也是可以的。



lollipop




## 🚑 反馈与建议



由于主要只在 Android 设备上测试，且只用了我个人的网易云音乐账号数据，避免不了不同设备不同版本不同数据产生的 bug，望积极反馈。



-   猿类请到 GitHub 提 [Issues](https://github.com/dufu1991/simple-cloud-music/issues) 。

-   非猿类可邮件至 [email protected]