VideoListPlayer
Introduction: Play video in ListView or RecyclerView
Tags:
VideoListPlayer 实现了在列表控件(ListView, RecyclerView)中加载并播放视频,并支持滑动时自动播放/暂停的功能
利用该项目,可以轻松实现类似 Instagram 的视频播放功能
注意:最低支持 API 14 以上
效果预览
Changelogs
v.14
- 支持更多类型的 scaleType,详见 Android-ScalableVideoView
- 加入
getCurrentPosition()
和getDuration()
接口
v1.3
- fix 在多类型列表元素中出现视频无法正常播放的 bug
Demo 更新
- 增加在 ListView 中播放视频的示例
- ListView 和 RecyclerView 中支持多类型 view type 展示
v1.2
- fix NPE bugs
v1.1
自动播放/停止功能性能优化
视频播放加入声音开关控制,默认播放视频关闭声音,点击视频开启声音
fix 在 4.1.1 以下无法播放视频的 bug
基本用法
添加 gradle 依赖
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
compile 'com.github.waynell:VideoListPlayer:1.4'
}
在 xml 布局中加入以下代码
<com.waynell.videolist.widget.TextureVideoView
android:id="@+id/video_view"
android:layout_width="match_parent"
android:layout_height="300dp" />
然后设置视频路径地址,最后调用 start()方法开始播放视频
videoView.setVideoPath(mVideoPath);
videoView.start();
视频播放是异步的,可以通过设置 MediaPlayerCallback 回调监听播放事件
view.setMediaPlayerCallback(this);
监听事件如下
void onPrepared(MediaPlayer mp);
void onCompletion(MediaPlayer mp);
void onBufferingUpdate(MediaPlayer mp, int percent);
void onVideoSizeChanged(MediaPlayer mp, int width, int height);
boolean onInfo(MediaPlayer mp, int what, int extra);
boolean onError(MediaPlayer mp, int what, int extra);
滑动时自动播放/停止的功能
首先,你必须实现 ListItem 接口来获取 item 被激活或取消激活的事件回调
public interface ListItem {
// 当前 item 被激活
void setActive(View newActiveView, int newActiveViewPosition);
// 当前 item 被取消
void deactivate(View currentView, int position);
}
其次,实现 ItemsProvider 接口返回当前列表总数和列表中某一位置的 ListItem 实例
public interface ItemsProvider {
ListItem getListItem(int position);
int listItemSize();
}
最后添加以下代码实现可见比的计算,以 RecyclerView 为例
ItemsProvider itemProvider;
ListItemsVisibilityCalculator calculator = new SingleListViewItemActiveCalculator(itemProvider,
new RecyclerViewItemPositionGetter(layoutManager, mRecyclerView););
mRecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
@Override
public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
mScrollState = newState;
if(newState == RecyclerView.SCROLL_STATE_IDLE && !mListItems.isEmpty()){
mCalculator.onScrollStateIdle();
}
}
@Override
public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
mCalculator.onScrolled(mScrollState);
}
});
网络视频的本地缓存
请参考 demo 工程的实现
实现原理
请参见我的博客 视频在滑动列表中的异步缓存和播放
Thanks
VideoPlayerManager 滑动自动播放/暂停的功能基于项目优化而来