logo
0
0
WeChat Login
Chief<520@zut.edu.cn>
docs: 更新README为音乐播放器项目文档

2025年度歌单

一个基于React + TypeScript + Vite的音乐播放器应用,支持Apple Music风格的歌词展示。

快速开始

# 安装依赖 bun i # 启动开发服务器 bun dev # 构建生产版本 npm run build

如何修改歌曲

1. 修改歌曲列表

编辑 src/list.ts 文件,替换 trackList 数组:

export const trackList: Track[] = [{ name: "歌曲名称", artist: "歌手名", description: "歌曲描述(可选)", cover: "/cover/your-cover.jpg", // 封面文件名 lyric: "your-lyric.ttml", // 歌词文件名 url: 'your-audio.mp3' // 音频文件名 }];

2. 添加资源文件

将文件放入对应目录:

  • 封面图片public/cover/ 文件夹
  • 歌词文件public/lyrics/ 文件夹(TTML格式)
  • 音频文件public/audios/ 文件夹(mp3格式)

3. 音频托管配置(可选)

如果使用外部CDN托管音频,修改 src/App.tsx 第69行:

audio.src = `https://你的CDN域名/${currentTrack.url}`;

4. 歌词格式转换

歌词文件需要TTML格式。如果只有LRC格式,需要转换:

<tt xmlns="http://www.w3.org/ns/ttml"> <body> <div> <p begin="00:05.00" end="00:08.00">第一句歌词</p> <p begin="00:08.00" end="00:12.00">第二句歌词</p> </div> </body> </tt>

如何清空歌曲

方法一:清空歌曲列表

编辑 src/list.ts,清空数组:

export const trackList: Track[] = [];

方法二:删除资源文件(可选)

删除以下文件夹中的所有文件:

  • public/cover/ - 封面图片
  • public/lyrics/ - 歌词文件
  • public/audios/ - 音频文件(如果使用本地托管)

技术栈

  • React 19 + TypeScript
  • Vite + SWC
  • Tailwind CSS v4
  • Radix UI + shadcn/ui
  • Apple Music Like Lyrics(歌词渲染)

部署

项目使用CloudBase CI/CD自动部署到EdgeOne Pages,配置见 .cnb.yml


Powered by Ar-Sr-Na