API 概览

描述

BRTC 互动白板提供文档转换服务，支持将 PPT、PPTX、DOC、DOCX、PDF 等格式的文件转换成静态图片，将 PPTX 的文件转换为动态 HTML 网页，转换后的图片或网页可作为演示资料在互动白板中展示。

静态文档转换

静态文档转换是指将 PPT、PPTX、DOC、DOCX、PDF 格式的文件转换成 PNG、JPG/JPEG 或 WEBP 格式的静态图片，转换后的文件不保留源文件的动画效果。

使用静态文档转换服务，你需要注意：

• 源文件最好在 50 页以内，超过 100 页可能会出现转换超时
• 源文件内包含的图片分辨率越高，转换速度越慢
• 推荐将文件转换为 PNG 或 JPG/JPEG 格式
• 在 PPT、PPTX、DOC、DOCX、PDF 格式的源文件中，PDF 文件的转换结果最为准确。如果转换后的文件样式过于不准确，可以将源文件转成 PDF 格式后重新转换
• 如果转换结果字体缺失可以使用 SDK 中的自定义字体功能或者联系互动白板技术支持

动态文档转换

动态文档转换是指将用 Microsoft Office 编辑的 PPTX 格式的文件，转换成 HTML 网页且转换后的文件会保留源文件里的动画效果。

目前动态文档转换 不支持 以下功能：

• WPS 格式的文件转换，即使将 WPS 转成 PPTX 后再进行文件转换，也不能保证成功解析
• 渐变色渲染
• 艺术字
• 形状效果
• 部分图片效果
• SmartArt 动画
• 页面切换时的过渡特效
• 文字动画及行动画（即文本框中每一行有一个动画）
• 大多数动画特效，例如，溶解、棋盘等
• 除横向和纵向以外的其他文字方向
• 部分音频播放选项和视频格式设置
• 隐藏页的转换

使用文档转换服务

BRTC 互动白板需要由业务服务端根据客户端的需求，调用 RESTful API 向互动白板服务端发起文档转换请求，如下图所示：

文件转码相关接口