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