OrangePlayer：一个功能完整的 Android 视频播放器开源库
前言
最近在开发一个视频播放相关的项目，需要实现弹幕、字幕、OCR 识别等功能。调研了市面上的开源播放器库后，发现虽然 GSYVideoPlayer 很强大，但要实现这些功能还需要大量的二次开发。于是我基于 GSYVideoPlayer 开发了 OrangePlayer，将这些常用功能都封装好了，开箱即用。
今天分享给大家，希望能帮助到有类似需求的朋友。
项目介绍
GitHub 地址：https://github.com/706412584/orangeplayer
主要特性：
- 🎬 多播放内核：支持系统/ExoPlayer/IJK/阿里云，可运行时切换
- 📝 字幕系统：支持 SRT/ASS/VTT 格式，大小可调
- 🔤 OCR 识别：使用 Tesseract 识别硬字幕 + ML Kit 翻译
- 🎤 语音识别：Vosk 离线语音识别，实时生成字幕
- 💬 弹幕功能：大小/速度/透明度可调，支持发送
- 🎛️ 倍速播放：0.35x - 10x，支持长按倍速
- ⏰ 定时关闭：30/60/90/120 分钟
- ⏭️ 跳过片头尾：0-300 秒可调
- 📺 投屏功能：DLNA 投屏支持
- 🖼️ 画中画：PiP 小窗模式
快速开始
1. 添加依赖
dependencies { // OrangePlayer 核心库 implementation 'com.github.706412584:orangeplayer:v1.0.5' // GSY 基础依赖（必需） implementation 'io.github.carguo:gsyvideoplayer-java:11.3.0' // ExoPlayer 播放内核（推荐） implementation 'io.github.carguo:gsyvideoplayer-exo2:11.3.0' } 2. 布局文件
<com.orange.playerlibrary.OrangevideoViewandroid:id="@+id/video_player"android:layout_width="match_parent"android:layout_height="200dp"/>3. 代码使用
OrangevideoView mVideoView =findViewById(R.id.video_player);// 设置视频地址和标题 mVideoView.setUp("https://example.com/video.mp4",true,"示例视频");// 开始播放 mVideoView.startPlayLogic();就这么简单！OrangePlayer 会自动创建和配置所有 UI 组件。
核心功能详解
1. 弹幕系统
OrangePlayer 集成了 DanmakuFlameMaster，提供完整的弹幕功能：
// 获取弹幕控制器IDanmakuController danmakuController = videoController.getDanmakuController();// 发送弹幕 danmakuController.addDanmaku("这是一条弹幕",true);// 暂停/恢复弹幕 danmakuController.pause(); danmakuController.resume();// 调整弹幕设置 danmakuController.setDanmakuSpeed(1.5f);// 速度 danmakuController.setDanmakuAlpha(0.8f);// 透明度2. 字幕功能
支持 SRT、ASS、VTT 三种常见字幕格式：
// 加载字幕文件 videoController.loadSubtitle("https://example.com/subtitle.srt");// 或从本地加载 videoController.loadSubtitle("/sdcard/subtitle.srt");// 切换字幕显示 videoController.toggleSubtitle();3. OCR 字幕识别
这是 OrangePlayer 的特色功能之一，可以识别视频画面中的硬字幕并翻译：
// 检查 OCR 功能是否可用if(OcrAvailabilityChecker.isOcrTranslateAvailable()){// 通过 UI 启动 OCR// 用户点击字幕按钮 -> OCR 翻译字幕 -> 设置识别区域 -> 选择语言}实现原理：
- 使用 Tesseract OCR 引擎识别画面中的文字
- 使用 ML Kit Translation API 翻译识别结果
- 实时显示翻译后的字幕
4. 语音识别字幕
另一个特色功能，可以实时识别视频音频并生成字幕：
// 检查语音识别是否可用（需要 Android 10+）if(VoskAvailabilityChecker.isVoskAvailable()){// 通过 UI 启动语音识别// 用户点击字幕按钮 -> 语音识别翻译 -> 选择语言}实现原理：
- 使用 AudioPlaybackCapture API 捕获应用内音频
- 使用 Vosk 离线语音识别引擎识别音频
- 实时显示识别结果
5. 多播放内核切换
支持 4 种播放内核，可以根据视频格式和性能需求动态切换：
// 切换到 ExoPlayer（推荐） videoView.selectPlayerFactory(PlayerConstants.ENGINE_EXO);// 切换到 IJK 播放器 videoView.selectPlayerFactory(PlayerConstants.ENGINE_IJK);// 切换到系统播放器 videoView.selectPlayerFactory(PlayerConstants.ENGINE_DEFAULT);技术亮点
1. 组件化架构
OrangePlayer 采用组件化设计，每个功能都是独立的组件：
PrepareView- 准备界面TitleView- 标题栏VodControlView- 点播控制器CompleteView- 播放完成界面ErrorView- 错误界面GestureView- 手势提示
这种设计使得功能扩展和自定义变得非常简单。
2. 状态管理
播放器状态分为两类：
- 播放状态：IDLE、PREPARING、PLAYING、PAUSED、BUFFERING、ERROR、COMPLETED
- 播放器状态：NORMAL、FULL_SCREEN、TINY_SCREEN
通过监听器可以实时获取状态变化：
videoView.addOnStateChangeListener(newOnStateChangeListener(){@OverridepublicvoidonPlayStateChanged(int playState){// 播放状态变化}@OverridepublicvoidonPlayerStateChanged(int playerState){// 播放器状态变化}});3. 性能优化
- 内存优化：及时释放资源，避免内存泄漏
- 渲染优化：使用 SurfaceView/TextureView 双模式
- 缓冲优化：智能预加载和缓存策略
- 电量优化：后台自动暂停，前台恢复
实际应用场景
OrangePlayer 适用于以下场景：
- 在线视频 App：支持多种视频格式和流媒体协议
- 教育类 App：字幕、倍速、截图等功能
- 外语学习 App：OCR 翻译、语音识别字幕
- 直播 App：弹幕、投屏功能
- 本地视频播放器：完整的播放控制
与其他播放器对比
| 功能 | OrangePlayer | GSYVideoPlayer | ExoPlayer | IJKPlayer |
|---|---|---|---|---|
| 弹幕 | ✅ 内置 | ❌ 需自己集成 | ❌ 需自己集成 | ❌ 需自己集成 |
| 字幕 | ✅ 内置 | ❌ 需自己集成 | ✅ 支持 | ✅ 支持 |
| OCR | ✅ 内置 | ❌ 无 | ❌ 无 | ❌ 无 |
| 语音识别 | ✅ 内置 | ❌ 无 | ❌ 无 | ❌ 无 |
| 投屏 | ✅ 内置 | ❌ 需自己集成 | ❌ 需自己集成 | ❌ 需自己集成 |
| UI 组件 | ✅ 完整 | ✅ 完整 | ❌ 需自己开发 | ❌ 需自己开发 |
| 多内核 | ✅ 4 种 | ✅ 4 种 | ❌ 单一 | ❌ 单一 |
后续计划
- 支持更多字幕格式（WebVTT、TTML）
- 添加视频编辑功能（裁剪、滤镜）
- 支持 VR 视频播放
- 优化 OCR 识别准确率
- 添加更多手势操作
- 支持多音轨切换
总结
OrangePlayer 是一个功能完整、易于使用的 Android 视频播放器库。如果你正在开发视频相关的应用，不妨试试 OrangePlayer，相信它能帮你节省大量开发时间。
GitHub 地址：https://github.com/706412584/orangeplayer
如果觉得有用，欢迎 Star ⭐️ 支持一下！
参考资料
作者：QQ 706412584
联系方式：欢迎交流讨论
开源协议：Apache License 2.0
