# CCPlayer

**Repository Path**: Vam1311459/ccplayer

## Basic Information

- **Project Name**: CCPlayer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-31
- **Last Updated**: 2025-11-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CCPlayer

一个基于Qt框架开发的多功能媒体播放器应用，支持音频和视频文件的播放、控制及基本的媒体信息展示功能。

---

## 📌 项目特点

- **音频播放**：支持常见音频格式的播放、暂停、停止、快进、快退、音量调节、播放速率调节等功能。
- **视频播放**：支持视频播放控制，包括全屏切换、比例调整、播放状态管理等。
- **播放列表与搜索**：提供搜索组件，支持文件打开、搜索建议、搜索框交互等。
- **界面分层管理**：通过 `LayerContainer` 实现界面层级管理，便于构建复杂的UI交互。
- **现代UI设计**：采用模块化设计，支持现代播放器界面组件，如控制面板、文件浏览器等。

---

## 📁 主要组件

- `AudioPlayer`：音频播放核心类，封装播放、暂停、跳转、状态监听等功能。
- `VideoPlayer`：视频播放核心类，继承自 `QWidget`，提供视频播放控制和状态反馈。
- `ModernVideoPlayer`：现代风格的视频播放器主界面，集成控制组件。
- `PlayerControls`：播放器控制面板，包含播放、暂停、进度条、音量控制等。
- `CombinedSearchWidget` / `EnhancedSearchWidget`：搜索组件，支持文本输入、建议列表、快捷操作等。
- `SmartFileBrowser`：文件浏览组件，支持本地媒体文件选择。
- `LayerContainer`：界面层级管理组件，支持多层界面切换与布局。

---

## 🛠️ 开发环境

- **语言**：C++ (Qt)
- **框架**：Qt 5 或 Qt 6（依赖 QMediaPlayer 模块）
- **构建工具**：qmake（`.pro` 项目文件）

---

## 🚀 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/Vam1311459/ccplayer.git
cd ccplayer
```

### 2. 构建项目

使用 Qt Creator 打开 `CCPlayer.pro` 文件并构建项目，或使用命令行：

```bash
qmake CCPlayer.pro
make
```

### 3. 运行程序

```bash
./CCPlayer
```

---

## 📚 使用说明

- 点击菜单栏的“打开文件”或“打开文件夹”加载媒体文件。
- 使用播放控制面板进行播放、暂停、跳转、音量调节等操作。
- 支持通过搜索框快速查找媒体内容（如播放列表项）。
- 视频播放时可双击切换全屏模式，支持自动检测视频分辨率和比例。

---

## 🤝 贡献指南

欢迎提交 Pull Request 或 Issue。请遵循以下原则：

- 提交清晰的代码变更说明。
- 保持代码风格与项目一致。
- 提供必要的测试逻辑（如适用）。

---

## 📄 许可证

该项目未明确指定开源许可证。如需使用，请联系作者确认授权方式。