通過(guò)AliPlayerFactory類創(chuàng)建AliListPlayer播放器。示例如下：

AliListPlayer aliyunListPlayer;
.....
aliyunListPlayer = AliPlayerFactory.createAliListPlayer(getApplicationContext());
aliyunListPlayer.setTraceId("traceId");  //traceId為設(shè)備或用戶的唯一標(biāo)識(shí)符，通常為imei或idfa

創(chuàng)建列表播放時(shí)，監(jiān)聽(tīng)器為非必須配置，但如果不設(shè)置，將無(wú)法收到播放器的播放失敗、播放進(jìn)度等事件通知，因此，建議您設(shè)置。其中OnPreparedListener、OnErrorListener、OnCompletionListener、OnLoadingStatusListener、OnInfoListener較為重要，建議您設(shè)置。

aliyunListPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
        //播放完成事件
    }
});
aliyunListPlayer.setOnErrorListener(new IPlayer.OnErrorListener() {
    @Override
    public void onError(ErrorInfo errorInfo) {
        //出錯(cuò)事件
    }
});
aliyunListPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        //準(zhǔn)備成功事件
    }
});
aliyunListPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
    @Override
    public void onVideoSizeChanged(int width, int height) {
        //視頻分辨率變化回調(diào)
    }
});
aliyunListPlayer.setOnRenderingStartListener(new IPlayer.OnRenderingStartListener() {
    @Override
    public void onRenderingStart() {
        //首幀渲染顯示事件
    }
});
aliyunListPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(int type, long extra) {
        //其他信息的事件，type包括了：循環(huán)播放開(kāi)始，緩沖位置，當(dāng)前播放位置，自動(dòng)播放開(kāi)始等
    }
});
aliyunListPlayer.setOnLoadingStatusListener(new IPlayer.OnLoadingStatusListener() {
    @Override
    public void onLoadingBegin() {
        //緩沖開(kāi)始。
    }
    @Override
    public void onLoadingProgress(int percent, float kbps) {
        //緩沖進(jìn)度
    }
    @Override
    public void onLoadingEnd() {
        //緩沖結(jié)束
    }
});
aliyunListPlayer.setOnSeekCompleteListener(new IPlayer.OnSeekCompleteListener() {
    @Override
    public void onSeekComplete() {
        //拖動(dòng)結(jié)束
    }
});
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) {
        //播放器狀態(tài)改變事件
    }
});
aliyunListPlayer.setOnSnapShotListener(new IPlayer.OnSnapShotListener() {
    @Override
    public void onSnapShot(Bitmap bm, int with, int height) {
        //截圖事件
    }
});

合理設(shè)置預(yù)加載個(gè)數(shù)，能夠有效的提高起播的速度。示例如下：

//設(shè)置預(yù)加載個(gè)數(shù)。總共加載的個(gè)數(shù)為： 1 + count*2。
aliyunListPlayer.setPreloadCount(int count);

列表播放支持兩種播放源：Vid播放（包括VidSts及VidPlayAuth）和UrlSource播放。Url為視頻的播放地址。示例如下

• Url：播放地址可以是第三方點(diǎn)播地址或阿里云點(diǎn)播服務(wù)中的播放地址。阿里云播放地址可以調(diào)用獲取音視頻播放地址接口獲取。建議您集成點(diǎn)播服務(wù)端SDK來(lái)獲取音視頻播放地址，免去自簽名的麻煩。調(diào)用接口獲取音視頻播放地址的示例請(qǐng)參見(jiàn)開(kāi)發(fā)者門戶。

• Vid：音視頻ID，可以在音視頻上傳完成后通過(guò)控制臺(tái)（路徑：媒資庫(kù) > 音/視頻。）或服務(wù)端接口（搜索媒體信息）獲取。

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

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

• 設(shè)置SurfaceView，示例如下：

  展開(kāi)查看代碼

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

• 設(shè)置TextureView，示例如下：

  展開(kāi)查看代碼

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

