进阶功能

AliListPlayer存在以下限制，推荐使用多个AliPlayer的方式来实现短视频列表播放。，详细内容请参见通过列表播放提升沉浸式短视频播放体验。

• AliListPlayer不支持PlayAuth方式播放。

• AliListPlayer不支持多实例，要保持全局单实例，使用多个AliListPlayer会出现视频源混乱的问题。

• 5.4.5.0以前版本的Android端播放器SDK中，AliListPlayer不支持m3u8格式的视频；5.4.5.0及以后版本的Android端播放器SDK才支持m3u8格式的视频（需要打开本地缓存功能）。

1. 创建播放器。

   通过AliPlayerFactory类创建AliListPlayer播放器。示例如下：

   AliListPlayer aliyunListPlayer;
   .....
   aliyunListPlayer = AliPlayerFactory.createAliListPlayer(getApplicationContext());
   aliyunListPlayer.setTraceId("traceId"); //traceId为设备或用户的唯一标识符，通常为imei或idfa

2. 可选：设置监听器。

   创建列表播放时，监听器为非必须配置，但如果不设置，将无法收到播放器的播放失败、播放进度等事件通知，因此，建议您设置。其中OnPreparedListener、OnErrorListener、OnCompletionListener、OnLoadingStatusListener、OnInfoListener较为重要，建议您设置。

   展开查看代码

   aliyunListPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
    //播放完成事件
    }
   });
   aliyunListPlayer.setOnErrorListener(new IPlayer.OnErrorListener() {
    @Override
    public void onError(ErrorInfo errorInfo) {
    //出错事件
    }
   });
   aliyunListPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
    //准备成功事件
    }
   });
   aliyunListPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
    @Override
    public void onVideoSizeChanged(int width, int height) {
    //视频分辨率变化回调
    }
   });
   aliyunListPlayer.setOnRenderingStartListener(new IPlayer.OnRenderingStartListener() {
    @Override
    public void onRenderingStart() {
    //首帧渲染显示事件
    }
   });
   aliyunListPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(int type, long extra) {
    //其他信息的事件，type包括了：循环播放开始，缓冲位置，当前播放位置，自动播放开始等
    }
   });
   aliyunListPlayer.setOnLoadingStatusListener(new IPlayer.OnLoadingStatusListener() {
    @Override
    public void onLoadingBegin() {
    //缓冲开始。
    }
    @Override
    public void onLoadingProgress(int percent, float kbps) {
    //缓冲进度
    }
    @Override
    public void onLoadingEnd() {
    //缓冲结束
    }
   });
   aliyunListPlayer.setOnSeekCompleteListener(new IPlayer.OnSeekCompleteListener() {
    @Override
    public void onSeekComplete() {
    //拖动结束
    }
   });
   aliyunListPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
    @Override
    public void onSubtitleShow(long id, String data) {
    //显示字幕
    }
    @Override
    public void onSubtitleHide(long id) {
    //隐藏字幕
    }
   });
   aliyunListPlayer.setOnTrackChangedListener(new IPlayer.OnTrackChangedListener() {
    @Override
    public void onChangedSuccess(TrackInfo trackInfo) {
    //切换音视频流或者清晰度成功
    }
    @Override
    public void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo) {
    //切换音视频流或者清晰度失败
    }
   });
   aliyunListPlayer.setOnStateChangedListener(new IPlayer.OnStateChangedListener() {
    @Override
    public void onStateChanged(int newState) {
    //播放器状态改变事件
    }
   });
   aliyunListPlayer.setOnSnapShotListener(new IPlayer.OnSnapShotListener() {
    @Override
    public void onSnapShot(Bitmap bm, int with, int height) {
    //截图事件
    }
   });

3. 设置预加载个数。

   合理设置预加载个数，能够有效的提高起播的速度。示例如下：

   //设置预加载个数。总共加载的个数为： 1 + count*2。
   aliyunListPlayer.setPreloadCount(int count);

