酷影播放器 (CorePlayer)

酷影播放器 CorePlayer - 酷炫影音，畅享无限

极致播放，智能管理，跨界体验

English | 中文

🎯 品牌理念

酷影——酷炫的影音体验，让观影更加精彩。

• 酷：酷炫、先进，代表我们的现代化设计和技术实力
• 影：影音、视频，我们的核心服务

我们致力于打造最酷炫、最智能、最流畅的视频播放和管理平台，让每一次观影都成为享受。

📦 版本说明

我们采用双版本策略，以满足不同用户的需求。通过 EDITION 编译标志进行区分。

社区版 (Community Edition)

面向个人用户和开源社区，提供纯粹的本地播放体验。

• ✅ 基础本地视频播放
• ✅ 网络视频播放和缓存
• ✅ 播放历史和断点续播
• ✅ 字幕加载和自定义
• ✅ 媒体库管理 (本地文件)
• ⚠️ 高级网络功能 (SMB/NAS) 需升级到专业版

专业版 (Professional Edition)

面向发烧友和企业用户，提供完整的家庭影院解决方案。

• ✅ 包含社区版所有功能
• ✅ SMB/CIFS 网络共享访问 (NAS/Windows共享)
• ✅ 自动元数据刮削 (海报墙、剧集信息自动匹配)
• ✅ FTP/SFTP 安全文件传输
• ✅ NFS 网络文件系统支持
• ✅ WebDAV 协议支持
• ✅ HEVC/H.265 专业解码器 (软硬解优化)
• ✅ AI 智能字幕
• ✅ 多设备同步

💡 提示: 在社区版中尝试使用 SMB 或元数据刮削功能时，系统会自动屏蔽相关入口或显示友好的升级提示。

✨ 核心特性

🎬 本地播放

• ✅ 跨平台支持 - 支持 iOS、Android、Web、Windows、macOS、Linux
• ✅ 超高清播放 - 完整支持 4K/8K 视频，硬件加速解码
• ✅ 多格式支持 - MP4、MKV、AVI、MOV、WebM 等主流格式
• ✅ 智能硬件加速 - 自动启用 VideoToolbox、DXVA2、VAAPI 等
• ✅ HDR 视频支持 - HDR10、HLG 等高动态范围格式
• ✅ 完整播放控制 - 播放/暂停、进度调节、音量控制、全屏模式

🖼️ 智能海报墙 (专业版)

• ✅ 自动刮削 - 扫描视频时自动从 TMDB 获取海报、背景图和简介
• ✅ 智能识别 - 自动解析文件名中的剧集信息 (S01E01)
• ✅ 精美展示 - 告别冰冷的文件列表，享受 Netflix 般的浏览体验
• ✅ 后台运行 - 静默处理，不打扰前台操作

🌐 网络功能

• ✅ 网络视频播放 - 支持 HTTP/HTTPS 直链播放
• ✅ HLS 流媒体 - 支持 m3u8 自适应流播放
• ✅ 智能缓存系统 - 边播边缓存，节省流量
• ✅ 缓存优先加载 - 已缓存视频秒开，无需等待
• ✅ 断点续传 - 网络中断自动恢复播放
• ✅ URL 历史管理 - 快捷访问常用视频源

🏠 媒体服务器集成 (专业版)

• 🔒 SMB/NAS 支持 - 直接访问网络共享文件夹 (专业版)
• 🔒 Emby 集成 - 完整的 Emby 媒体服务器支持 (专业版)
• 🔒 Jellyfin 集成 - Jellyfin 媒体库无缝访问 (专业版)
• 🔒 Plex 集成 - Plex 服务器内容播放 (专业版)
• ✅ 服务器管理 - 添加、编辑、删除多个媒体服务器
• ✅ 远程缩略图 - 自动获取和缓存视频封面

📝 字幕功能

• ✅ 多格式字幕 - 支持 SRT、ASS、SSA、VTT 等格式
• ✅ 外部字幕加载 - 自动匹配同名字幕文件
• ✅ 字幕样式自定义 - 字体大小、颜色、位置调节
• ✅ 多语言切换 - 支持多字幕轨道切换
• ✅ 字幕同步 - 精确调节字幕延迟
• ✅ 编码自动检测 - 智能识别 UTF-8、GBK 等编码

🎨 现代化界面

• ✅ 深色主题设计 - 护眼的深色界面风格
• ✅ 侧边栏导航 - 清晰的导航结构
• ✅ 响应式布局 - 自适应各种屏幕尺寸
• ✅ 流畅动画 - 精致的悬停和切换动画
• ✅ 卡片式设计 - 现代化的视频卡片展示

📊 播放历史

• ✅ 智能记录 - 自动记录观看进度
• ✅ 断点续播 - 从上次位置继续观看
• ✅ 搜索过滤 - 按名称、状态、时间筛选
• ✅ 批量管理 - 多选删除历史记录
• ✅ 缩略图预览 - 视频封面快速识别
• ✅ 播放统计 - 详细的观看数据

⚡ 性能监控

