进阶功能

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

• 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. 添加或移除多个播放源。

   列表播放支持两种播放源：Vid播放（包括VidSts及VidPlayAuth）和UrlSource播放。Url为视频的播放地址。示例如下

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

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

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

   说明

   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);
   //vid的时候使用此接口，需要传递PlayAuthInfo,在此之前要针对每个视频获取PlayAuth信息。
   aliyunVodPlayer.moveTo(String uid, PlayAuthInfo info);

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

   • 调用moveTo播放某个视频源后，调用moveToPrev，moveToNext接口以moveTo的视频源为锚点进行播放上一个，下一个视频。示例如下：

     说明

     在基于同一个view的情况下，调用moveto或者moveToNext等切换视频源操作时，会出现闪烁黑屏的情况。此时建议在listPlayer初始化时，配置PlayerConfig的mClearFrameWhenStop字段为false，并调用setConfig使其生效。

     展开查看代码

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

   • 根据vid申请PlayAuth信息，申请成功后再进行MoveTo或MoveToNext等。

     说明

     只有VidPlayAuth播放才需要根据vid申请PlayAuth信息。

     展开查看代码

     requestAuth(source.getVideoId(), new OnRequestAuthResultListener() {
         @Override
         public void onResult(VidAuth vidAuth) {
             mVideoListPlayer.moveToNext(createVidAuth(vidAuth));
         }
     });
     
     private PlayAuthInfo createVidAuth(VidAuth vidAuth) {
         if (vidAuth == null) {
             return new PlayAuthInfo();
         }
         PlayAuthInfo playAuthInfo = new PlayAuthInfo();
         playAuthInfo.setPlayAuth(vidAuth.getPlayAuth());
         return playAuthInfo;
     }

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 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;
                      }
                  }
              }
          }
      });