• 調(diào)用moveTo播放某個(gè)視頻源后，調(diào)用moveToPrev，moveToNext接口以moveTo的視頻源為錨點(diǎn)進(jìn)行播放上一個(gè)，下一個(gè)視頻。示例如下：

  說(shuō)明

  在基于同一個(gè)view的情況下，調(diào)用moveto或者moveToNext等切換視頻源操作時(shí)，會(huì)出現(xiàn)閃爍黑屏的情況。此時(shí)建議在listPlayer初始化時(shí)，配置PlayerConfig的mClearFrameWhenStop字段為false，并調(diào)用setConfig使其生效。

  展開(kāi)查看代碼

  //開(kāi)啟自動(dòng)播放
  aliyunListPlayer.setAutoPlay(true);
  
  //移動(dòng)到下一個(gè)視頻。 注意：只能用于url的源。這個(gè)方法不適用于vid的播放。
  aliyunVodPlayer.moveToNext();
  //移動(dòng)到上一個(gè)視頻。注意：只能用于url的源。這個(gè)方法不適用于vid的播放。
  aliyunVodPlayer.moveToPrev();
  //移動(dòng)到下一個(gè)視頻。注意：只能用于vid的播放。
  aliyunVodPlayer.moveToNext(StsInfo info);
  // 移動(dòng)到上一個(gè)視頻。注意：只能用于vid的播放。
  aliyunVodPlayer.moveToPrev(StsInfo info);
  //移動(dòng)到下一個(gè)視頻。注意：只能用于vid且使用PlayAuth的播放。
  aliyunVodPlayer.moveToNext(PlayAuthInfo info);
  // 移動(dòng)到上一個(gè)視頻。注意：只能用于vid且使用PlayAuth的播放。
  aliyunVodPlayer.moveToPrev(PlayAuthInfo info);

• 根據(jù)vid申請(qǐng)PlayAuth信息，申請(qǐng)成功后再進(jìn)行MoveTo或MoveToNext等。

  說(shuō)明

  只有VidPlayAuth播放才需要根據(jù)vid申請(qǐng)PlayAuth信息。

  展開(kāi)查看代碼

  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版本開(kāi)始提供getPreRenderPlayer和moveToNextWithPrerendered接口，用于提升滑動(dòng)切換到下一個(gè)視頻播放時(shí)的順暢度，根據(jù)您的SDK集成場(chǎng)景不同，其使用方法有所差異，具體如下：

全新集成5.5.2.0及以后版本

使用PreRenderPlayer來(lái)實(shí)現(xiàn)。示例代碼如下：

//preRenderPlayer只能在moveToNext時(shí)使用，并且需要開(kāi)啟本地緩存。
IPlayer preRenderPlayer = listPlayer.getPreRenderPlayer();
if (preRenderPlayer != null) {
    //設(shè)置surface
    preRenderPlayer.setSurface(surface);
  preRenderPlayer.start();
  listPlayer.setSurface(null);
  //STS播放方式，將moveToNext接口替換成moveToNextWithPrerendered
  listPlayer.moveToNextWithPrerendered(createStsInfo(source));
}

從低版本升級(jí)至5.5.2.0及以后版本

您需要修改低版本SDK的代碼實(shí)現(xiàn)，具體如下：

