文档转码

最近更新时间:2019-12-18 15:32:04

功能简介

腾讯云文档转码服务为您提供了将文件转码为HTML5页面和图片的能力,将转码后的文档展示于白板,为您提供和线下教育体验高度一致的在线教育服务。

如何使用实时录制

文档转码服务接入有两种方式,一种为主动轮询(较适用于客户端发起转码请求),一种为注册 CGI 接口回调(较适用于服务端发起转码请求)。两种接入方式的基本使用流程如图所示:

主动轮询

主动轮询

注册 CGI 接口回调

注册 CGI 接口回调

上传文档并获取链接注意事项

发起转码时需要提供待转码文档的下载链接,转码服务将在文档下载完成后开始转码。您可以选择使用腾讯云对象存储上传文档并获取下载链接,也可以使用您自己的文件服务器,以下几点需要注意:

  1. 目前只支持包含http://https://前缀的 URL。
  2. 请检查 URL 的访问权限,保证文档转码服务能正常访问并下载该文档原文件。如果您使用腾讯云对象存储(Cloud Object Storage,COS),请检查存储桶的访问权限为公有读私有写。您可以在腾讯云控制台设置存储桶的访问权限,具体请参考 设置访问权限
  3. 如果您使用其他的文件存储服务,请注意文件存储服务的上传带宽,文档转码服务提供1分钟的下载时间,如果下载不成功本次的转码请求将以失败终止。
  4. 默认情况下,PPT 文档(后缀名为.ppt.pptx)会转码成HTML5页面,能够还原 PPT 原有的动画效果,其他文档会转码成静态图片。
  5. PPT 动态转码成HTML5页面的时间大约为每页1s,文档转码成静态图片的时间大约为每页0.5s,

支持转码格式

目前只支持:doc(x)、ppt(x) 和 pdf 文档;暂时不支持 excel 和 txt 文档转码。

ppt 演示文稿课件格式建议

  1. 建议使用 Microsoft Office 2007或以上版本(wps 和 keynote 都有一定的兼容性问题)。
  2. ppt 转码文件必须是可编辑的。不支持“只读”、“加密”、或其他保护,导致 ppt 无法编辑的文件转码。
  3. 请勿使用不支持的四种 ppt 动效,包括:1:“Bold Flash”、2:“Underline”、3:“Grow With Color”、4:“Bold Reveal”。
  4. 请勿插入 flash 动画,不支持 flash 动画播放。
  5. 如果使用 wps,请注意不支持 wps ppt 中的音视频元素。
  6. 如果使用 keynote,请注意插入的音频播放标签,无法展示。
  7. 建议使用操作系统默认的中英文字体,请勿使用自己安装的字体,否则可能会出现转码失败或者转码 h5 格式异常 查看转码服务器支持字体
  8. ppt 页数不要过多,页数越多,转换速度越慢(目前最大支持500页转码)。
  9. ppt 中如果带有音视频,体积尽量小,否则会影响转换速度和转换后的 h5 加载速度。

常见问题

  1. ppt 转 h5后,出现某些字体错位,或大小不一致,如何处理?
    问题原因:该问题一般是因为 ppt 中使用了转码服务器不支持的字体库导致的。查看转码服务器支持字体
    解决方法(两个方法):
    方法一:
    去掉或更改字体为服务器支持的字体库。
    操作指引:
    打开 ppt,选择不支持字体的文字,然后切换到服务器支持的字体。
    方法二:
    ppt 保存时,将字体库一起打包进 ppt。
    操作指引:
    打开 ppt,选择【文件】>【选项】>【保存】,然后勾选【将字体嵌入文件】>【仅嵌入演示文稿中使用的字符(适于减小文件大小)】>【确定】保存 ppt,看到 PowerPoint 的底部状态栏,显示【正在嵌入字体】即可。
    保存字体

  2. 为什么有些 ppt 动效,转换为 h5 后,丢失了呢?
    问题原因:ppt 中使用了不支持转换的动效;包括:1:“Bold Flash”、2:“Underline”、3:“Grow With Color”、4:“Bold Reveal”。
    解决方法:去掉不支持的特效或者使用其他特效替换。

  3. 为什么有些 ppt 或 pptx 文件,本地 PowerPoint 预览正常;但是转码时,服务器返回错误“ppt may contain unsupported elements”?
    问题原因:ppt 的内容中含有一些不支持转码 h5 的元素,所以导致转码失败。
    解决方法:如果是 pptx 格式文件,可以用 PowerPoint 另存为 ppt 格式,然后重新尝试转码。
    如果是 ppt 格式文件,可以用 PowerPoint 另存为 pptx 格式,然后重新尝试转码。

  4. 文档转码返回 url 的有效期是多长时间?
    有效期3个月。3个月后,您需要重新调用文档转码服务。

  5. 为什么会遇到“-9 ppt transform failed! Ppt Format not support!”错误呢?应该如何解决?
    问题原因:ppt 中,可能含有某些元素,导致转换成 pptx 失败。
    解决方法:将 ppt 用 PowerPoint 手动转为 pptx,确认打开 pptx 不会有任何报错后,在使用转换后的 pptx 重新发起转码。

  6. 为什么会遇到“-20 UnKnow Ppt property! Ppt Format not support!”错误呢?应该如何解决?
    问题原因:1. ppt 文件,可能是“只读”、“加密”、或其他保护,导致 ppt 无法被编辑;2. ppt 文件,可能含有不支持的转码属性。
    解决方法:如果 ppt 不支持编辑:修改 ppt 为可编辑,然后再次尝试转码。
    如果含有不支持的属性:PowerPoint 打开 ppt,修改 PowerPoint 提示的异常属性,然后再次尝试转码。