文件规范

通用规范

• 文件名称：不能含有特殊符号，建议文件名称中仅包含中、英文、以及数字，含有特殊符号的文件名称可能会导致转码失败。
• 文件路径：不能含有特殊符号，含有特殊符号的文件路径可能会导致转码失败。
• 文件权限：文件必须是“可编辑”的，不支持“只读”、“加密”、或其他保护权限的文档，否则可能会导致转码失败。
• 文件制作工具：制作文件时，请使用 Microsoft Office 2013 或以上版本，不支持低版本的 Microsoft Office 或其他办公软件制作的文件，如 WPS、Keynote、Microsoft office 2003 等。

各类文件规范

PPT 演示文稿文件

• 文件大小：PPT 演示文稿文件最大支持 300 MB。请注意，文件大小在 “0 ~ 100 MB” 和 “100 ~ 300 MB” 区间的文件转码收费不同，详情请参考 价格说明。

  建议 PPT 文件整体大小不超过 5 MB， PPT 单页大小不超过 300 KB（包含文字、图片和文件等所有元素）。PPT 文件过大或 PPT 单页过大，可能会导致文件加载缓慢或失败。

  • 文件转码受到资源限制，需要排队处理，且转码时间受到文件大小影响。所以当存在多个转码任务、或者文件很大时，排队或者转码时长会增加，造成转码任务需要更长的时间才能完成。
  • 需要共享的 PPT 文件，建议提前进行转码（例如，提前 1 天提交转码任务），使用时直接加载即可使用，避免上课时、或会议中等待转码时间过长，影响用户体验。

• 文件页数：PPT 文件页数最多不超过 500 页。

• 文件字体：建议 PPT 文件中使用操作系统默认的中、英文字体，请勿使用自定义安装的字体，否则可能会导致文字乱码或 PPT 样式错误，详情请参考 PPT 支持字体列表。

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

• 文件中插入附件、插件等：

  • 请勿在 PPT 文件中插入 Flash 文件，不支持 Flash 播放。

  • 请尽量不要在 PPT 文件中插入音频和视频文件。如果无法避免，请遵循下述规范：

    • 插入音、视频文件时，仅支持视频文件的播放、暂停和拖动进度；纯音频仅支持播放，不支持暂停和进度调整，建议将音频文件转成 mp4 后再插入 PPT 使用。
    • 在动态 PPT 文件插入视频时，请勿设置“切换页面”或“点击播放动画”等操作后自动播放视频，否则，会造成 PPT 文件页面内容多端显示不同步。
    • 插入音、视频文件时，请不要设置为自动播放。

• 文件中插入图片：在 PPT 里面插入 GIF 格式的图片时，

  • 需要将 GIF 图片属性设置为“循环播放”后，再插入 PPT 使用，否则转码后会导致 GIF 动图无法正常播放。
  • 请勿对 GIF 图片添加柔化边缘效果等图片特效，否则转码后会导致 GIF 动图无法正常播放。
  • 请勿对 GIF 图片做图片裁剪操作，否则转码后会导致 GIF 图片尺寸显示异常。

• 文件动画效果：

  • 请勿添加不支持的动效，详情请参考 PPT 支持动画效果。
  • 每页 PPT 中使用的动效尽量不超过 5 个，否则可能会导致文件加载缓慢或失败。
  • 每页 PPT 中每个触发器下使用的动效尽量不超过 1 个，否则可能会导致文件多端不同步。
  • 每页 PPT 中尽量避免使用跨页面的动效，否则可能会导致文件多端不同步。
  • 请勿设置会导致 PPT 翻页的动画/链接，否则可能会导致文件多端不同步。
  • 给文字添加动效时，请勿在编辑文字状态下添加，须在非编辑状态下添加动效。
  • 请勿对元素添加 3D 动效。
  • 同一个元素不要设置循环动效。
  • 在 PPT 页面元素上，不要加盖蒙层，蒙层会影响元素的展示及点击效果。
  • 请勿在单个动画未执行完成时就点击执行下一个动画，否则可能会导致多端动画展示效果不一致。
  • 请将文本、数学公式等内容使用不同文本框展示，每个动画步骤对应一个文本框，否则转码后会影响动画步骤正常播放。

• 其他注意事项：

  • 请勿在 PPT 文件中插入外部链接，不支持打开外部链接。

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

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

  • 为保证 PPT 文件的清晰度，建议：

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

文档类文件（Word/PDF）

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

表格类文件（Excel）

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

图片类文件（JPG/JPEG/PNG/BMP）

图片类文件最大支持 100 MB。建议不超过 5 MB，文件过大可能会导致低带宽的用户加载缓慢或失败。

文本类文件（TXT）

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

H5 文件

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