# HBMusic

**Repository Path**: wuyuqing1/hbmusic

## Basic Information

- **Project Name**: HBMusic
- **Description**: 调好的程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-20
- **Last Updated**: 2024-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 鸿蒙, HarmonyOSNEXT

## README

# HBMusic

## 功能说明

这是一款基于
Media kit包含的AVMetadataExtractor，获取歌曲、专辑、歌手等信息能力、
AVSession kit 音频播放控制、
AVCodec kit 音频解码能力、
Audio kit 音频输出能力、
CoreFileKit fs文件管理、
BasicServicesKit 保持WiFi文件传输期间屏幕常亮
等kit开发的本地音乐播放器，集成Wifi传歌（ftp传歌、http传歌、本地文件拷贝至沙箱传歌），歌词滚动播放、后台播放、和播控中心的交互。
支持扫描音乐文件自动生成歌手专辑等信息， 支持读取app内沙盒文件夹下音频文件和歌词文件。

支持的格式为：支持格式：m4a、aac、mp3、ogg、wav、flac、amr。

## 开发者使用说明

1. 推荐使用真机查看本APP效果，可以点击左上角头像，选择Wifi传歌。从电脑传歌曲文件和同名同路径歌词文件到手机内查看效果。
2. 如果使用模拟器，由于系统安全限制不能直接传歌到沙盒文件夹，
   请使用示例内提供的copyfile方法，自行修改文件名和文件路径，将rawfile文件夹下的歌曲和歌词文件传到沙盒文件夹下查看效果。

## 使用限制和已知存在的问题

1. 目前由于操作系统和第三方库的原因，http传歌仅支持50MB以内音频文件，ftp传歌可能存在文件名乱码情况。
2. 目前登录账号、eq、mseb、peq、搜索等只有UI界面做效果展示、没有实际功能。

## 整体架构

```markdown
--products层: 组合业务单元成单一产品
--phone: 入口
--features层: 业务单元，相互之间无直接依赖
--home: 主页面
--albums: 专辑
--common层:  为业务无关公共能力
--constantsCommon: 代码公共能力
--mediaCommon: 媒体公共能力
```

![img.png](img.png)

## 效果图如下

![img_1.png](img_1.png)
![img_2.png](img_2.png)
![img_3.png](img_3.png)
![img_4.png](img_4.png)

## 需要权限

以下权限均不需要申请 可以直接使用
> 网络<pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#6a8759;">
> ohos.permission.INTERNET</span></pre>
> 网络状态<pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#6a8759;">
> ohos.permission.GET_NETWORK_INFO</span></pre>
> WIFI状态<pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#6a8759;">
> ohos.permission.GET_WIFI_INFO</span></pre>
> 后台运行<pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#6a8759;">
> ohos.permission.KEEP_BACKGROUND_RUNNING</span></pre>

## 依赖

> <pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#9876aa;">@ohos/ftp-srv</span></pre><pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#9876aa;">@wolfx/echarts_adaptor</span></pre><pre style="font-family:'JetBrains Mono',monospace;font-size:9.8pt;"><span style="color:#9876aa;">@ohos/polka</span></pre>

## 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS Beta5及以上。
3. DevEco Studio版本：DevEco Studio NEXT Beta5及以上。
4. HarmonyOS SDK版本：HarmonyOS NEXT Beta5 SDK及以上。
5. API版本： 12以上。

## 项目贡献者

1. 项目组织，代码编写，开源库作者，UI界面贡献，专家支持 等
2. 项目赞助 yangyt
3. 代码编写 UI界面贡献 NEVAR
4. 专家支持 http服务 htliang
5. UI界面贡献 wuyuqing1
6. ftp文件传输 xiagengwen
7. 专家支持 liujiling