Skip to content

About

Melotopia For HarmonyOS

Topics

Resources

Stars

271 stars

Watchers

1 watching

Forks

Latest commit

 

History

98 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Melotopia

HamonyOS 原生音乐播放器

随缘更新~


📖 项目概述

【本地曲库】 一键扫描并导入本地音乐文件,支持多种音频格式,随时随地畅听。

【在线播放】 支持通过 API 连接至在线平台,联网获取云端歌曲。

【界面设计】 简洁流畅,操作直观。支持自定义背景与主题色,打造用户个性化风格。

【多端适配】 支持直屏、平板、折叠屏及 PC 设备,在各种终端上都能获得流畅的播放体验。


🛠️ 技术栈

类别 技术实现
开发语言 ArkTS
最低API版本 OHOS API 23
目标API版本 OHOS API 26.0.0

📦 安装方式

1.源码编译

git clone https://github.com/Chenlvin/Melotopia-HMOS

2.签名安装Hap包

GitHub Releases

注: 由于 HUAWEI HiCar 的白名单限制, 需要签名安装带 "[HiCar]" 的Hap包, 连接 HiCar 后, 需要在 HiCar上的应用尝鲜区添加"咪咕音乐", 添加后即可在HiCar上使用本应用 (HiCar 是通过修改应用包名实现的,修改的应用包名为咪咕音乐,因此无法和应用市场的咪咕音乐APP共存)


🧰 实现功能

云端API:

  • 在线播放
  • 每日推荐(支持历史日推)
  • 音乐云盘
  • 私人漫游
  • 心动歌单
  • 雷达歌单与推荐歌单
  • 排行榜
  • 内容搜索(单曲、歌单、歌手、专辑、播客)
  • 查看个人歌单、专辑、播客
  • 歌单详情页(支持收藏、隐私设置、编辑歌单)
  • 专辑详情页(支持收藏)
  • 播客详情页(支持收藏)
  • 歌手页面(支持查看热门单曲、所有单曲、专辑)
  • 查看评论(单曲、歌单、歌手、专辑、播客)
  • 本地歌曲在线匹配歌曲信息
  • 无歌词歌曲自动寻找歌词
  • 听歌打卡(播放记录上报云端)

本地功能:

  • 本地离线播放
  • 本地音乐导入(支持内嵌歌词、内嵌专辑封面)

(本地音乐支持导入外置 .jpg/png 格式封面和 .lrc 格式歌词文件,与音频文件放在同一目录下即可自动扫描)

播放相关功能:

  • 全屏播放器
  • 横屏播放器
  • 定时关闭
  • 播放列表
  • 云端歌曲缓存
  • EQ均衡器(新版播放引擎)
  • 支持读写音频文件元数据

🎵 本地播放

由于鸿蒙系统限制,应用无法实现全局扫描,只能扫描下载目录。

导入本地歌曲步骤:

1.打开系统文件管理器,将本地音频文件、封面图、歌词文件放入“我的手机/Download/Melotopia”根目录

2.在应用首页点击底部“本地”切换至本地Tab页

3.点击本地Tab页右上方的音符图标,选择“导入本地歌曲”

4.应用会自动扫描Download目录下的音频、封面、歌词

5.扫描完毕后点击右上方“导入”按钮即可导入歌曲

说明:

  • 由于鸿蒙系统限制,仅支持应用 Download 目录下文件的扫描
  • 仅支持扫描根目录,无法扫描子文件夹
  • 音频文件支持格式:.mp3 .flac .wav .aac .ogg .wma .m4a
  • 封面图片支持格式:.jpg .png
  • 歌词文件支持格式:.lrc (不支持逐字歌词)

☁️ 云端 API

可在应用 “我的”—“应用设置”—“云端” 中填入API接口地址以接入在线平台

支持的API:

ⓘ 本应用仅供学习与技术研究使用,所有音乐内容均通过官方途径获取。仅支持在用户已有合法权限下的播放与下载,严禁用于商业用途或非法传播。请遵守相关法律法规与平台协议。


⚠️ 免责声明

❗ 重要提示:

  1. 本应用为纯界面实现层,不内置/分发任何音源内容
  2. 应用默认仅提供本地播放功能,云端/在线内容需由用户自行搭建合规服务,由此产生的版权问题与开发者无关
  3. 禁止将本项目用于二次分发受版权保护的内容

📧 联系方式

Email: chenlvin126@outlook.com

QQ 交流群:

  • ①群 1019225012
  • ②群 1104358913

✨ 参与贡献


📱 界面预览

Phone - 手机设备

发现 音乐云盘 播放器
播放页功能 歌词界面 播放列表
歌手页面 专辑页面 评论页面
横屏播放器

Tablet - 平板设备

播控/歌词界面 歌单页面

Foldable - 折叠设备

歌单页面 播控/歌词界面
Pura X 外屏 - 播放器界面 Pura X 外屏 - 歌词界面

PC/2in1 设备

专辑页面 播控/歌词界面

About

Melotopia For HarmonyOS

Topics

Resources

Stars

271 stars

Watchers

1 watching

Forks

Releases

Contributors