1. 修改渲染View。

   低版本的Android播放器SDK全局使用一個(gè)渲染View，在每次切換播放源時(shí)，先從布局中remove前一個(gè)View，再添加下一個(gè)View到當(dāng)前界面上。從5.5.2.0版本開(kāi)始，支持使用多個(gè)渲染View，在RecyclerView.ViewHolder的布局中添加多個(gè)View，在切換播放源時(shí)，可以預(yù)加載下一個(gè)播放源，以提升切換的順暢度。您需要?jiǎng)h除低版本的渲染View的代碼，并添加新版本添加多個(gè)渲染View的代碼，示例代碼如下：

   展開(kāi)查看代碼

   /*
   刪除如下代碼
       如下幾行代碼為低版本添加渲染View的代碼。會(huì)將渲染View添加到FrameLayout中，然后在切換播放源時(shí)，會(huì)將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);
       //...
   }
   
   /*
   添加或修改如下代碼以添加多個(gè)渲染View
       修改RecyclerView的item布局，以及對(duì)應(yīng)的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) {}
           });
       }
       //...
   
       //對(duì)外呈現(xiàn)獲取Surface的接口
       public Surface getSurface() {
           return mSurface;
       }
   }

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

   展開(kāi)查看代碼

   <?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" />
   
   <!-- 刪除封面圖片，如果效果不好，可以保留封面圖片的相關(guān)邏輯。 -->
   <!--    <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版本開(kāi)始，在調(diào)用moveToNext時(shí)，會(huì)增加對(duì)preRenderPlayer的調(diào)用，因此需要單獨(dú)對(duì)渲染View（Surface）進(jìn)行設(shè)置。其中，moveToNext、moveToPre、moveTo的邏輯有所差異。示例代碼如下：

   展開(kāi)查看代碼

   /*
       說(shuō)明：mQuickPlayer是AlivcQuickPlayer類的實(shí)例對(duì)象，封裝了ListPlayer的接口。
   */
   private void startPlay(int position, boolean isInitComplete) {
       //...
       //根據(jù)position獲取ViewHolder實(shí)例對(duì)象
       LittleVideoListAdapter.MyHolder holder = (LittleVideoListAdapter.MyHolder) recycler.findViewHolderForLayoutPosition(position);
   
       //...
   
       //1.moveToPre時(shí)，先設(shè)置Surface，再調(diào)用moveToPre
       if (holder != null) {
           mQuickPlayer.setSurface(holder.getSurface());
       }
       mQuickPlayer.moveToPrev(video, position, mVideoSourceType);
   
       //2.moveTo時(shí)，先設(shè)置Surface，再調(diào)用moveTo
       if (holder != null) {
           mQuickPlayer.setSurface(holder.getSurface());
       }
       //mQuickPlayer.startPlay()內(nèi)部最終會(huì)調(diào)用moveTo()接口
       mQuickPlayer.startPlay(video, position, mVideoSourceType);
   
       //3.moveToPre時(shí)，需要增加一個(gè)參數(shù)，將Surface傳遞進(jìn)去
       mQuickPlayer.moveToNext(video, position, mVideoSourceType, holder.getSurface());
   
       //...
   }

   修改AlivcQuickPlayer類的示例代碼如下：

   展開(kāi)查看代碼

   //修改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時(shí)，可以獲取preRenderPlayer對(duì)象，并使用該P(yáng)layer播放
       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) {
           //當(dāng)preRenderPlayer不為null時(shí)候，調(diào)用moveToNextWithPrerendered進(jìn)行播放
           if (preRenderPlayer != null) {
               mVideoListPlayer.moveToNextWithPrerendered(createStsInfo(source));
           } else {
               mVideoListPlayer.moveToNext(createStsInfo(source));
           }
       } else {
           //URL播放方式
           if (preRenderPlayer != null) {
               mVideoListPlayer.moveToNextWithPrerendered();
           } else {
               mVideoListPlayer.moveToNext();
           }
       }
   }

3. 可選：修改滑動(dòng)播放的邏輯。

   支持通過(guò)修改滑動(dòng)播放的邏輯，實(shí)現(xiàn)在滑動(dòng)切換視頻時(shí)，當(dāng)滑動(dòng)到下一個(gè)視頻的一半畫面出現(xiàn)時(shí)，開(kāi)始播放下一個(gè)視頻。通過(guò)修改PagerLayoutManager類中的代碼實(shí)現(xiàn)，即當(dāng)RecyclerView的item出現(xiàn)在屏幕一半時(shí)，切換播放源，示例代碼如下：

   展開(kāi)查看代碼

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