Android播放器常见问题

License相关问题

如果需要同时使用短视频SDK和播放器SDK，AndroidManifest.xml中的License key应该如何配置？

如果既申请了短视频SDK的License，又申请了播放器SDK的License，则只需要在AndroidManifest.xml中配置最后一个申请的License即可。

报错License is invalid!!!

如何判断License是否正确？

1. 确认您申请的License授权与实际需要使用的SDK是否匹配，例如：仅申请了短视频SDK的授权，未申请播放器SDK的授权等。

2. 排查您的License是否正确集成。集成方式，请参见快速集成。

3. 使用签名获取工具，查看您的包名和签名是否正确。工具下载链接：工具下载。

如何判断专业版License是否正确？

在SDK版本7.0.0及以上，如果您已正确集成专业版license，则专业版功能均可使用。您可以通过以下任意一种方法验证专业版license的可用性。

1. 若您已验证任意一项专业版功能可用，则表明专业版许可证已正确集成且未过期。

2. 或者在您启动应用程序并创建播放器后，调用prepare方法，或在调用任意专业版功能后，控制台将打印出如下格式的日志：Premium LICENSE INFO: SignedTime: ******, ExpiredTime: ******, Version: ***则说明您当前的专业版许可证集成正确，但需注意，若过期时间 ExpiredTime时间戳接近当前时间，可能会存在过期风险，建议您提前进行续期。

   此外，请注意，该日志在应用运行过程中仅会打印一次。

如何获取当前播放进度

//修改回调间隔
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();
        }
    }
});

创建播放器时发生crash

播放器运行过程中发生crash

播放视频时画面有黑边

播放视频时有声音无画面

播放已获取读取权限的本地视频时报错Invalid argument

当播放已获取读取权限的本地视频时报错Invalid argument，建议检查一下文件名称和文件绝对路径，避免路径中出现中文和空格混杂的情况。

播放已获取读取权限的本地视频时报错Permission denied

因Android系统从Android 10（Android Q）版本开始引入了分区储存特性，需要在AndroidManifest.xml的application标签下新增android:requestLegacyExternalStorage="true"后，才能正常使用Android设备的存储权限。

播放视频偶尔出现Redirect to a url 报错

出现此错误的原因可能是播放的视频源被劫持。建议您启用播放器的HTTPDNS功能以进行处理。详情请参见Android端设置HTTPDNS。

全屏播放时刘海屏闪现一个黑色通知栏

可以通过设置为沉浸式的状态栏解决。

播放MOV视频失败

Android播放器SDK支持MOV格式的视频。如果播放MOV视频失败，可考虑是否由源视频的moov（音视频数据索引）在mdat（音视频数据）之后造成，可通过转码源视频将moov移到mdat之后解决。更多信息，请参见步骤二：排查流。

初始化或播放视频时报错找不到播放器SDK的.so动态库

使用列表播放器AliListPlayer播放HLS（m3u8）视频报错

使用Android播放器SDK是否支持播放Android工程中assets和raw文件夹下的视频？

不支持。需要您将视频拷贝到手机存储中，然后使用绝对路径来播放视频。

播放HLS视频流并配置本地缓存后，播放失败报错403

问题现象：当以VidAuth播放方式，播放HLS（M3U8）协议的视频流时，开启本地缓存后，出现播放失败并报错403。

问题原因：由于开启本地缓存后，如果在没有充分缓存的状态下退出播放，当下一次起播时，未缓存的部分因仍然使用上一次过期的Vid鉴权信息请求，从而导致鉴权失败报错403。

处理方法：针对5.5.4.0及以后版本的播放器SDK，如果视频播放URL带有鉴权参数且播放协议为HLS，可以通过设置PlayerConfig.mEnableStrictAuthMode字段，进行不同鉴权模式的选择（默认值为false）。

• 非严格鉴权（false）：鉴权也缓存，若上一次只缓存了部分媒体，下次播放至非缓存部分时，播放器会用缓存的鉴权发起请求，如果URL鉴权设置的有效期很短，会导致播放异常。

• 严格鉴权（true）：鉴权不缓存，每次起播都进行鉴权，无网络下会导致起播失败。

Android播放器SDK是否支持边下载边播放？

不支持。Android播放器SDK支持在播放的过程中通过开启本地缓存功能缓存下载视频文件，下次再播放时，直接播放缓存好的视频文件；目前不支持将放在文件目录下的本地缓存视频文件单独拿出来进行播放。

Android播放器SDK是否支持获取播放视频的缓冲速度？

支持。Android播放器SDK支持获取缓冲速度、实时渲染帧率、音视频码率、网络下行码率等，详细说明请参见获取播放信息。

HDR视频播放异常

Android播放器SDK暂不支持带旋转角度的HDR视频，因此播放此类视频时会有异常。

seek相关问题

seek后，进度条异常回跳

问题原因：播放器默认使用不精准seek。seek后播放器会从seek点附近的关键帧开始播放。

解决方法：切换为精准seek模式。

如何切换精准seek和非精准seek模式

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

使用精准seek模式后，进度条也会异常回跳

问题原因：由于精准seek耗时比非精准seek耗时更长，当seek点距离关键帧间隔过大，超过精准seek的最大间隔时，播放器SDK会自动切换成非精准seek，导致进度条回跳。

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

缓存相关问题

使用边播边缓存（CacheConfig）时缓存失败

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

本地缓存，缓存目录是否可以指定到内部存储目录

可以指定。您可以将Android设备的外部存储目录换成内部存储目录，请确保内部存储目录有访问权限即可正常缓存。

