# WindowsMediaPlayer

**Repository Path**: clintshaw/windows-media-player

## Basic Information

- **Project Name**: WindowsMediaPlayer
- **Description**: Windows平台的音视频播放器
- **Primary Language**: C++
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-11-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WindowsMediaPlayer 配置文档

## 项目简介

WindowsMediaPlayer 是一款专为 Windows 平台开发的轻量型音视频播放器，支持主流音视频格式解码，具备简洁易用的操作逻辑与稳定的播放性能，适用于日常本地音视频文件播放场景。本项目基于 GPL-2.0 开源协议，欢迎开发者参与贡献与二次开发。

## 软件架构

```plaintext
WindowsMediaPlayer/
├── bin/                # 编译输出目录（存放可执行文件与运行时依赖）
├── build/              # 构建辅助目录（工程文件、编译中间产物）
├── include/            # 公共头文件目录（模块接口定义，供跨模块引用）
│   ├── common/         # 通用工具类接口
│   ├── core/           # 播放器核心逻辑接口
│   └── dependency/     # 第三方依赖适配接口
├── lib/                # 第三方依赖库目录（预编译库文件）
│   ├── ffmpeg/         # FFmpeg 音视频解码库
│   │   ├── bin/        # FFmpeg 动态库（运行时依赖）
│   │   ├── include/    # FFmpeg 头文件（编译时依赖）
│   │   └── lib/        # FFmpeg 静态库（编译时链接）
│   └── sdl2/           # SDL2 多媒体开发库（渲染与输入处理）
│       ├── bin/        # SDL2 动态库（运行时依赖）
│       ├── include/    # SDL2 头文件（编译时依赖）
│       └── lib/        # SDL2 静态库（编译时链接）
├── src/                # 源代码目录（核心功能实现）
│   ├── common/         # 通用工具模块实现
│   ├── core/           # 播放器核心模块实现
│   └── dependency/     # 第三方依赖适配层实现
├── .gitignore          # Git 版本控制忽略配置
├── LICENSE             # GPL-2.0 开源协议
├── README.md           # 项目主文档（中文）
└── README.en.md        # 项目主文档（英文）
```

## 核心依赖

1. **SDL2**

   - 从 [SDL2 官方页面](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Flibsdl-org%2FSDL%2Freleases%2Ftag%2Frelease-2.32.2) 下载 `SDL2-devel-*-VC.zip` 。

   - 在项目根目录下创建

     ```
     lib/sdl2
     ```

2. **FFmpeg 7**

   - 从 [ffmpeg windows预编译库](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FShiftMediaProject%2FFFmpeg%2Freleases%2Ftag%2F7.0) 下载 MSVC 版本的库。

   - 在项目根目录下创建
   
     ```
     lib/ffmpeg
     ```

## 安装教程

1. **创建构建文件**

   ```
   cmake -S . -B build
   ```

2. **执行编译**

   ```
   cmake --build build
   ```

    产物按“架构+编译模式”分类存于项目根目录 `bin/` 下