# HarmonyMusicPlayer

**Repository Path**: longchenx/harmony-music-player

## Basic Information

- **Project Name**: HarmonyMusicPlayer
- **Description**: arkts实现鸿蒙音乐播放器
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 4
- **Created**: 2025-06-07
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 鸿蒙实践音乐播放器

## README

# Harmony Music Player

## 项目介绍
这是一个基于鸿蒙系统开发的综合性音乐娱乐应用，不仅提供音乐播放功能，还集成了视频播放、社交互动等特性。本项目是鸿蒙应用开发课程的结课作品，展示了鸿蒙系统的强大功能和现代化应用开发实践。

## 核心功能

### 音乐功能
- 音乐播放控制
  - 播放/暂停
  - 上一首/下一首
  - 进度条控制
  - 音量调节
  - 循环播放模式
- 播放列表管理
  - 创建自定义播放列表
  - 收藏喜欢的歌曲
  - 历史播放记录
- 音乐发现
  - 每日推荐
  - 排行榜
  - 电台功能
  - 新歌速递

### 视频功能
- 视频播放器
  - 支持多种视频格式
  - 播放控制
  - 全屏模式
- 视频列表管理
  - 收藏视频
  - 播放历史

### 社交功能
- 用户系统
  - 账号注册
  - 登录功能
  - 个人信息管理
- 消息系统
  - 私信功能
  - 消息通知
- 社区互动
  - 评论功能
  - 分享功能

## 技术架构

### 开发环境
- 开发语言：ArkTS
- 开发框架：HarmonyOS
- 开发工具：DevEco Studio
- 最低支持版本：HarmonyOS 3.0
- Node.js 版本要求：14.0+
- 包管理工具：npm/yarn

### 项目结构
```
entry/src/main/ets/
├── components/          # 可复用组件
│   ├── GlobalMusicPlayer.ets  # 全局音乐播放器
│   ├── Login.ets             # 登录组件
│   ├── Register.ets          # 注册组件
│   ├── TabBar.ets            # 底部导航栏
│   └── ...
├── pages/              # 页面文件
│   ├── music-player.ets      # 音乐播放页面
│   ├── video-player.ets      # 视频播放页面
│   ├── MyFavorites.ets       # 我的收藏
│   ├── Radio.ets            # 电台页面
│   └── ...
├── common/             # 公共资源
│   ├── constants/      # 常量定义
│   ├── utils/         # 工具函数
│   └── styles/        # 样式文件
└── entryability/      # 应用入口
```

## 安装部署

### 环境准备
1. 安装 DevEco Studio 3.0 或更高版本
2. 安装 Node.js 14.0 或更高版本
3. 安装 HarmonyOS SDK 3.0 或更高版本
4. 配置开发环境变量

### 项目安装
1. 克隆项目到本地
```bash
git clone [项目地址]
```

2. 安装依赖
```bash
npm install
# 或
yarn install
```

3. 使用 DevEco Studio 打开项目
4. 等待依赖安装完成
5. 配置开发者证书
6. 选择目标设备
7. 点击运行按钮进行安装

## 使用指南

### 首次使用
1. 启动应用后，需要注册/登录账号
2. 授予必要的系统权限
   - 存储权限（用于访问本地媒体文件）
   - 网络权限（用于在线播放和社交功能）
   - 通知权限（用于接收消息通知）

### 音乐播放
1. 在首页浏览推荐内容
2. 点击歌曲开始播放
3. 使用底部播放器控制播放
4. 可以创建播放列表或收藏歌曲

### 视频功能
1. 进入视频页面
2. 选择要播放的视频
3. 使用播放器控制功能
4. 支持全屏播放

### 社交功能
1. 在个人中心管理个人信息
2. 使用消息系统与其他用户交流
3. 参与社区互动

## 开发指南

### 代码规范
- 遵循 ArkTS 开发规范
- 使用 ESLint 进行代码检查
- 遵循组件化开发原则
- 保持代码注释完整

### 提交规范
- feat: 新功能
- fix: 修复问题
- docs: 文档修改
- style: 代码格式修改
- refactor: 代码重构
- test: 测试用例修改
- chore: 其他修改

## 常见问题

### 安装问题
1. 依赖安装失败
   - 检查网络连接
   - 清除 npm 缓存
   - 使用国内镜像源

2. 编译错误
   - 检查 SDK 版本
   - 更新 DevEco Studio
   - 清理项目缓存

### 运行问题
1. 应用闪退
   - 检查权限设置
   - 查看错误日志

2. 功能异常
   - 检查网络连接
   - 清除应用缓存
   - 更新到最新版本

3. 读取异常
    - 类型检查
    - 路径检查
    - 更新到最新版本

## 版本历史
- v1.0.0 (2024-03-xx)
  - 首次发布
  - 基础音乐播放功能
  - 视频播放功能
  - 社交功能

## 贡献指南
1. Fork 本仓库
2. 创建功能分支
```bash
git checkout -b feature/AmazingFeature
```
3. 提交更改
```bash
git commit -m 'Add some AmazingFeature'
```
4. 推送到分支
```bash
git push origin feature/AmazingFeature
```
5. 提交 Pull Request

## 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 致谢
感谢所有为本项目做出贡献的开发者！
特别感谢：
- 鸿蒙开发社区
- 项目测试人员

#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)