Facebook:
Instagram:
Magisto
这篇文章里的技术是基于VideoPlayerManager这个开源类库的。
类库包含所有的代码以及一个示例。我在这篇文章里会跳过一些东西,所以如果要搞清楚某个细节,那最好还是把源码导入IDE然后再看这篇文章吧。就算你不看源码,这篇文章还是可以让你理解我以何种方式解决了什么问题。
两个问题
要实现目标我们要解决两个问题:
- 我们要控制视频播放。在Android系统中我们可以使用MediaPlayer.class操作SurfaceView而且播放视频。但这有很多缺陷。我们不能再list中使用VideoView,因为VideoView继承SurfaceView,而SurfaceView不支持UI同步缓冲(UI synchronization buffer),这导致当滑动list时视频会跟进度。TextureView支持同步缓冲,但没有基于TextureView的VideoView,所以我们需要一个继承TextureView而可以操作Android
MediaPlayer的View。MediaPlayer中几乎所有的操作(prepare, start, stop等等)基本上都直接调用了操作硬件的底层方法。硬件操作起来比较棘手,尤其是当某个操作耗时16毫秒以上时会进入lagging list(龟速操作表),所以我们需要在后台线程中调用这些方法。 - 我们还要知道当用户滑动的时候哪个View处在活动状态。所以我们需要追踪滑动操作并随时操作可见度最高的View。
控制视频播放
现在要提供下述功能:
假设视频正在播放,用户滑动了列表,导致另一个View可见度更高,此时要终止现有的视频播放并播放新的View中的视频。
所以主要的功能就是:停止现有播放,并在停止完成后开始新的播放。
下面是一个样例:当你点击一个视频时,正在播放的视频停止,新的视频开始播放。
VideoPlayerView
首先我们要在TextureView的基础上实现VideoView。我们不能在滑动菜单中直接使用VideoView,因为当用户在视频播放时滑动列表会让视频加载出错。
我将任务分成了几个部分:
- 创建了一个ScalableTextureView类,这是TextureView的子类,而且它可以修改它处于的SurfaceTexture并提供几个类似于ImageView的scaleType选项。
public enum ScaleType { CENTER_CROP, TOP, BOTTOM, FILL }
- 创建VideoPlayerView类,这是一个ScalableTextureView的子类而且它涵盖了所有与MediaPlayer.class有关的方法。这个定制的View类封装了MediaPlayer.class并提供了非常类似于VideoView的API。它包含了所有直接调用MediaPlayer的方法:setDataSource, prepare, start, stop, pause, reset, release。
Video Player Manager和Messages Handler Thread
Video Playback Manager和负责调用MediaPlayer的方法的MessagesHandlerThread一起工作。我们需要在子线程中调用诸如prepare(),start()等方法因为它们直接操作底层硬件。有一次我在UI线程中调用的MediaPlayer.reset()方法,但player除了问题,导致主线程阻塞了4分钟。所以我们不用异步的MediaPlayer.prepareAsync,而是使用同步的MediaPlayer.prepare。我们把所有的操作放在子线程中以同步的方式进行。
以下是开启播放新视频的操作流程,需要分几步操作MediaPlayer:
- 停止现有播放。这可以通过调用MediaPlayer.stop()方法完成。
- 调用MediaPlayer.reset()方法重置MediaPlayer。这是因为在滑动列表中View可能会被复用,所以要尽可能的释放资源。
- 调用MediaPlayer.release()方法来释放MediaPlayer。
- 清除MediaPlayer实例。新的实例在新的视频播放要开始时创建。
- 为新的可见度最高的View创建MediaPlayer实例。
- 调用MediaPlayer.setDataSource(String url)来为新的MediaPlayer设置数据源。
- 调用MediaPlayer.prepare()。这里不需要用异步的MediaPlayer.prepareAsync()方法。
- 调用MediaPlayer.start()。
- 等待视频开始播放。
所有的操作都被封装成Message,并在子线程中运行。以下是一个Stop操作的Message对象。它调用了VideoPlayerView.stop()方法,而这个方法内部会调用MediaPlayer.stop()。我们定制Message的原因是我们可以靠这个设置状态(State),因为我们可以知道操作处在哪个阶段(比如Stop阶段)。这可以帮助我们管理哪个Message正在运行以及我们可以做些什么相对应的操作。
/**
* 这个PlayerMessage 调用内部的{@link VideoPlayerView}实例的{@link MediaPlayer#stop()}方法
*/
public class Stop extends PlayerMessage {
public Stop(VideoPlayerView videoView, VideoPlayerManagerCallback callback) {
super(videoView, callback);
}
@Override
protected void performAction(VideoPlayerView currentPlayer) {
currentPlayer.stop();
}
@Override
protected PlayerMessageState stateBefore() {
return PlayerMessageState.STOPPING;
}
@Override
protected PlayerMessageState stateAfter() {
return PlayerMessageState.STOPPED;
}
}
当我们需要开启新的播放时我们只需要调用VideoPlayerManager的方法就可以。这会将下列Message对象添加至MessagesHandlerThread。
// 暂停队列,并检查现在的状态
// 如果状态是”已开始”就停止现有视频
mPlayerHandler.addMessage(new Stop(mCurrentPlayer, this));
mPlayerHandler.addMessage(new Reset(mCurrentPlayer, this));
mPlayerHandler.addMessage(new Release(mCurrentPlayer, this));
mPlayerHandler.addMessage(new ClearPlayerInstance(mCurrentPlayer, this));
// 设置新的播放视频的View
mPlayerHandler.addMessage(new SetNewViewForPlayback(newVideoPlayerView, this));
// 开始新视频的播放
mPlayerHandler.addMessages(Arrays.asList(
new CreateNewPlayerInstance(videoPlayerView, this),
new SetAssetsDataSourceMessage(videoPlayerView, assetFileDescriptor, this), // I use local file for demo
new Prepare(videoPlayerView, this),
new Start(videoPlayerView, this)
));
// 队列运行继续
因为Message是同步运行的,所以我们可以随时暂停队列(queue)并运行新的Message。比如:
现在的电影正处在准备阶段(MediaPlayer.prepare()被调用了,MediaPlayer.start()正在队列中等待),而用户滑动了列表,从而需要在新的View中播放新的视频。这样我们只需要:
- 暂停现有的队列
- 移除所有等待的Message
- 添加”停止”,“重置”,“实例”,”清空实例”这四个Message到队列中,当准备操作一返回就执行。
- 添加”创建新的实例”,“设置Media Player(这会改变message所操作的Media Player)”,“设置数据源”,“准备”,“开始”到队列中。这些操作会在新的View中开始播放视频。
OK!现在我们有了播放视频的工具,而且它可以:停止现有视频,播放新视频。
下面是在gradle中添加依赖的代码,详见上面的github链接
dependencies {
compile ‘com.github.danylovolokh:video-player-manager:0.2.0‘
}
识别列表中可见度最高的View
第一个问题是控制视频播放,第二个问题就是追踪可见度最高的View并播放相应视频。
有一个已经实现的实体叫ListItemsVisibilityCalculator而它的实现类SingleListViewItemActiveCalculator可以解决我们的问题。
要使用这个类需要Adapter实现ListItem接口,这样才能计算每个Item的可见度。下面是ListItem的代码:
/**
* ListItem的接口
* 这个接口会被 {@link ListItemsVisibilityCalculator}调用
*
* @author danylo.volokh
*/
public interface ListItem {
/**
* 这个方法被调用时, 实现的方法应该返回0-100中的一个可见度百分比
* @param view 用于计算可见度的View
* 注意:可见度不一定要依靠一整个View来计算,也可以靠其内部的一个View来计算。
*
* @return 可见度百分比
*/
int getVisibilityPercents(View view);
/**
* 当新View的可见度超过了现在的View,新的View会被激活(active),这个方法就被调用
*/
void setActive(View newActiveView, int newActiveViewPosition);
/**
* 还有可能没有一个View处在激活状态,所有的view都要停止活动,这个方法就被调用 */
void deactivate(View currentView, int position);
}
ListItemsVisibilityCalculator可以追踪滑动的方向并在过程中计算每个Item的可见度。这个可见度可以依靠Item内的任何View进行计算,所以你可以按自己的方式实现getVisibilityPercents()方法。
当然在代码示例中有一个默认的实现。代码如下:
/**
* 这个方法计算现在View的可见度百分比。这个方法仅在View所在屏幕大小小于本来的大小时正常工作。
* @param currentView - 要被计算可见度的View * @return currentView的可见度百分比
*/
@Override
public int getVisibilityPercents(View currentView) {
int percents = 100;
currentView.getLocalVisibleRect(mCurrentViewRect);
int height = currentView.getHeight();
if(viewIsPartiallyHiddenTop()){
// View的上部分被掩盖
percents = (height - mCurrentViewRect.top) * 100 / height;
} else if(viewIsPartiallyHiddenBottom(height)){
percents = mCurrentViewRect.bottom * 100 / height;
}
return percents;
}
所以,每一个View都应该可以计算它自己的可见度百分比(Visibility Percents)。SingleListViewItemActiveCalculator会在滑动时获取每个View的可见度百分比,所以重写的方法要尽量轻量。
当可见度最高的View旁边的View的可见度超过了这个View,setActive()方法就会被调动,此时要进行视频播放的转换操作。
还有一个类ItemsPositionGetter,它充当ListItemsVisibilityCalculator和列表(ListView, RecyclerView)之间的适配器(Adapter)。这样ListItemsVisibilityCalculator不知道列表到底是什么列表,而只负责本职工作。但它还是需要从ItemsPositionGetter中获取一些信息。以下是ItemsPositionGetter的代码:
/**
* 这个类是提供给{@link ListItemsVisibilityCalculator}的API
* 这个类可以访问RecyclerView和ListView的数据 *
* 对于RecyclerView和ListView有两个不同的实现
* RecyclerView引入了LayoutManager
*
* Created by danylo.volokh on 9/20/2015.
*/
public interface ItemsPositionGetter {
View getChildAt(int position);
int indexOfChild(View view);
int getChildCount();
int getLastVisiblePosition();
int getFirstVisiblePosition();
}
设计这种结构是为了解耦。下面是演示视频:
使用这个类库只需要如下编写gradle
dependencies {
compile ‘com.github.danylovolokh:list-visibility-utils:0.2.0‘
}
将VideoPlayerManager和ListVisibilityUtils结合起来实现滑动列表的视频播放
现在我们有两个类库,可以解决一开始提出的两个问题。把这两个结合起来就可以实现我们想要的功能了。
下面是使用RecyclerView的Fragment的代码
- 初始化ListItemsVisibilityCalculator,并传入List作为参数。
/** * 只有可见度最高的View处于激活状态(正在播放) * 使用{@link SingleListViewItemActiveCalculator}计算View的可见度 */ private final ListItemsVisibilityCalculator mVideoVisibilityCalculator = new SingleListViewItemActiveCalculator(new DefaultSingleItemCalculatorCallback(), mList);
DefaultSingleItemCalculatorCallback类仅仅会在可见度最高的View变化时调用ListItem.setActive()方法,你也可以重写这个方法:
/** * 这个回调接口的方法会在发现新的可见度最高的View时,或是没有激活View时调用 * 后者可能会在用户快速滑动列表时发生,会调用{@link Callback#deactivateCurrentItem(ListItem, View, int)}方法 */ public interface Callback<T extends ListItem>{ void activateNewCurrentItem(T item, View view, int position); void deactivateCurrentItem(T item, View view, int position); }
- 初始化VideoPlayerManager
/** * 我们在这里使用{@link SingleVideoPlayerManager},同一时间只有一个视频可以被播放 */ private final VideoPlayerManager<MetaData> mVideoPlayerManager = new SingleVideoPlayerManager(new PlayerItemChangeListener() { @Override public void onPlayerItemChanged(MetaData metaData) { } });
- 设置RecyclerView的onScrollListener并将scroll事件传递给list visibility utils。
@Override public void onScrollStateChanged(RecyclerView view, int scrollState) { mScrollState = scrollState; if(scrollState == RecyclerView.SCROLL_STATE_IDLE && mList.isEmpty()){ mVideoVisibilityCalculator.onScrollStateIdle( mItemsPositionGetter, mLayoutManager.findFirstVisibleItemPosition(), mLayoutManager.findLastVisibleItemPosition()); } } @Override public void onScrolled(RecyclerView recyclerView, int dx, int dy) { if(!mList.isEmpty()){ mVideoVisibilityCalculator.onScroll( mItemsPositionGetter, mLayoutManager.findFirstVisibleItemPosition(), mLayoutManager.findLastVisibleItemPosition() - mLayoutManager.findFirstVisibleItemPosition() + 1, mScrollState); } }
- 实例化ItemsPositionGetter
ItemsPositionGetter mItemsPositionGetter = new RecyclerViewItemsPositionGetter(mLayoutManager, mRecyclerView);
- 在onResume()中调用方法,使屏幕亮起时启动对View的可见度的计算。
@Override public void onResume() { super.onResume(); if(!mList.isEmpty()){ // 要在List View Handler中调用这个方法以使list有内容 mRecyclerView.post(new Runnable() { @Override public void run() { mVideoVisibilityCalculator.onScrollStateIdle( mItemsPositionGetter, mLayoutManager.findFirstVisibleItemPosition(), mLayoutManager.findLastVisibleItemPosition()); } }); } }
完成了。现在我们就可以在滑动列表中播放视频了: