超级白板
  • iOS : Objective-C
  • Android
  • Web
  • Electron
  • React Native
  • 产品简介
  • 下载
  • 体验 App
  • 快速开始
  • 基础功能
  • 进阶功能
  • 最佳实践
  • 客户端 API
  • 服务端 API v2
  • 常见错误码
  • 常见问题
  • 文档中心
  • 超级白板
  • 产品简介
  • 使用限制
  • 文件规范

文件规范

更新时间:2023-06-01 11:07

通用规范

  • 文件名称:不能含有特殊符号,建议文件名称中仅包含中、英文、以及数字,含有特殊符号的文件名称可能会导致转码失败。
  • 文件路径:不能含有特殊符号,含有特殊符号的文件路径可能会导致转码失败。
  • 文件权限:文件必须是“可编辑”的,不支持“只读”、“加密”、或其他保护权限的文档,否则可能会导致转码失败。
  • 文件制作工具:制作文件时,请使用 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 的兼容性。
  • 文件中的所有操作是和页绑定的,请确保每一个操作都在对应的页中去执行。
本篇目录