# LrcParser

**Repository Path**: s-gaolei/lrc_parser

## Basic Information

- **Project Name**: LrcParser
- **Description**: LrcParser 是一个基于 C++ TagLib 库的歌词解析模块，可用于解析歌曲文件的内嵌歌词。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-15
- **Last Updated**: 2025-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LrcParser

![项目状态](https://img.shields.io/badge/status-stable-green.svg)
![依赖版本](https://img.shields.io/badge/taglib-v2.0.2-blue.svg)
![平台支持](https://img.shields.io/badge/platforms-HarmonyOS-lightgreen.svg)


## 项目简介
**LrcParser** 是一个基于 C++ `TagLib` 库的歌词解析模块，专为鸿蒙系统（HarmonyOS）设计，提供 **ArkTS** 语言调用接口。支持解析 **FLAC**、**MP3**、**OGG** 等格式音乐文件的内嵌歌词，适用于鸿蒙音乐类应用开发。


## 核心功能
1. **多格式歌词解析**：
    - **FLAC**：解析 Vorbis 注释中的 `LYRICS` 标签
    - **MP3**：解析 ID3v2 标签中的 `USLT` 帧（非同步歌词）
    - **OGG**：解析 Vorbis 注释中的 `LYRICS` 标签

2. **鸿蒙原生支持**：  
   通过 C++ 动态库（`.so`）与 ArkTS 桥接，符合鸿蒙应用开发规范。

3. **高性能解析**：  
   基于 TagLib 原生实现，解析效率高，资源占用低。

## 下载安装

```shell
ohpm install @sgaolei/lrc_parser
```

## 使用说明

### 1. 导入模块

```typescript
import { LrcParser } from '@sgaolei/lrc_parser';
```
### 2. 解析歌词

```typescript
const lrc = lrcParser.getLyrics('path/to/music.flac');
console.log(lrc);
```