超级白板
  • iOS : Objective-C
  • Android
  • Web
  • 产品简介
  • 下载
  • 快速开始
  • 体验 App
  • 基础功能
  • 进阶功能
  • 最佳实践
  • 常见错误码
  • 服务端 API v2
  • 客户端 API
  • 常见问题

文件规范

更新时间:2022-05-17 19:59

1 通用规范

  1. 请检查文件名称是否有特殊符号,建议命名只包含中英文以及数字,含特殊符号的文件名称易导致转码失败。
  2. 请检查存放文件的路径是否有特殊符号,含特殊符号的路径易导致转码失败。
  3. 要求文档是可编辑的,不支持“只读”、“加密”、或其他保护的文档,会导致转码失败。
  4. 制作文件请使用 Microsoft Office 2013 或以上版本,不支持低版本 Microsoft Office 或其他办公软件制作的文件,如 WPS、Keynote、Microsoft office 2003 等。

2 PPT演示文稿文件

  1. PPT 演示文稿文件最大支持 300 MB。
    注: 0 ~ 100 MB 的文件和 100 ~ 300 MB 的文件转码收费不同,详见 价格说明

  2. PPT 文件页数最多不超过 500 页。

  3. 建议 PPT 文件整体大小不超过 5 MB, PPT 单页大小不超过 300 KB(包含文字、图片和文件等所有元素),PPT 文件过大或 PPT 单页过大易导致文件加载缓慢或失败。
    a. 文件转码受资源限制,存在排队逻辑,且转码时间受文件大小影响,所以当转码任务很多或者文件很大时,排队或者转码时间会增加,造成提交的转码任务要较久之后才能完成。
    b. 需要共享的 PPT 文件,建议提前转码(例如提前一天提交转码任务),使用时即可直接加载使用,避免课上/会议中等待转码时间过长,影响体验。

  4. 建议 PPT 文件使用操作系统默认的中英文字体,请勿使用自己安装的字体,非操作系统默认字体易导致文字乱码和 PPT 样式错误。点击查看 PPT 支持的字体

  5. 动态 PPT 幻灯片页的换片方式,需设置为“单击鼠标时换片”,才可以使用“点击”工具点击幻灯片页翻页。否则,点击动态 PPT 文件页面不能进行翻页。

  6. 请勿在 PPT 文件中插入 Flash 文件,不支持 Flash 播放。

  7. 尽量不要在 PPT 文件中插入音频和视频文件,如果一定要插入,请遵循下述规范:
    a. 目前 PPT 内嵌音视频,仅支持视频文件的播放、暂停和拖动进度;纯音频仅支持播放,不支持暂停和进度调整,建议将音频文件转成 mp4 后插入 PPT 使用。
    b. 在动态 PPT 文件插入视频时,请勿设置切换页面或点击播放动画步骤后自动播放视频,否则,会引起 PPT 文件页面内容多端显示不同步。

  8. 在 PPT 里面插入 GIF 格式的图片时,GIF 图片插入需要注意以下规范:
    a. 需要将 GIF 图片属性设置为循环播放后再插入 PPT 使用,否则转码后会导致 GIF 动图无法正常播放。
    b. 请勿对 GIF 图片添加柔化边缘效果等图片特效,否则转码后会导致 GIF 动图无法正常播放。
    c. 请勿对 GIF 图片做图片裁剪操作,否则转码后会导致 GIF 图片尺寸显示异常。

  9. 请勿在 PPT 文件中插入外部链接,不支持打开外部链接。

  10. 请勿在原 PPT 中保留墨迹涂鸦,否则可能导致无法转码成功。

  11. 制作 PPT 动画效果注意事项:
    a. 请勿添加不支持的动效。查看 PPT 支持的动画效果
    b. 每页 PPT 中使用的动效尽量不超过 5 个,否则易导致文件加载缓慢或失败。
    c. 每页 PPT 中每个触发器下使用的动效果尽量不超过 1 个动效,否则易导致文件多端不同步。
    d. 每页 PPT 中尽量避免使用跨页面的动效,否则易导致文件多端不同步。
    e. 请勿设置会导致 PPT 翻页的动画/链接,否则易导致文件多端不同步。
    f. 给文字添加动效时请勿在编辑文字状态下添加,须在非编辑状态下添加动效。
    g. 请勿对元素添加 3D 动效。
    h. 同一个元素不要设置循环动效。
    i. 在 PPT 页面元素上,不要加盖蒙层,蒙层会影响元素的展示及点击效果。
    j. 请勿在单个动画未执行完成时就点击执行下一个动画,否则易导致多端动画展示效果不一致。
    k. 请将文本、数学公式等内容使用不同文本框展示,每个动画步骤对应一个文本框,否则转码后会影响动画步骤正常播放。

  12. 为保证 PPT 文件的清晰度,建议:
    a. 将 PPT 页面尺寸设置为默认宽高的 2 倍(制作 PPT 时,选择“设计 > 幻灯片大小 >自定义大小"菜单),即 16:9 比例下宽度 50 厘米,高度 28 厘米;4:3 比例下宽度 50 厘米,高度 38 厘米。
    b. 通过高清接口转码,但是需要注意使用高清转码会使得转码后文件变大,易导致文件加载缓慢或失败。

  13. 请勿在 PPT 左侧导航窗口中将 PPT 页面设置成隐藏幻灯片,否则可能导致该页面无法正常显示。

3 文档类文件(Word 或 PDF)

  1. 文档类文件最大支持 100 MB。
  2. Word 文件页数最多不超过 500 页。
  3. 文档类文件大小建议不超过 2 MB,文件过大易导致低带宽的用户加载缓慢或失败。
  4. 同一文件的所有页面宽度请保持一致,否则会导致部分页面显示不完整或页面抖动。

4 表格类文件(Excel)

  1. 表格类文件最大支持 10 MB。
  2. 表格类文件大小建议不超过 2 MB,文件过大易导致低带宽的用户加载缓慢或失败。
  3. 制作 Excel 时注意 sheet 不要超过 20 个,超过会返回错误。
  4. 制作 Excel 时不设置过多的行和列,可能会导致文件模糊。

5 图片类文件(JPG,JPEG,PNG,BMP)

  1. 图片类文件最大支持 100 MB。
  2. 图片类文件大小建议不超过 5 MB,文件过大易导致低带宽的用户加载缓慢或失败。

6 文本类文件(TXT)

  1. 文本类文件最大支持 2 MB。
  2. 建议单行输入文字不要过多,可使用自动换行,否则文件样式会显示异常。
  3. 文本类文件行数请勿超过 1 万行。
  4. 文本类文件如包含中文,需将文件存储为 UTF-8 编码格式,否则会出现乱码问题。

7 H5 文件

  1. H5 文件只支持 ZIP 压缩包上传,最大支持 50 MB。
  2. 压缩包内必须包含入口文件 index.html;如果需要支持缩略图,请将缩略图放在与入口文件同级的 thumbnails 目录中,缩略图名称需与上传时传入配置参数保持一致。
  3. 为了保证教室所有人处于相同状态,操作文件需要先调用 ZEGO 桥接层接口发送操作的请求,并在注册的回调中进行实际操作。
  4. 文件内样式避免使用内联样式,可以使用样式类。
  5. 文件内避免出现循环动画,无论是通过 js 还是 css 实现。
  6. 支持部分音视频的同步,请参考 H5 文件示例源码文件共享示例源码
  7. 为了保证教室内所有人处于相同状态,H5 文件需要处理好浏览器、WebView 的兼容性。
  8. 文件中的所有操作是和页绑定的,请确保每一个操作都在对应的页中去执行。