4. 添加或移除多个播放源。

   列表播放支持两种播放源：VidSts播放和UrlSource播放。Url为视频的播放地址。示例如下：

   • Url：播放地址可以是第三方点播地址或阿里云点播服务中的播放地址。阿里云播放地址可以调用获取音视频播放地址接口获取。建议您集成点播服务端SDK来获取音视频播放地址，免去自签名的麻烦。调用接口获取音视频播放地址的示例请参见开发者门户。

   • Vid：音视频ID，可以在音视频上传完成后通过控制台（路径：媒资库 > 音/视频。）或服务端接口（SearchMedia - 搜索媒体信息）获取。

   //添加VidSts播放源
   aliyunListPlayer.addVid(String videoId, String uid);
   //添加UrlSource播放源
   aliyunListPlayer.addUrl(String url, String uid);
   //移除某个源
   aliyunListPlayer.removeSource(String uid);

   说明

   • 不支持VidAuth播放方式。

   • uid是视频的唯一标志。用于区分视频是否一样。如果uid一样，则认为视频是一样的。如果播放出现串流的情况，请注意查看是不是在不同的界面设置了同一个uid。uid没有格式限制，可以是任意的字符串。

5. 设置显示View。

   播放器支持SurfaceView和TextureView，任选其中一种即可。

   • 设置SurfaceView，示例如下：

     展开查看代码

     SurfaceView surfaceView = findViewById(R.id.surface_view);
     surfaceView.getHolder().addCallback(new SurfaceHolder.Callback() {
      @Override
      public void surfaceCreated(SurfaceHolder holder) {
      aliyunListPlayer.setSurface(holder.getSurface());
      }
     
      @Override
      public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
      aliyunListPlayer.surfaceChanged();
      }
     
      @Override
      public void surfaceDestroyed(SurfaceHolder holder) {
      aliyunListPlayer.setSurface(null);
      }
     });

   • 设置TextureView，示例如下：

     展开查看代码

     TextureView textureView = findViewById(R.id.texture_view);
     textureView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
      @Override
      public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) {
      aliyunListPlayer.setSurface(new Surface(surface));
      }
     
      @Override
      public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {
      aliyunListPlayer.surfaceChanged();
      }
     
      @Override
      public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
      aliyunListPlayer.setSurface(null);
      return false;
      }
     
      @Override
      public void onSurfaceTextureUpdated(SurfaceTexture surface) {
     
      }
     });

6. 播放视频源。

   添加了一个或多个播放源之后并设置自动播放，调用moveTo便可以自动播放某个视频源。示例如下：

   展开查看代码

   //开启自动播放
   aliyunListPlayer.setAutoPlay(true);
   
   //url时使用此接口
   aliyunVodPlayer.moveTo(String uid);
   //vid的时候使用此接口，需要传递stsInfo即STS临时凭证和临时AK对，需要提前获取，获取方式请参见创建RAM角色并进行STS临时授权。
   aliyunVodPlayer.moveTo(String uid, StsInfo info);

7. 播放上一个、下一个视频。

   播放器提供了moveToPrev，moveToNext接口用于播放上一个，下一个视频。示例如下：

   展开查看代码

   //开启自动播放
   aliyunListPlayer.setAutoPlay(true);
   
   //移动到下一个视频。 注意：只能用于url的源。这个方法不适用于vid的播放。
   aliyunVodPlayer.moveToNext();
   //移动到上一个视频。注意：只能用于url的源。这个方法不适用于vid的播放。
   aliyunVodPlayer.moveToPrev();
   //移动到下一个视频。注意：只能用于vid的播放。
   aliyunVodPlayer.moveToNext(StsInfo info);
   // 移动到上一个视频。注意：只能用于vid的播放。
   aliyunVodPlayer.moveToPrev(StsInfo info);