• ✅ 实时性能面板 - CPU、GPU、内存占用监控
• ✅ 帧率监控 - 实时显示播放帧率
• ✅ 视频信息查看 - 编解码器、分辨率、码率等参数
• ✅ 性能指示器 - 颜色编码的性能状态显示
• ✅ 播放质量切换 - 自动/高质量/低功耗/兼容模式

🚀 快速开始

环境要求

Flutter 3.38.1 或更高版本
Dart 3.10.0 或更高版本

安装依赖

flutter pub get

运行应用

# 运行到Chrome浏览器
flutter run -d chrome

# 运行到指定平台
flutter run -d android    # Android设备
flutter run -d ios       # iOS设备
flutter run -d macos     # macOS桌面
flutter run -d windows   # Windows桌面
flutter run -d linux     # Linux桌面

构建发布版本

构建社区版 (Community Edition):

flutter build macos --release

构建专业版 (Professional Edition):

flutter build macos --release --dart-define=EDITION=pro

🏗️ 项目架构

CorePlayer 采用先进的插件化架构，将核心播放功能与商业增值功能彻底解耦。

核心目录结构

lib/
├── main.dart                              # 应用入口
│
├── core/                                  # 核心系统 (The Core)
│   ├── plugin_system/                     # 🔌 插件系统引擎 ⭐
│   │   ├── plugin_loader.dart             # 插件加载器 (负责版本控制)
│   │   ├── plugin_registry.dart           # 插件注册中心
│   │   ├── core_plugin.dart               # 插件基类
│   │   ├── edition_config.dart            # 版本配置 (Community/Pro)
│   │   └── plugins/                       # 核心插件接口
│   └── ...
│
├── plugins/                               # 🧩 插件仓库
│   ├── builtin/                           # 内置插件 (所有版本可用)
│   │   ├── subtitle/                      # 字幕支持
│   │   ├── audio_effects/                 # 音频效果
│   │   └── metadata/                      # 基础元数据接口
│   │
│   ├── commercial/                        # 商业插件 (Adapter层 - 仅专业版激活) 🔒
│   │   ├── media_server/
│   │   │   └── smb/                       # SMB 协议适配器
│   │   └── metadata_scraper/              # 自动刮削适配器
│   │       └── metadata_scraper_plugin.dart # 桥接私有库实现
│   │
│   └── third_party/                       # 第三方插件示例
│
├── services/                              # 业务服务层
│   ├── metadata_scraper_service.dart      # 刮削服务 Facade (自动降级) ⭐
│   ├── file_source_factory.dart           # 文件源工厂 (SMB/Local路由) ⭐
│   └── ...

架构亮点:

1. 🛡️ 安全隔离: 核心商业算法与敏感协议栈置于外部私有库，主仓库仅保留适配器接口。
2. 🔌 动态插件: 支持运行时插件热更新与动态加载，实现功能模块的即插即用。
3. 🧩 优雅降级: 商业插件在社区版环境中自动静默禁用，确保基础功能稳定运行且无侵入性。

外部依赖结构 (Pro Only 🔒)

~/project/core-player-pro-plugins/         # 🔒 私有插件库
├── lib/
│   ├── src/
│   │   ├── media_server/
│   │   │   ├── smb/                       # SMB 完整协议实现
│   │   │   └── metadata/                  # 智能刮削核心逻辑
│   │   └── advanced_decoder/              # HEVC/AV1 高级解码器
│   └── coreplayer_pro_plugins.dart        # 导出接口

🤝 贡献指南

我们欢迎所有开发者参与贡献！无论是bug修复、功能建议还是代码优化，我们都非常感激。

如何贡献

1. Fork 本仓库
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

📝 许可证

本项目采用双重许可模式：

社区版 (Community Edition)

• 许可证: MIT License
• 使用范围: 个人学习、开源项目、非商业用途
• 功能限制: 不包含 SMB/NAS、自动刮削等高级功能
• 源代码: 完全开源，可自由修改和分发

专业版 (Professional Edition)

• 许可证: 商业许可 (查看 LICENSE_COMMERCIAL.md)
• 使用范围: 商业使用、企业部署
• 功能: 包含所有高级功能（SMB、海报墙、AI 字幕等）
• 支持: 提供技术支持和定制服务
• 获取方式: 联系作者获取授权

💡 如需商业授权或了解专业版详情，请联系作者：peterfeispace@gmail.com

🙏 致谢

• Flutter - 优秀的跨平台开发框架
• media_kit - 强大的视频播放引擎
• MPV - 高性能多媒体播放器内核
• file_picker - 便捷的文件选择插件
• shelf - 轻量级 HTTP 服务器

📞 联系我们

作者: peterfei

如果您有任何问题、建议或合作意向，欢迎通过以下方式联系我们：

• 📧 邮箱: peterfeispace@gmail.com
• 🐙 GitHub: https://github.com/peterfei/core-player
• 🐛 Issues: 项目Issues页面

---

**酷影播放器 CorePlayer** - 酷炫影音，畅享无限

极致播放，智能管理，跨界体验

Made with ❤️ by peterfei