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.OrangevideoView
    android: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，提供完整的弹幕功能：

// 获取弹幕控制器
DanmakuController 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(new OnStateChangeListener() {
    @Override
    public void onPlayStateChanged(int playState) {
        // 播放状态变化
    }
    @Override
    public void onPlayerStateChanged(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，相信它能帮你节省大量开发时间。

OrangePlayer：功能完整的 Android 视频播放器开源库