Android播放器常见问题

问题现象：使用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）格式的视频，但是需要开启本地缓存，开启本地缓存的方法如下：

AliPlayerGlobalSettings.enableLocalCache()

切换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);

当您向阿里云获取技术支持时，请将您的问题日志一并提交，以便更高效的为您解决问题。问题日志的获取方法如下：

1. 打开日志开关。
   • 方法一：调用如下代码后，会在控制台输出播放器SDK的日志。可以通过adb命令抓取log日志。

     Logger.getInstance(context).enableConsoleLog(true);
     Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_TRACE);

   • 方式二：通过LogCallback监听播放器SDK的输出日志。

     Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_TRACE);
     Logger.getInstance(mContext).setLogCallback(new Logger.OnLogCallback() {
             @Override
             public void onLog(Logger.LogLevel logLevel, String s) {
                  //日志
             }
     });

2. 获取问题日志。
   1. 复现问题。
   2. 将生成的日志提供给阿里云技术支持。