视频缓存时报错encrypt check fail

缓存即下载，如果设置了安全下载，请确认加密校验文件与App信息是否匹配（即需要将离线下载中生成的加密校验文件下载并保存到播放器SDK中，详细内容请参见视频下载），否则会导致缓存或下载失败。

获取音视频源数据

//切换到软解码。
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;
    }
});

获取视频宽高

播放器中如何获取到视频里每一帧的像素？

Android播放器：可通过监听OnRenderFrameCallback回调获取。

player.setOnRenderFrameCallback(frameInfo -> {
    if (frameInfo.frameType == FrameInfo.FrameType_video) {
        //视频数据
    } else {
        //音频数据
    }
    return false;
});

自动码率切换逻辑

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

自定义重试逻辑

在网络重试场景下，播放器SDK默认重试次数为2次，网络超时时间为15秒，当重试失败后会触发Error回调。

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做相应的逻辑处理。
        }
    }
});

播放RTS流时，报错协议不支持

缩略图使用

在播放器SDK中使用缩略图前，请确保已为视频配置缩略图，即视频已生成雪碧截图（在视频点播控制台创建类型为雪碧图的截图模板，通过工作流将视频用该雪碧图的截图模板处理后，生成雪碧图数据），详细内容请参见视频截图。播放器SDK中使用缩略图的示例代码如下：

mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        //1.获取缩略图URL。
        List<Thumbnail> thumbnailList = mAliPlayer.getMediaInfo().getThumbnailList();
        //2.创建缩略图帮助类。
        ThumbnailHelper mThumbnailHelper = new ThumbnailHelper(thumbnailList.get(0).mURL);
        //3.设置监听。
        mThumbnailHelper.setOnPrepareListener(new ThumbnailHelper.OnPrepareListener() {
            @Override
            public void onPrepareSuccess() {
                //5.缩略图加载成功后，可以请求获取指定位置的缩略图。
                mThumbnailHelper.requestBitmapAtPosition(1000);

            }
            @Override
            public void onPrepareFail() {}
        });

        mThumbnailHelper.setOnThumbnailGetListener(new ThumbnailHelper.OnThumbnailGetListener() {
            @Override
            public void onThumbnailGetSuccess(long positionMs, ThumbnailBitmapInfo thumbnailBitmapInfo) {
                //6.获取指定位置缩略图的Bitmap。
                Bitmap thumbnailBitmap = thumbnailBitmapInfo.getThumbnailBitmap();
            }
            @Override
            public void onThumbnailGetFail(long positionMs, String errorMsg) {}
        });

        //4.加载缩略图。
        mThumbnailHelper.prepare();
    }
});

请注意：如果播放方式为URL的时候，AliPlayer 可能并不能获取到ThumbnailList，建议用户直接指定缩略图的URL。

mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        //1.创建缩略图帮助类。
        ThumbnailHelper mThumbnailHelper = new ThumbnailHelper(URL);
        //2.设置监听。
        mThumbnailHelper.setOnPrepareListener(new ThumbnailHelper.OnPrepareListener() {
            @Override
            public void onPrepareSuccess() {
                //4.缩略图加载成功后，可以请求获取指定位置的缩略图。
                mThumbnailHelper.requestBitmapAtPosition(1000);

            }
            @Override
            public void onPrepareFail() {}
        });

        mThumbnailHelper.setOnThumbnailGetListener(new ThumbnailHelper.OnThumbnailGetListener() {
            @Override
            public void onThumbnailGetSuccess(long positionMs, ThumbnailBitmapInfo thumbnailBitmapInfo) {
                //5.获取指定位置缩略图的Bitmap。
                Bitmap thumbnailBitmap = thumbnailBitmapInfo.getThumbnailBitmap();
            }
            @Override
            public void onThumbnailGetFail(long positionMs, String errorMsg) {}
        });

        //3.加载缩略图。
        mThumbnailHelper.prepare();
    }
});

清晰度相关问题

视频转码了多个清晰度，播放器SDK默认会播放视频的哪个清晰度？

默认清晰度播放顺序：FD、LD、SD、HD、2K、4K、OD，清晰度的定义请参见清晰度：Definition。播放器SDK会从左到右依次查找，找到哪个清晰度就播放哪个清晰度。

如何指定视频播放默认清晰度？

//以VidSts播放方式为例
VidSts vidSts = new VidSts();
//设置vid、AccessKeyId、AccessKeySecret、token等参数的代码此处省略，可参见基础功能文档中的创建播放器设置。
/*
    参数1：期望播放的清晰度，取值为FD、LD、SD、HD、2K、4K、OD。
    参数2：是否强制使用期望播放的清晰度播放。false：不强制使用期望的清晰度播放，按播放器SDK的默认清晰度播放顺序查找播放；true：强制使用设置的期望清晰度播放，如果找不到期望播放的清晰度就不播放。
*/
vidSts.setQuality("",false);

如果同一个清晰度有多个码流，播放器SDK会播放哪个码流？

当同一个清晰度有多个码流时，播放器SDK会播放最新的码流。

如何设置同一个视频，在播放时无水印，下载后带水印？

将视频转码多个清晰度，播放时播放无水印的清晰度，下载时下载有水印的清晰度。

如何获取问题日志

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

1. 获取问题日志。

   建议将日志级别设置为AF_LOG_LEVEL_TRACE后再获取问题日志。具体方法请参见获取SDK日志。

2. 将生成的日志提供给阿里云技术支持。