ApsaraVideo VOD：進階功能

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