SDK 常见问题

本文为您介绍点播 Android SDK、iOS SDK 和 Web SDK 的常见问题。

Android SDK

播放有声无画时，如何解决 ？

请检查 TextureView/SurfaceView 的 Surface 是否成功设置 TTVideoEngine 实例。

Android SDK 处理音频焦点吗 ？

点播 SDK 内部不处理音频焦点，接入方需监听AudioManager.OnAudioFocusChangeListener 来处理音频焦点的获取和释放。详情请见官方文档音频焦点。

如何调节显示 view 大小 ？

提供 DisplayMode 接口，详情请见调节显示view大小。

如何根据日志判断是否降级系统播放器？

您可通过检索如下关键字进行判断：

• ownplayer：点播播放器，如果检索到 ownplayer，那么用的是火山引擎视频点播的播放器。
• sysplayer：系统播放器，如果检索到 sysplayer，那么说明降级到了系统播放器。

如何 seek 到视频最后一秒 ？

在播放过程中用户拖动进度条将视频快进到视频总时长 3s 以内的位置，发现播放器会直接回调播放完成。
当出现上述情况且业务确实有需求这样做时，可以通过如下方法配置：

// 关闭循环播放
ttVideoEngine.setLooping(false);

// 在播放开始前设置
ttVideoEngine.setIntOption(TTVideoEngine.PLAYER_OPTION_KEEP_FORMAT_THREAD_ALIVE, 1);
ttVideoEngine.setIntOption(TTVideoEngine.PLAYER_OPTION_ENABLE_SEEK_END, 1);

iOS SDK

开启预加载后没有效果，如何解决 ？

• 请确认预加载是否生效，详情请见 明确播放时是否命中预加载。

• 是否降级到系统播放器，需要输出日志进行分析。您可通过检索如下关键字进行判断：

  • ownplayer：点播播放器，如果检索到 ownplayer，那么用的是火山引擎视频点播的播放器。
  • sysplayer：系统播放器，如果检索到 sysplayer，那么说明降级到了系统播放器。

如何 seek 到视频最后一秒 ？

在播放过程中用户拖动进度条将视频快进到视频总时长 3s 以内的位置，发现播放器会直接回调播放完成。
当出现上述情况且业务确实有需求这样做时，可以通过如下方法配置：

// 关闭循环播放
self.engine.looping = NO;
// 在播放开始前设置
[self.engine setOptionForKey:VEKKeyPlayerSeekEndEnabled_BOOL value:@YES];
[self.engine setOptionForKey:VEKKEYPlayerKeepFormatAlive_BOOL value:@YES];

Web SDK

Web 端播放器是否区分高级版和基础版 ?

不区分，Web 播放器是免费使用的。

iOS 端嵌入 Web 页面，为什么切换全屏后降级到系统播放器 ?

iOS 端不支持全屏，切换全屏会默认降级到系统播放器。

解决方案： 把全屏按钮禁用，启用网页全屏，用 cssFullscreen 插件代替 fullscreen 插件，详情请见内置插件。代码示例如下。

playerConfig = {
  ignores: ['fullscreen'],
  cssFullscreen: true,
  ...
}

iOS 端嵌入 Web 页面，无法播放 mp4 的 DRM 加密视频？

• 如果是移动 Web端，建议使用 HLS 加密播放。
• iOS 系统不支持使用 MSE(Media Source Extensions)，也就是不支持播放加密dash 和加密 mp4。

Web SDK 如何上报日志？

需要接入AppLog，详情请见播放质量上报。