跳到主要内容

支持 Android 与 iOS 的 React Native 本地音乐库

通过一套类型安全的 API,访问设备上的曲目、专辑、艺术家、封面、歌词和音频元数据。

安装npm install @nodefinity/react-native-music-library

一套 API 访问 Android 和 iOS 本地音乐库

直接访问曲目、专辑、艺术家、封面、歌词和详细音频元数据,构建本地音乐浏览器和播放器。

Android MediaStore

通过 Android MediaStore 查询本地曲目、专辑和艺术家,并支持排序和目录过滤。

iOS 音乐资料库

通过 MediaPlayer 和 MPMediaQuery,使用同一套 JavaScript API 访问用户的音乐资料库。

曲目元数据

读取比特率、采样率、声道、格式、流派、作曲者,以及音乐库或曲目内嵌的其他元数据。

封面与歌词

展示封面引用,并读取本地音乐库提供或内嵌在曲目中的歌词。

游标分页

通过类型安全的游标、可配置的分页大小和灵活排序,高效加载大型音乐库。

React Native 新架构

基于 TurboModules 和 TypeScript,提供原生且类型安全的 React Native 集成。

几分钟内开始查询本地音乐库

使用游标分页获取曲目,并只在需要时加载详细元数据。

import {
  getTracksAsync,
  getTrackMetadataAsync,
} from '@nodefinity/react-native-music-library';

const page = await getTracksAsync({ first: 20 });
const metadata = await getTrackMetadataAsync(page.items[0].id);
阅读配置指南