⚠️ :开发中。。。
- 类型安全
- 空安全 (Dart Sound null safety)
- 方便地在 flutter 中使用
- 跨平台使用 (Windows, Linux, macOS, Web, iOS, Android)
- 搜索
- 搜索单曲 (支持分页)
- 搜索歌单 (支持分页)
- 搜索歌手 (支持分页)
- 搜索专辑 (支持分页)
- 搜索歌词 (支持分页)
- 聚合搜索 (支持分页)
- 音乐
- (聚合)音乐详情
- 播放文件地址
- 歌词&歌词翻译
- 专辑
- 专辑详情
- 歌单
- 歌单详情
- 歌单音乐 (支持分页)
- 歌手
- 歌手细节
- 歌手音乐 (支持分页)
所有平台的 Api 都基于抽象类 MusicApi
, 因此你可以在这里查看所有支持的 Api 方法的签名。
枚举类型 Platform
表示所有支持的音乐平台, 使用 Platform.xx.api
来获取某一平台的 Api 实例:
import 'package:dart_music_api/music_api.dart';
void main() {
final api = MusicPlatform.netEasy.api;
}
使用 MusicPlatformApi.combinedApi
来获取所有平台的聚合 Api 实例。
对于可分页的 Api, 将返回 ResultCursor
类型来支持分页操作,以下是 ResultCursor
的用法。
首先, 以搜索歌曲为例:
void main() {
MusicPlatformApi.combinedApi.searchSongs('安静');
}
设置数量限制 (你不用手动设置偏移,偏移将从0开始自动计算)
void main() {
MusicPlatformApi.combinedApi
.searchSongs('安静')
.limit(50);
}
开始执行搜索并返回结果 (ResultCursor
只有调用nextPage后才会真正开始进行搜索等操作)
void main() {
MusicPlatformApi.combinedApi
.searchSongs('安静')
.limit(50)
.nextPage();
}
MIT License
Copyright (c) 2021 fusée-code-lab
LICENSE file