ApsaraVideo VOD：Android播放器常見問題

播放器SDK預設每500 ms回調一次播放進度。您可以修改回調間隔時間，通過將間隔時間縮短，以更高頻率地擷取當前播放進度，範例程式碼如下：

//修改回調間隔
PlayerConfig config = mAliyunLivePlayer.getConfig();
config.mPositionTimerIntervalMs = 100;//回調間隔時間，單位：ms。
mAliyunLivePlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            //當前播放進度
            long currentPosition = infoBean.getExtraValue();
        }
    }
});

可通過以下步驟排查問題產生原因：

1. 檢查CPU架構是否為x86架構。

   播放器SDK目前僅支援arm64-v8a架構和armeabi-v7a架構，不支援x86架構。

2. 檢查專案中是否混合式整合了播放器SDK相關的.so和Maven依賴。

   例如：在build.gradle中通過Maven依賴整合了播放器SDK，又在專案的Module中libs相關目錄下也整合了播放器相關的動態庫。

   解決方案推薦：如果存在混用的情況，建議刪除動態庫，使用Maven方式依賴。如果必須要整合動態庫，則請排查播放器SDK相關的.so檔案是否統一（需要保證是同一個版本下的.so檔案）。播放器SDK的整合操作及動態庫擷取，請參見快速整合。播放器相關的動態庫如下圖所示：

3. 如果整合的是part包，請確認AlivcFFmpeg的版本依賴是否正確。

   AlivcFFmpeg的版本依賴資訊請參見AlivcFFmpeg版本依賴。

可通過以下步驟排查問題產生原因：

1. 確認crash是否產生在播放器SDK。

   查看是否有帶AliyunPlayer首碼的崩潰堆棧，如果有，則說明問題產生在播放器SDK。

2. 升級至最新版播放器SDK並驗證，確認問題是否已經修複。

3. 如果問題依然存在，請準備相關的崩潰檔案（包含全部線程）、崩潰日誌、崩潰情境等資訊，如何擷取問題日誌。

可通過以下步驟排查問題產生原因：

1. 檢查視頻源本身是否存在黑邊問題。

2. 可通過如下介面調節播放器的縮放模式。

   /*
   SCALE_ASPECT_FILL：按比例填充，畫面會有裁剪。
   SCALE_ASPECT_FIT：按比例縮放，會有黑邊。
   SCALE_TO_FILL：不按比例填充，畫面會變形。
   */
   mAliPlayer.setScaleMode();

3. 若縮放模式依然無法滿足需求，則可以在應用程式層調節SurfaceView/TextureView的大小。

可通過以下步驟排查問題產生原因：

1. 使用其他播放器播放，檢查視頻是否是純音頻。

2. 確認渲染視頻的View設定是否有異常，例如沒有給播放器設定顯示View，或者顯示View被移出播放介面。設定顯示View的方法請參見建立播放器的步驟4。

可通過以下步驟排查問題產生原因：

1. 檢查CPU架構是否滿足要求。

   播放器SDK目前僅支援arm64-v8a架構和armeabi-v7a架構的動態庫。

2. 檢查播放器SDK的版本是否過低。

   如果播放器SDK版本是5.4.6.0-full或者更低的版本，建議升級到5.4.6.0-full-15467853或者更高的版本。播放器SDK的最新及歷史版本請參見Android播放器SDK。

V5.4.5.0及之前版本的播放器SDK不支援使用列表播放器AliListPlayer播放HLS（m3u8）格式的視頻。從V5.4.5.0之後版本開始支援播放HLS（m3u8）格式的視頻，但是需要開啟本機快取，開啟本機快取的方法請參見本機快取。

切換seek模式的範例程式碼如下：

//非精準seek。
mAliPlayer.seekTo(1000);
mAliPlayer.seekTo(1000, IPlayer.SeekMode.Inaccurate);
//精準seek。
mAliPlayer.seekTo(1000,IPlayer.SeekMode.Accurate);

解決方案：可以通過介面設定精準seek的最大間隔，將精準seek的最大間隔調大，降低精準seek被切換成非精準seek的頻率，以提高seek精準度，但當seek的點距離主要畫面格間隔太長時，耗時也將更長，請根據業務特點合理設定精準seek的最大間隔。範例程式碼如下：

//單位：ms。
mAliPlayer.setMaxAccurateSeekDelta(1000);

可以在onInfo回調中，擷取緩衝失敗的原因。onInfo回調的範例程式碼如下：

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CacheSuccess){
            //邊播邊緩衝成功
        }else if(infoBean.getCode() == InfoCode.CacheError){
            //邊播邊緩衝失敗
            String error = infoBean.getExtraMsg();
        }
    }
});

常見的失敗原因如下：

• CacheConfig中設定的大小和時間長度與視頻不匹配導致緩衝失敗。

• 在播放過程中，stop或者seek到buffer外導致緩衝失敗。

解碼方式需要切換為軟解碼，並且播放不加密的視頻，才會返迴音視頻的未經處理資料。範例程式碼如下：

