# codec

**Repository Path**: linseyaofeihu/codec

## Basic Information

- **Project Name**: codec
- **Description**: Claude大模型自动编程完成的一个codec播放器，支持FLV/ASF/WMA/RM/H264/AVI/FLAC等各种分辨率的解码
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-02-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Codec SDK

跨平台音视频编解码SDK，支持多种主流格式。

## 快速开始

### 一键运行

```bash
# 1. 安装依赖（首次运行）
./scripts/install_deps.sh

# 2. 构建
./scripts/build.sh

# 3. 运行UI播放器
./scripts/run_ui.sh [文件路径]

# 4. 运行测试
./scripts/run_tests.sh

# 5. 完整功能测试
./scripts/test_all.sh
```

## 支持的格式

**视频容器**: MP4, 3GP, MKV, DIVX, MPEG, FLV, TS, 3G2, MPG, ASF, RM, RV, MOV ✅

**音频容器/编码**: MP3, WMA, AAC, M4A, M4B, WAV, APE, FLAC, MKA, OGG ✅

> 说明：基于 FFmpeg 解码能力，未知编解码将使用 FFmpeg 原始 `codec id` 回退处理。

## 性能

- **目标帧率**: ≥30fps（以源帧率与硬件性能为准）
- **解码延迟**: <10ms（目标）
- **内存占用**: 正常（依赖分辨率与缓存）
- **播放质量**: 以“无花屏/无爆破音/无杂音”为目标，当前仍在回归验证中

## 文档

- **[最终状态](docs/FINAL_STATUS.md)** 📋 最新状态与回归要求
- **[调试总结](KIRO.md)** 🔧 完整问题诊断与修复记录
- **[快速参考](docs/快速参考.md)** ⭐ 常用命令和API
- [完整文档索引](docs/INDEX.md)
- [快速开始](docs/README.md)
- [编译指南](docs/编译指南.md)
- [API文档](docs/API文档.md)
- [架构设计](docs/架构设计文档.md)
- [FFmpeg集成](docs/FFmpeg集成完成报告.md)
- [项目总结](docs/项目总结.md)
- [完成报告](docs/项目完成报告.md)

## 测试结果

**单元测试**: 以 `tests/codec_decode_test.cpp` 与 `tests/ffmpeg_demuxer_test.cpp` 为准，样例缺失会自动跳过。

**UI播放器**: 播放质量需结合实际样例回归验证（尤其是 `mpg/mpeg`、`mp2` 音频流）。

## 开发

```bash
# 调试构建
./scripts/build.sh --debug

# 清理重建
./scripts/build.sh --clean

# 只构建库（不构建UI）
./scripts/build.sh --no-ui
```

## 许可

详见LICENSE文件