白板常见问题

音视频文件要求

1. 文件名称长度不超过 200 个字符，含后缀名。
2. 推荐文件格式：
   • 视频：采用 H.264 编码的 mp4 文件。
   • 音频：mp3 格式文件。

插入音视频文件常见问题

1. 现象：音视频加载失败，播放器无法交互。

   处理：文件格式不支持或 URL 无效。SDK 不对传入的 URL 进行校验，你需要自行确保 URL 的有效性。视频文件加载失败时，可以根据播放器展示的错误信息进行排查。

2. 现象：音视频文件无声。

   处理：这是由于浏览器或者系统限制，音视频可能是默认静音播放。建议在初始化白板前引导用户点击允许播放音频。

3. 现象：音频文件和视频文件无法同时播放。

   处理：每个白板页上最多可添加 1 个音频和 1 个视频。iOS 系统只允许一个音视频播放，这意味着播放动作将自动暂停其他播放中的音视频。因此，如果房间内存在 iOS 设备，会出现无法同时播放音频和视频。

静态转码文档要求

1. 文档大小不超过 200 MB。
2. 文档页数不超过 500 页。

动态转码文档要求

1. 文档大小不超过 300 MB。无页数限制。
2. 插入的视频大小应小于 80 MB。
3. 视频和动画设置为 ”不默认播放“。否则，每次重新进入房间视频都会自动播放，可能影响交互体验。
4. 支持插入的视频格式包括：mp4, wmv, avi, mpg, mov, mpeg。
5. 不建议在视频之上添加图形元素。可能导致视频播放器的控制条无法正常显示。
6. 不建议添加连续动画。远端用户只能看到第一步和最后一步。
7. 取消文档的密码保护。
8. 文档中插入的超链接无法点击跳转。
9. 文档中插入的附件无法转码。

动态转码已知问题

1. 如果 GIF 动画无法正常加载。建议使用静态图片或转成视频文件代替。也可以尝试在文件中重置图片后再次发起转码任务。
2. 客户端处于弱网状况下，PPT 素材可能出现加载缓慢的情况，甚至加载失败。尤其是视频素材，由于在视频播放时才会触发转码。建议在检测到弱网环境时，提示用户更换更好的网络环境，否则可能需要等待较长时间或出现 PPT 和远端不同步的情况。
3. 如果同一个文件既有视频又有动画，当进入下一步时，视频会停止播放。
4. 动态转码结果不包含全屏操作和音量调节。
5. 对 PPT 的动画控制和视频播放控制同步到房间内多个客户端的时延可能超过 1 秒，由客户端网络状况决定。
6. 控制视频播放时，各端的加载速度不同，因此实际开始时间和进度可能不一致。
7. 多人同时操作同一个视频时，播放状态可能不同步。
8. 动态转码不会改变 PPT 中的字体设置，当客户端没有当前字体时，将显示为操作系统默认的字体。
9. 移动设备使用 Web 客户端时，在视频播放中退房后重进，视频将为停止播放状态。
10. Android 端的音频播放器没有进度条，不支持快进和快退操作。
11. Android 端的播放器没有音量调节按钮。
12. Android 客户端无法进行视频全屏操作。