8. 可选：使用预渲染实例提升视频切换的顺畅度。

   说明

   Android端播放器SDK 5.5.2.0及以上版本才支持本功能，并且需要开启本地缓存，开启方法请参见本地缓存。

   Android端播放器SDK从5.5.2.0版本开始提供getPreRenderPlayer和moveToNextWithPrerendered接口，用于提升滑动切换到下一个视频播放时的顺畅度，根据您的SDK集成场景不同，其使用方法有所差异，具体如下：

   全新集成5.5.2.0及以后版本

   使用PreRenderPlayer来实现。示例代码如下：

   展开查看代码

   //preRenderPlayer只能在moveToNext时使用，并且需要开启本地缓存。
   IPlayer preRenderPlayer = listPlayer.getPreRenderPlayer();
   if (preRenderPlayer != null) {
    //设置surface
    preRenderPlayer.setSurface(surface);
    preRenderPlayer.start();
    listPlayer.setSurface(null);
    //STS播放方式，将moveToNext接口替换成moveToNextWithPrerendered
    listPlayer.moveToNextWithPrerendered(createStsInfo(source));
   }

   从低版本升级至5.5.2.0及以后版本

   您需要修改低版本SDK的代码实现，具体如下：

   1. 修改渲染View。

      低版本的Android端播放器SDK全局使用一个渲染View，在每次切换播放源时，先从布局中remove前一个View，再添加下一个View到当前界面上。从5.5.2.0版本开始，支持使用多个渲染View，在RecyclerView.ViewHolder的布局中添加多个View，在切换播放源时，可以预加载下一个播放源，以提升切换的顺畅度。您需要删除低版本的渲染View的代码，并添加新版本添加多个渲染View的代码，示例代码如下：

      展开查看代码

      /*
      删除如下代码
       如下几行代码为低版本添加渲染View的代码。会将渲染View添加到FrameLayout中，然后在切换播放源时，会将mPlayerViewContainer移除、添加。
      */
      private void initPlayer() {
       //...
       mPlayerViewContainer = View.inflate(getContext(), R.layout.layout_player_view, null);
       FrameLayout frameLayout = mPlayerViewContainer.findViewById(R.id.framelayout);
       FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT,
       FrameLayout.LayoutParams.MATCH_PARENT);
       View renderView = createRenderView(Common.RENDER_VIEW_NAME);
       frameLayout.addView(renderView, 0, params);
       //...
      }
      
      /*
      添加或修改如下代码以添加多个渲染View
       修改RecyclerView的item布局，以及对应的ViewHolder
      */
      
      public final class MyHolder extends RecyclerView.ViewHolder {
       //...
       private Surface mSurface;
       MyHolder(@NonNull View itemView) {
       super(itemView);
       //...
       TextureView mTextureView = itemView.findViewById(R.id.texture_view);
       mTextureView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
       @Override
       public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) {
       mSurface = new Surface(surface);
       }
      
       @Override
       public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {}
      
       @Override
       public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
       mSurface = null;
       return false;
       }
      
       @Override
       public void onSurfaceTextureUpdated(SurfaceTexture surface) {}
       });
       }
       //...
      
       //对外呈现获取Surface的接口
       public Surface getSurface() {
       return mSurface;
       }
      }

      修改RecyclerView中的item布局的示例代码如下：

      展开查看XML

      <?xml version="1.0" encoding="utf-8"?>
      <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:app="http://schemas.android.com/apk/res-auto"
       android:id="@+id/root_view"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       android:background="@android:color/black">
      
       <TextureView
       android:id="@+id/texture_view"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />
      
      <!-- 删除封面图片，如果效果不好，可以保留封面图片的相关逻辑。 -->
      <!-- <FrameLayout-->
      <!-- android:id="@+id/player_view"-->
      <!-- android:layout_width="match_parent"-->
      <!-- android:layout_height="match_parent"-->
      <!-- android:clickable="false"-->
      <!-- android:clipChildren="false"-->
      <!-- android:focusable="false">-->
      
      <!-- <ImageView-->
      <!-- android:id="@+id/img_thumb"-->
      <!-- android:layout_width="match_parent"-->
      <!-- android:layout_height="match_parent"-->
      <!-- android:layout_gravity="center"-->
      <!-- android:adjustViewBounds="true"-->
      <!-- android:clickable="false"-->
      <!-- android:focusable="false"-->
      <!-- android:scaleType="fitXY" />-->
      
      <!-- </FrameLayout>-->
      
      </FrameLayout>

   2. 修改切换播放源的逻辑。

      从Android端播放器SDK 5.5.2.0版本开始，在调用moveToNext时，会增加对preRenderPlayer的调用，因此需要单独对渲染View（Surface）进行设置。其中，moveToNext、moveToPre、moveTo的逻辑有所差异。示例代码如下：

      展开查看代码

      /*
       说明：mQuickPlayer是AlivcQuickPlayer类的实例对象，封装了ListPlayer的接口。
      */
      private void startPlay(int position, boolean isInitComplete) {
       //...
       //根据position获取ViewHolder实例对象
       LittleVideoListAdapter.MyHolder holder = (LittleVideoListAdapter.MyHolder) recycler.findViewHolderForLayoutPosition(position);
      
       //...
      
       //1.moveToPre时，先设置Surface，再调用moveToPre
       if (holder != null) {
       mQuickPlayer.setSurface(holder.getSurface());
       }
       mQuickPlayer.moveToPrev(video, position, mVideoSourceType);
      
       //2.moveTo时，先设置Surface，再调用moveTo
       if (holder != null) {
       mQuickPlayer.setSurface(holder.getSurface());
       }
       //mQuickPlayer.startPlay()内部最终会调用moveTo()接口
       mQuickPlayer.startPlay(video, position, mVideoSourceType);
      
       //3.moveToPre时，需要增加一个参数，将Surface传递进去
       mQuickPlayer.moveToNext(video, position, mVideoSourceType, holder.getSurface());
      
       //...
      }

      修改AlivcQuickPlayer类的示例代码如下：

      展开查看代码

      //修改moveToPre方法
      public void moveToPrev(AlivcVideoInfo.Video source, final int position, VideoSourceType videoSourceType) {
       //...
       //增加如下代码
       mVideoListPlayer.clearScreen();
       if (videoSourceType == VideoSourceType.TYPE_STS) {
       mVideoListPlayer.moveToPrev(createStsInfo(source));
       } else {
       mVideoListPlayer.moveToPrev();
       }
      }
      
      //增加moveToNext的重载方法
      public void moveToNext(AlivcVideoInfo.Video source, int position, VideoSourceType videoSourceType, Surface surface) {
       //...
       //moveToNext时，可以获取preRenderPlayer对象，并使用该Player播放
       IPlayer preRenderPlayer = mVideoListPlayer.getPreRenderPlayer();
       if (preRenderPlayer != null) {
       preRenderPlayer.clearScreen();
       preRenderPlayer.setSurface(surface);
       preRenderPlayer.start();
       mVideoListPlayer.setSurface(null);
       } else {
       mVideoListPlayer.clearScreen();
       mVideoListPlayer.setSurface(surface);
       }
      
       //STS播放方式
       if (videoSourceType == VideoSourceType.TYPE_STS) {
       //当preRenderPlayer不为null时候，调用moveToNextWithPrerendered进行播放
       if (preRenderPlayer != null) {
       mVideoListPlayer.moveToNextWithPrerendered(createStsInfo(source));
       } else {
       mVideoListPlayer.moveToNext(createStsInfo(source));
       }
       } else {
       //URL播放方式
       if (preRenderPlayer != null) {
       mVideoListPlayer.moveToNextWithPrerendered();
       } else {
       mVideoListPlayer.moveToNext();
       }
       }
      }

   3. 可选：修改滑动播放的逻辑。

      支持通过修改滑动播放的逻辑，实现在滑动切换视频时，当滑动到下一个视频的一半画面出现时，开始播放下一个视频。通过修改PagerLayoutManager类中的代码实现，即当RecyclerView的item出现在屏幕一半时，切换播放源，示例代码如下：

      展开查看代码

      recyclerView.addOnScrollListener(new OnScrollListener() {
       private int measuredHeight;
       private int mScrollDiff;
       @Override
       public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
       super.onScrollStateChanged(recyclerView, newState);
      
       if (newState == RecyclerView.SCROLL_STATE_DRAGGING) {
       measuredHeight = recyclerView.getMeasuredHeight();
       mScrollDiff = 0;
       }
      
       if (newState == RecyclerView.SCROLL_STATE_IDLE) {
       mScrollDiff = 0;
       View viewIdle = mPagerSnapHelper.findSnapView(PagerLayoutManager.this);
       if (viewIdle == null) {
       return;
       }
       int positionIdle = getPosition(viewIdle);
       if (mOnViewPagerListener != null && getChildCount() == 1 && mOldPosition != positionIdle) {
       mOnViewPagerListener.onPageSelected(positionIdle, positionIdle == getItemCount() - 1, viewIdle);
       mOldPosition = positionIdle;
       }
       }
       }
      
       @Override
       public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
       super.onScrolled(recyclerView, dx, dy);
       if (measuredHeight > 0 && mOnViewPagerListener != null) {
       mScrollDiff += dy;
       changeVideoAfterScrolled(recyclerView, dy >= 0);
       }
       }
      
       private void changeVideoAfterScrolled(RecyclerView recyclerView, boolean isNext) {
       if (Math.abs(mScrollDiff) >= measuredHeight / 2) {
       View snapView = mPagerSnapHelper.findSnapView(PagerLayoutManager.this);
       if (snapView != null) {
       int position = getPosition(snapView);
       if (mOldPosition != position) {
       if (isNext) {
       mOnViewPagerListener.onPageHideHalf(position - 1);
       } else {
       mOnViewPagerListener.onPageHideHalf(position + 1);
       }
       mOnViewPagerListener.onPageSelected(position, false, snapView);
       mOldPosition = position;
       recyclerView.smoothScrollToPosition(position);
       mScrollDiff = 0;
       }
       }
       }
       }
      });