/taro-music

🎉基于taro + taro-ui + redux + typescript 开发的网易云音乐小程序(不定时更新)

Primary LanguageTypeScriptMIT LicenseMIT

taro-music

基于Taro与网易云音乐api开发,技术栈主要是:typescript+taro+taro-ui+redux,目前主要是着重小程序端的展示,主要也是借此项目强化下上述几个技术栈的使用,打造一个最佳实践项目,通过这个项目也可以帮助你快速使用Taro开发一个属于你自己的小程序,此项目会持续更新,欢迎watchstar


GitHub stars GitHub forks GitHub watchers GitHub

快速开始

注意事项

目前已将taro的版本升级到最新版本2.0.0-beta.8,确保你本地的taro-cli的版本也是这个版本,可以通过taro info查看版本号,如果不是最新的话,可以通过执行taro update self以及taro update project进行cli与项目依赖的更新保持一致,否则将会导致项目无法正常运行,了解更多详情可查看Taro环境及依赖检测

首先需要在src目录下创建一个config.ts,可以根据自己的需要将其替换成线上地址,接口服务是使用的NeteaseCloudMusicApi

export const baseUrl: string = 'http://localhost:3000' // 这里配置的这个url是后端服务的请求地址

在运行本项目前,请先确保已经全局安装了Taro,安装可见官网指导

启动后端接口服务

git clone https://github.com/Binaryify/NeteaseCloudMusicApi.git

cd NeteaseCloudMusicApi

npm i

npm run start

接下来启动前端项目

git clone https://github.com/lsqy/taro-music.git

cd taro-music

npm i

npm run dev:weapp

功能列表

  • 用户登陆
  • 退出登陆
  • 我的关注列表
  • 我的粉丝列表
  • 我的动态列表
  • 最近播放列表
  • 我的电台
  • 我的收藏
  • 推荐歌单
  • 推荐电台
  • 推荐电台
  • 我创建的歌单列表
  • 我收藏的歌单列表
  • 共用的歌单详情列表
  • 歌曲播放页面
  • 歌词滚动
  • 歌曲切换播放模式(随机播放/单曲循环/顺序播放)
  • 切换上一首/下一首
  • 喜欢/取消喜欢某首歌曲
  • 评论列表
  • 视频播放
  • 热搜列表
  • 搜索(包含单曲/歌单/视频/歌手/专辑/电台/用户)
  • 统一的播放组件,方便进行切换页面后可以随时进入到播放页面

目录结构简要介绍

这里主要介绍下src目录,因为开发主要是在这个目录下进行的

- src
 - actions // `redux`中的相关异步操作在这里进行
 - assets // 静态资源目录,这里引入了所需的图片资源,以及`fontawesome`字体图标资源
 - components // 封装的项目中可复用的组件,目前只是抽象了`CLoading`(加载效果组件)、`CLyric`(歌词组件)、`CMusic`(正在播放组件)、`CSlide`(滑块组件)、`CTitle`、`CUserListItem`
 - constants // 项目中的常量定义,目前定义了`typescript`的公共定义、`reducers`的名称定义、状态码的定义
 - pages // 项目中的业务页面都在这个目录中
 - reducers // `redux`中的相关同步操作在这里进行
 - services // 可复用的服务可以放在这个目录中,目前只是封装了接口请求的公共服务,可以根据自己项目的需要进行其他服务的扩充
 - store // redux的初始文件
 - utils // 可以复用的工具方法可以放到这个目录当中,目前封装了格式化、歌词解析的相关方法
  - decorators // 抽象的装饰器,主要为了解决在切换页面之后仍然可以继续保持播放状态,因为目前`taro`不支持全局组件
 - app.scss // 全局样式
 - app.tsx // 全局入口文件
 - base.scss // 基础样式
 - config.ts // 项目的全局配置,目前只是配置了`baseUrl`是后端服务的基准请求地址

todo

  • 复用的评论列表
  • 搜索功能 已完成部分功能
  • 个人主页支持跳转
  • 歌手页面
  • react-hooks重构部分功能

最近更新

  • 加入搜索功能(进一步完善中)
  • 加入了视频播放(进一步完善中)
  • 加入了mv播放(进一步完善中)
  • 加入了视频与mv中的评论列表(2019-09-07)

效果图预览

下面简要列出几张效果图

  • 我的页面
  • 登陆页面
  • 推荐歌单
  • 歌单详情
  • 正在播放列表
  • 歌曲播放
  • 歌词显示
  • 最近播放
  • 关注列表
  • 粉丝列表

有待完善部分

还有一些功能点以及细节都还有待进一步完善,目前先把大致主要的功能进行了下实现,当然如果发现什么问题,欢迎能够提交issues,发现之后我会及时进行更正,欢迎 starfork,感谢大家支持🙏。