//切換到軟解碼。
mAliPlayer.enableHardwareDecoder(false);
IPlayer.RenderFrameCallbackConfig renderFrameCallbackConfig = new IPlayer.RenderFrameCallbackConfig();
//是否只返回底層視頻資料地址，預設為true。
renderFrameCallbackConfig.mVideoDataAddr = false;
//是否只返回底層音頻資料地址，預設為false。
renderFrameCallbackConfig.mAudioDataAddr = false;
mAliPlayer.setRenderFrameCallbackConfig(renderFrameCallbackConfig);

mAliPlayer.setOnRenderFrameCallback(new IPlayer.OnRenderFrameCallback() {
    @Override
    public boolean onRenderFrame(FrameInfo frameInfo) {
        return false;
    }
});

您可以通過以下三種方式擷取視頻寬高：

• 阿里雲播放器AliPlayer執行個體執行完prepare方法後，至少確保處於準備完成狀態後，通過如下方法擷取：

  mAliyunPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
      @Override
      public void onPrepared() {
            mAliyunPlayer.getVideoWidth();
                mAliyunPlayer.getVideoHeight();
      }
  });

• 監聽視頻大小變化回調方法：

  mAliyunPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
      @Override
      public void onVideoSizeChanged(int width, int height) {
  
      }
  });

• 通過track方式擷取：

  mAliyunPlayer.setOnTrackReadyListener(new IPlayer.OnTrackReadyListener() {
      @Override
      public void onTrackReady(MediaInfo mediaInfo) {
      List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
          for (TrackInfo trackInfo : trackInfos) {
          if(trackInfo.getType() == TrackInfo.Type.TYPE_VIDEO){
          trackInfo.getVideoWidth();
          trackInfo.getVideoHeight();
          }
      }
      }
  });

當開啟自動碼率切換，即調用了mAliPlayer.selectTrack(TrackInfo.AUTO_SELECT_INDEX)介面後，播放器SDK內部會統計當前網速，當10秒內網速達到下一個碼率時，就會切換到下一個碼率。若10秒內網速未達到下一個碼率，則不切換。

• 從高碼率切換到低碼率的情境，當10秒內網速達到下一個碼率時，會將已緩衝的高碼率內容播放完成後才切換。

• 從低碼率切換到高碼率的情境，當10秒內網速達到下一個碼率時，會直接切換。

自動碼率切換，首先需要在控制台轉碼為自適應流，然後指定播放器擷取自適應流。以VidAuth播放方式為例，樣本如下：

VidAuth vidAuth = new VidAuth();
List<Definition> list = new ArrayList<>();
list.add(Definition.DEFINITION_AUTO);
vidAuth.setDefinition(list);

可以自訂重試邏輯，當觸發重試時，將重試事件通知到外部，由外部決定具體的重試邏輯。範例程式碼如下：

PlayerConfig config = mAliPlayer.getConfig();
//1.設定重試次數，此處以設定為0為例。
config.mNetworkRetryCount = 0;
mAliPlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        //2.監聽retry事件。
       if(infoBean.getCode() == InfoCode.NetworkRetry){
            //TODO做相應的邏輯處理。
        }
    }
});

可通過以下步驟排查報錯原因：

1. 檢查3個SDK（AliyunPlayer、AlivcArtc、Rts）是否全部都已整合。

   使用阿里雲播放器播放RTS流，需要整合3個SDK：AliyunPlayer、AlivcArtc、Rts。整合操作可參見阿里雲播放器SDK整合Native RTS SDK實現說明。

2. 檢查Native RTS SDK（Rts）和阿里雲播放器SDK（AliyunPlayer）的版本是否配套。

   Native RTS SDK和阿里雲播放器SDK有版本配套關係，需要整合對應的版本，版本配套關係請參見SDK下載。

3. 檢查AliyunPlayer和AlivcArtc的版本是否一致，需保持一致。

4. 整合Native RTS SDK後，需要手動載入。

   load RtsSDK：System.loadLibrary("RtsSDK");

5. 可選：經上述步驟排查驗證後，若仍然報錯。請在AndroidManifest.xml檔案中或在app/build.gradle檔案的android{}閉包中，配置android:extractNativeLibs="true"，範例程式碼如下：

   packagingOptions {
       jniLibs {
       useLegacyPackaging true
       }
   }

範例程式碼如下：

//以VidSts播放方式為例
VidSts vidSts = new VidSts();
//設定vid、AccessKeyId、AccessKeySecret、token等參數的代碼此處省略，可參見基礎功能文檔中的建立播放器設定。
/*
    參數1：期望播放的清晰度，取值為FD、LD、SD、HD、2K、4K、OD。
    參數2：是否強制使用期望播放的清晰度播放。false：不強制使用期望的清晰度播放，按播放器SDK的預設清晰度播放順序尋找播放；true：強制使用設定的期望清晰度播放，如果找不到期望播放的清晰度就不播放。
*/
vidSts.setQuality("",false);