問題現象：使用5.4.7.1及之后版本的播放器時，出現如下報錯。

解決方法：

• 請先確認您是否已申請License授權并在已配置License，5.4.7.1及之后版本播放器SDK需要配置License之后才能正常使用，具體操作，請參見License說明。

• 請確認您配置的License是否正確，判斷方法請參見如何判斷License是否正確。

播放器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);