进阶功能

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

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

创建列表播放时，监听器为非必须配置，但如果不设置，将无法收到播放器的播放失败、播放进度等事件通知，因此，建议您设置。其中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) {
        //截图事件
    }
});

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

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

列表播放支持两种播放源：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);

播放器支持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) {
  
      }
  });

• 调用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;
  }

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