SubtitleForAndroid

Introduction: Subtitle For Android is a multi-subtitle support library for Android platform video playback. It supports almost all Android versions, and supports subtitle files in. SRT,. SCC,. ASS,. STL,. TTML formats.
More: Author   ReportBugs   
Tags:

CSDN blog: https://blog.csdn.net/han_han_1/article/details/86747472

Download

概述

Subtitle For Android 是一个 Android 平台视频播放多字幕支持库,几乎支持所有的 Android 版本,可以在需要外挂字幕中的项目集成。支持的字幕格式有:.SRT、.SCC、.ASS、.STL、.TTML 格式的字幕文件。集成方式简单,可几行代码就可以使你的播放器支持外挂做字幕的支持

下载

implementation 'com.avery:subtitle:1.0.6' // 最新版本号请看上面"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"/>

怎样使用?

  1. 在播放器布局文件中添加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"/>
  1. 绑定MediaPlayerSimpleSubtitleView
  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,如设置字幕颜色、字幕大小、字幕对其方式等。

注意!!!

  1. 最好在MediaPlayer初始化完成后才能调用SimpleSubtitleView.setSubtitlePath()方法,最好的时机是在 MediaPlayer 的onPrepared回调方法里调用SimpleSubtitleView.setSubtitlePath()
  2. 最好在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.
Support Me
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea