短视频列表播放器

简介

效果示例

最终效果

注意：目前列表播放器只对MP4的视频做了优化，对于HLS这样的是视频没有做优化处理。如果想播放HLS，不建议使用此列表播放器，而是建议使用多个播放器的实现方式。

Android 关键实现

1. 创建列表播放器，并设置相关参数

private AliListPlayer mVideoListPlayer;
……
//创建播放器（必须）
mVideoListPlayer = AliPlayerFactory.createAliListPlayer(mContext);
//开启硬解
mVideoListPlayer.enableHardwareDecoder(true);
//设置播放器参数
PlayerConfig config = mVideoListPlayer.getConfig();
//停止之后清空画面。防止画面残留（建议设置）
config.mClearFrameWhenStop = true;
mVideoListPlayer.setConfig(config);
//开启循环播放。短视频一般都是循环播放的
mVideoListPlayer.setLoop(true);
//开启自动播放。
mVideoListPlayer.setAutoPlay(true);
//设置预加载个数。此时会加载3个视频。当前播放的，和上下1个。
mVideoListPlayer.setPreloadCount(1);

2.添加多个播放数据源

列表播放器支持URL、点播Vid的数据源（STS方式）。

//使用点播服务的视频源
 mVideoListPlayer.addVid("点播视频vid", "视频唯一标识");
//或者直接使用URL
mVideoListPlayer.addUrl("视频URL", "视频唯一标识");

在列表播放器内部，视频是通过视频唯一标识区分的。如果添加的视频源的唯一标识一样的话，会导致播放错乱。所以：确保每次添加数据源的视频唯一标识都不一样

3. 开始播放某个视频

播放器提供了以下接口，实现基本的定位播放功能：moveTo，moveToPrev，moveToNext。

//直接跳转到某个视频播放
mVideoListPlayer.moveTo("视频唯一标识"，STS信息) //点播Vid源（STS方式）
mVideoListPlayer.moveTo("视频唯一标识") //URL源
//播放上一个视频
mVideoListPlayer.moveToPrev("视频唯一标识"，STS信息) //点播Vid源（STS方式）
mVideoListPlayer.moveToPrev("视频唯一标识") //URL源
//播放下一个视频
mVideoListPlayer.moveToNext("视频唯一标识"，STS信息) //点播Vid源（STS方式）
mVideoListPlayer.moveToNext("视频唯一标识") //URL源

4. TextureView与播放器的配合使用

多数列表播放使用了TextureView。正确的使用，可以避免退后台返回黑屏的问题，优化播放体验。

4.1TextureView的基本设置

TextureView mTextureView = null;
SurfaceTexture mSurfaceTexture = null;
Surface mSurface = null;
……
mTextureView = findViewById(R.id.textureView);
mTextureView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
            @Override
            public void onSurfaceTextureAvailable(SurfaceTexture surfaceTexture, int width, int height) {
              //缓存SurfaceTexture，在退后台再进时使用
                mSurfaceTexture = surfaceTexture;
                mSurface = new Surface(surface);
                //设置播放的surface
                    mVideoListPlayer.setSurface(mSurface);
              //重绘界面，立即刷新界面
                    mVideoListPlayer.redraw()；
            }
            @Override
            public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {
              //画面大小变化的时候重绘界面，立即刷新界面
                    mVideoListPlayer.redraw();
            }
            @Override
            public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
              //这里一定要return false。这样SurfaceTexture不会被系统销毁
                return false;
            }
            @Override
            public void onSurfaceTextureUpdated(SurfaceTexture surface) {
            }
        });

4.2 退后台重进界面

在onResume中处理退后台再进的情况

public void onResume() {
      ……
      if (mVideoListPlayer != null && mSurface != null) {
            mVideoListPlayer.setSurface(mSurface);
            mVideoListPlayer.redraw();
      }
      ……
}

5. 封面的隐藏时机

列表播放时一般都会有个封面，视频播起来之后，把封面隐藏，显示视频。

mVideoListPlayer.setOnRenderingStartListener(new IPlayer.OnRenderingStartListener() {
            @Override
            public void onRenderingStart() {
               //视频第一帧开始渲染。此时可以隐藏封面
            }
        });

6. 销毁播放器

退出界面，使用完播放器，需要释放播放器。否则会有内存泄漏。

//释放surface
mVideoListPlayer.setSurface(null);
//如果按照第4步使用了TextureView，那么还需要释放缓存的surface
if (mSurface != null) {
            mSurface.release();
}
if (mSurfaceTexture != null) {
            mSurfaceTexture.release();
}
//释放播放器
mVideoListPlayer.release();

播放器其他的接口可根据实际需求调用。请参考功能文档或者接口文档，不再赘述。

iOS关键实现

1. 创建列表播放器，并设置相关参数

