# HMMusic

**Repository Path**: ruanjunhao/hmmusic-hh

## Basic Information

- **Project Name**: HMMusic
- **Description**: 鸿蒙音乐app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-07
- **Last Updated**: 2025-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# hmmusic-hh

## 项目介绍
hmmusic-hh 是一个基于鸿蒙系统的音乐播放应用。该应用支持播放、暂停、切换歌曲、播放模式设置、歌词加载等基础音乐播放功能，并提供组件化设计以方便扩展。

## 功能特性
- 音乐播放和控制
- 播放模式切换（列表循环、单曲循环、随机播放）
- 歌词同步显示
- 歌单管理
- AVSession 状态管理

## 安装说明
1. 确保已安装 [鸿蒙开发环境](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5)
2. 克隆本仓库到本地：
   ```bash
   git clone https://gitee.com/dejks123/hmmusic-hh
   ```
3. 在 DevEco Studio 中打开项目并运行

## 使用说明
- 点击歌曲项开始播放音乐
- 在播放详情页可查看歌词并进行播放控制
- 可通过界面切换播放模式
- 支持后台播放和前台AVSession控制

## 项目结构
- `common/utils` - 公共组件和播放器核心逻辑
- `features/home` - 首页、播放详情页等主要功能模块
- `products/entry` - 应用入口和主配置

## 许可协议
本项目采用 Apache-2.0 协议。详情请参考各模块中的 LICENSE 文件。

## 贡献指南
欢迎贡献代码和提出建议！请遵循以下步骤：
1. Fork 项目
2. 创建新分支
3. 提交您的修改
4. 创建 Pull Request

## 依赖
- @hadss/hmrouter
- @ohos/axios
- @pura/harmony-utils

## 版本
1.0.0

## 开发者
[dejks123]