music-metadata完全指南从安装到高级API调用的完整教程【免费下载链接】music-metadataStream and file based music metadata parser for node. Supporting a wide range of audio and tag formats.项目地址: https://gitcode.com/gh_mirrors/mu/music-metadatamusic-metadata是一款功能强大的Node.js音乐元数据解析库支持多种音频格式和标签类型能够高效提取音乐文件中的详细信息。无论是构建音乐播放器、媒体管理工具还是音频处理应用music-metadata都能为你提供全面的元数据解析支持。 为什么选择music-metadatamusic-metadata作为一款专业的音乐元数据解析工具具有以下核心优势全面的格式支持兼容MP3、MP4、FLAC、Ogg、WAV、AIFF等多种音频格式满足不同场景需求丰富的元数据提取支持ID3v1、ID3v2、APE、Vorbis等多种标签格式获取详细的音乐信息流式处理能力支持从文件流中解析元数据适合处理大文件和网络流跨平台兼容性可在Node.js和浏览器环境中使用灵活性高Promise-based API现代异步接口设计易于集成到各种工作流中 快速开始安装与基础使用环境准备使用music-metadata前确保你的开发环境满足以下要求Node.js ≥ 18npm或yarn包管理工具安装步骤通过npm安装npm install music-metadata或使用yarnyarn add music-metadata如果需要从源码构建可以克隆仓库git clone https://gitcode.com/gh_mirrors/mu/music-metadata cd music-metadata npm install npm run build基础示例解析本地音频文件以下是一个简单的示例展示如何解析本地音频文件的元数据import { parseFile } from music-metadata; import { inspect } from node:util; (async () { try { const filePath path/to/your/audio/file.mp3; const metadata await parseFile(filePath); // 以可读格式输出解析结果 console.log(inspect(metadata, { showHidden: false, depth: null })); } catch (error) { console.error(解析元数据时出错:, error.message); } })(); 核心API详解music-metadata提供了多种解析函数适用于不同场景文件解析parseFileparseFile函数用于解析本地文件系统中的音频文件是Node.js环境下最常用的方法parseFile(filePath: string, options?: IOptions): PromiseIAudioMetadata参数说明filePath: 音频文件的路径options: 可选配置对象可指定是否计算时长、是否跳过封面图片等流解析parseStream对于需要处理流数据的场景可以使用parseStream函数parseStream(stream: Readable, fileInfo?: IFileInfo | string, options?: IOptions): PromiseIAudioMetadata示例import { parseStream } from music-metadata; import { createReadStream } from fs; (async () { try { const audioStream createReadStream(path/to/audio/file.mp3); const metadata await parseStream(audioStream, { mimeType: audio/mpeg }); console.log(metadata); } catch (error) { console.error(解析流时出错:, error.message); } })();跨平台解析函数music-metadata还提供了适用于浏览器环境的解析函数parseWebStream: 解析Web ReadableStreamparseBlob: 解析Blob或File对象parseBuffer: 解析Uint8Array或Buffer⚙️ 高级配置选项通过IOptions接口你可以自定义解析行为interface IOptions { duration?: boolean; // 是否计算时长 includeChapters?: boolean; // 是否包含章节信息 skipCovers?: boolean; // 是否跳过封面图片 skipPostHeaders?: boolean; // 是否跳过文件末尾的标签头 // 更多配置... }示例跳过封面图片以提高解析速度const metadata await parseFile(filePath, { skipCovers: true }); 解析结果结构解析返回的IAudioMetadata对象包含丰富的信息interface IAudioMetadata { format: IFormat; // 音频格式信息 common: ICommonTags; // 通用标签 native: INativeTags; // 原始标签 trackInfo?: ITrackInfo[]; // 音轨信息 }格式信息(format)包含音频编码格式、比特率、采样率等技术信息{ container: mp3, codec: MPEG 1 Layer 3, bitrate: 128000, sampleRate: 44100, duration: 215.32, // 更多信息... }通用标签(common)标准化的标签信息统一不同格式的标签命名{ title: Song Title, artist: [Artist Name], album: Album Name, year: 2023, track: { no: 3, of: 12 }, // 更多标签... }️ 处理封面图片music-metadata能够提取音频文件中嵌入的封面图片import { parseFile, selectCover } from music-metadata; (async () { const { common } await parseFile(filePath); const cover selectCover(common.picture); // 选择封面图片 if (cover) { console.log(封面格式: ${cover.format}); console.log(封面尺寸: ${cover.data.length} 字节); // 在浏览器中显示封面 // img.src data:${cover.format};base64,${uint8ArrayToBase64(cover.data)}; } })(); 错误处理music-metadata提供了细致的错误处理机制import { parseFile, CouldNotDetermineFileTypeError } from music-metadata; (async () { try { const metadata await parseFile(unknown-file.dat); } catch (error) { if (error instanceof CouldNotDetermineFileTypeError) { console.error(无法确定文件类型); } else if (error instanceof UnsupportedFileTypeError) { console.error(不支持的文件类型); } else { console.error(解析错误:, error.message); } } })(); 实用工具函数music-metadata还提供了一些实用工具函数orderTags: 整理标签import { parseFile, orderTags } from music-metadata; const metadata await parseFile(filePath); const orderedTags orderTags(metadata.native[ID3v2.3]);ratingToStars: 评分转换import { ratingToStars } from music-metadata; // 将标准化评分转换为0-5星 const stars ratingToStars(metadata.common.rating); 支持的格式与标签music-metadata支持多种音频格式和标签标准音频格式支持格式描述MP3MPEG-1 / MPEG-2 Audio Layer IIIFLACFree Lossless Audio CodecMP4MPEG-4 (mp4, m4a, m4v)OggOgg容器格式 (Vorbis, Opus, Speex)WAVRIFF/WAVAIFFAudio Interchange File FormatAPEMonkeys AudioDSDDSDIFF, DSF标签格式支持ID3v1, ID3v2.2, ID3v2.3, ID3v2.4APEv2Vorbis CommentiTunes/MP4RIFF/INFOLyrics3 官方资源完整API文档: doc/common_metadata.md示例代码: example/javascript/测试用例: test/ 总结music-metadata是一款功能全面、易于使用的音乐元数据解析库无论你是开发音乐应用、媒体管理工具还是需要处理音频文件的元数据它都能提供强大的支持。通过本指南你已经了解了从安装到高级API调用的全部内容现在可以开始在你的项目中使用music-metadata来提取和处理音频元数据了无论是简单的标签提取还是复杂的流式处理music-metadata都能满足你的需求帮助你构建更完善的音频应用。【免费下载链接】music-metadataStream and file based music metadata parser for node. Supporting a wide range of audio and tag formats.项目地址: https://gitcode.com/gh_mirrors/mu/music-metadata创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考