//创建播放器（必须）
self.listPlayer = [[AliListPlayer alloc]init];
//开启硬解
self.listPlayer.enableHardwareDecoder = YES;
//循环播放
self.listPlayer.loop = YES;
//自动播放
self.listPlayer.autoPlay = YES;
//渲染模式
self.listPlayer.scalingMode = AVP_SCALINGMODE_SCALEASPECTFIT;
//代理设置
self.listPlayer.delegate = self;
//预加载的清晰度
self.listPlayer.stsPreloadDefinition = @"FD";
//显示view
self.listPlayer.playerView = self.simplePlayScrollView.playView;
//设置预加载个数。此时会加载3个视频。当前播放的，和上下1个。
mVideoListPlayer.setPreloadCount(1);

2.添加多个播放数据源

列表播放器支持URL、点播Vid的数据源（STS方式）。

//使用点播服务的视频源
[self.listPlayer addVidSource:点播视频vid uid:"视频唯一标识"];
//或者直接使用URL
[self.listPlayer addUrlSource:"视频URL" uid: "视频唯一标识"];

在列表播放器内部，视频是通过视频唯一标识区分的。如果添加的视频源的唯一标识一样的话，会导致播放错乱。所以：确保每次添加数据源的视频唯一标识都不一样

3. 开始播放某个视频

播放器提供了以下接口，实现基本的定位播放功能：moveTo，moveToPrev，moveToNext。

//直接跳转到某个视频播放
[self.listPlayer moveTo:"视频唯一标识"]; //URL源
[self.listPlayer moveTo:"视频唯一标识" accId:accId accKey:accKey token:token region:region]; //点播Vid源（STS方式）
//播放上一个视频
[self.listPlayer moveToPrev:"视频唯一标识"]; //URL源
[self.listPlayer moveToPrev:"视频唯一标识" accId:accId accKey:accKey token:token region:region]; //点播Vid源（STS方式）
//播放下一个视频
[self.listPlayer moveToNext:"视频唯一标识"]; //URL源
[self.listPlayer moveToNext:"视频唯一标识" accId:accId accKey:accKey token:token region:region]; //点播Vid源（STS方式）

4. 滑动控制操作

下面列举一些滑动播放控制操作

4.1点击暂停和播放

在屏幕上点击暂停和播放

- (void)tap {
    if ([self.delegate respondsToSelector:@selector(AVPSimplePlayScrollViewTapGestureAction:)]) {
        [self.delegate AVPSimplePlayScrollViewTapGestureAction:self];
    }
}
- (void)AVPSimplePlayScrollViewTapGestureAction:(AVPSimplePlayScrollView *)simplePlayScrollView {
    if (self.playerStatus == AVPStatusStarted) {
        //如果是播放，则暂停
        [self.listPlayer pause];
    }else if (self.playerStatus == AVPStatusPaused) {
        //如果是暂停，则播放
        [self.listPlayer start];
    }
}

4.2滑动控制

如果列表滑动速度较快，也就是滑动的位置超过一个，则直接调用moveTo接口列表滑动后的回调中去判定：

- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
    CGFloat indexFloat = scrollView.contentOffset.y/self.frame.size.height;
    NSInteger index = (NSInteger)indexFloat;
    .......
      //往下滑动一格
       if (index - self.currentIndex == 1) {
            if ([self.delegate respondsToSelector:@selector(AVPSimplePlayScrollView:motoNextAtIndex:)]) {
                [self.delegate AVPSimplePlayScrollView:self motoNextAtIndex:index];
            }
        }
        //往上滑动一格
        else if (self.currentIndex - index == 1){
            if ([self.delegate respondsToSelector:@selector(AVPSimplePlayScrollView:motoPreAtIndex:)]) {
                [self.delegate AVPSimplePlayScrollView:self motoPreAtIndex:index];
            }
        }
        //滑动多格
        else {
            if ([self.delegate respondsToSelector:@selector(AVPSimplePlayScrollView:scrollViewDidEndDeceleratingAtIndex:)]) {
                [self.delegate AVPSimplePlayScrollView:self scrollViewDidEndDeceleratingAtIndex:index];
            }
        }
}
/**
 滚动事件,移动位置超过一个
 @param simplePlayScrollView simplePlayScrollView
 @param index 移动到第几个
 */
- (void)AVPSimplePlayScrollView:(AVPSimplePlayScrollView *)simplePlayScrollView scrollViewDidEndDeceleratingAtIndex:(NSInteger)index {
    //找到第几个   
    AVPDemoResponseVideoListModel *model = [self findModelFromIndex:index];
    //MoveTo到当前
    [self moveToCurrentModel];
}

5. 封面的隐藏时机

列表播放时一般都会有个封面，视频播起来之后，把封面隐藏，显示视频。

-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventPrepareDone: {
        }
            break;
        case AVPEventFirstRenderedStart: {
            //隐藏封面图
            [self.simplePlayScrollView showPlayView];
        }
            break;
        default:
            break;
    }
}

6. 销毁播放器

退出界面，使用完播放器，需要释放播放器。否则会有内存泄漏。

[self.listPlayer stop];
[self.listPlayer destroy];
self.listPlayer = nil;

播放器其他的接口可根据实际需求调用。请参考功能文档或者接口文档，不再赘述。