Subtitle For Android 是一个Android平台视频播放多字幕支持库，几乎支持所有的Android版本，可以在需要外挂字幕中的项目集成。支持的字幕格式有：.SRT、.SCC、.ASS、.STL、.TTML格式的字幕文件。集成方式简单，可几行代码就可以使你的播放器支持外挂做字幕的支持。
项目地址：https://github.com/averyzhong/SubtitleForAndroid
Android外挂字幕组件库（Subtitle For Android)
概述
Subtitle For Android 是一个Android平台视频播放多字幕支持库，几乎支持所有的Android版本，可以在需要外挂字幕中的项目集成。支持的字幕格式有：.SRT、.SCC、.ASS、.STL、.TTML格式的字幕文件。集成方式简单，可几行代码就可以使你的播放器支持外挂做字幕的支持
下载
implementation 'com.avery:subtitle:x.x.x' // 最新版本号请看上面"Download"气泡后面的数字
如果Gradle同步出现如下错误： Manifest merger failed : uses-sdk:minSdkVersion xx cannot be smaller than version xx declared in library [com.avery:subtitle:x.x.x]
请在
AndroidManifest.xml中加入<uses-sdk tools:overrideLibrary="com.avery.subtitle"/>
怎样使用？
- 在播放器布局文件中添加
SimpleSubtitleView
<com.avery.subtitle.widget.SimpleSubtitleView
android:id="@+id/subtitle_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:gravity="center"
android:text="字幕将在这里显示"
android:textColor="#ffffff"
android:textSize="26sp"
android:textStyle="bold"/>
- 绑定
MediaPlayer到SimpleSubtitleView
private SimpleSubtitleView mSubtitleView;
....省略无关代码.....
mVideoView.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
@Override
public void onPrepared(final MediaPlayer mp) {
// 绑定MediaPlayer
mSubtitleView.bindToMediaPlayer(mp);
// 设置字幕
mSubtitleView.setSubtitlePath(SUBTITLE_URL);
}
});
mVideoView.setVideoURI(Uri.parse(VIDEO_URL));
....省略无关代码.....
@Override
protected void onDestroy() {
mSubtitleView.destroy(); // 记得销毁
super.onDestroy();
}
SimpleSubtitleView还有其他与Activity生命周期相似的方法：start()，pause()，resume()，stop()，reset()可以根据具体集成情况在适当的地方进行调用。
字幕样式设置
SimpleSubtitleView集成自TextView，所以TextView的所有样式设置都适用于SimpleSubtitleView，如设置字幕颜色、字幕大小、字幕对其方式等。
注意！！！
- 最好在
MediaPlayer初始化完成后才能调用SimpleSubtitleView.setSubtitlePath()方法，最好的时机是在MediaPlayer的onPrepared回调方法里调用SimpleSubtitleView.setSubtitlePath()。- 最好在
MediaPlayer销毁之前先销毁SimpleSubtitleView，即调用SimpleSubtitleView.destroy()，最好的时机是在调用MediaPlayer.release()方法前先调用调用SimpleSubtitleView.destroy()。
自定义字幕显示控件
如果不想使用提供的SimpleSubtitleView控件，你还可以轻松自定义你自己的显示控件，只需通过 DefaultSubtitleEngine来辅助就能办到
....
private SubtitleEngine mSubtitleEngine = new DefaultSubtitleEngine();
mSubtitleEngine.setOnSubtitlePreparedListener(new OnSubtitlePreparedListener() {
@Override
public void onSubtitlePrepared(@Nullable final List<Subtitle> subtitles) {
// 启动字幕刷新任务
mSubtitleEngine.start();
}
});
mSubtitleEngine.setOnSubtitleChangeListener(new OnSubtitleChangeListener() {
@Override
public void onSubtitleChanged(@Nullable final Subtitle subtitle) {
// 拿到Subtitle对象来刷新你自定义过的字幕显示控件，注意subtitle可能为空
// 当subtitle为空时，你应该清除自定义控件已显示的字幕显示
.......
}
});
....
自定义的最后一步就是通过DefaultSubtitleEngine的生命周期相应方法：start()，pause()，resume()，stop()，reset()处理好控件的生命周期，以免导致bug。
快照
License
ll source code is licensed under Apache License 2.0. If you create your own app (free or commercial) that uses some or all of the code from this codebase, you MUST attribute it to the original author, no exceptions. You can do so by displaying an "About" or "Licenses" screen in your app that links back to this GitHub page AND includes the following notice:
Copyright 2019 - Avery Zhong
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.