旧版文档转换服务

声网互动白板提供文档转换服务，支持将 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 格式后重新转换。
• 本功能基于 Aspose 实现，因此声网目前无法及时响应定制化需求。建议你在使用前先做充分的测试，如果不符合预期请使用三方转换服务。
• 如果转换结果字体缺失可以使用 SDK 中的自定义字体功能或者联系互动白板技术支持。

动态文档转换

动态文档转换是指将用 Microsoft Office 编辑的 PPTX 格式的文件，转换成 HTML 网页。转换后的文件会保留源文件里的动画效果。 目前动态文档转换不支持以下功能：

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

信息

如果转换结果字体缺失，可以使用 SDK 中的自定义字体功能，或者联系互动白板技术支持。

前提条件

使用互动白板文档转换服务前，你需要先完成以下准备工作。

开通第三方云存储账号

声网互动白板使用第三方云存储服务存储转换后的文件。因此，使用声网互动白板文档转换服务前，请确保你已开通第三方云存储服务。

开启文档转换服务

参考以下步骤在声网控制台开启互动白板文档转换服务并添加存储配置：

1. 进入声网控制台的项目管理页面，选择已开通互动白板服务的项目，点击编辑。

2. 在编辑项目页面，找到白板，点击配置。

3. 在配套服务下，选择数据中心，点击配置。该数据中心必须与你调用创建房间 API 时在 region 字段中填入的数据中心一致；否则，服务配置不生效。

4. 在服务配置下，找到文档转图片或文档转网页，选择已启用。

5. 设置存储空间：

   • 点击存储方框右侧的箭头，在下拉列表中选择你已配置的第三方存储空间。
   • 点击创建，新增一个存储空间配置。你需要填写以下信息：
     • 名称：（必填）存储空间的名称。
     • 供应商：（必填）第三方云存储服务的供应商。
     • 区域：（必填）创建 Bucket 时指定的数据中心所在区域。
     • accessKey：（必填）存储服务供应商提供的访问密钥中的 Access Key，用于识别访问者的身份。
     • secretKey：（必填）存储服务供应商提供的访问密钥中的 Secret Key，用于验证签名的密钥。
     • bucket：（必填）Bucket 的名称。
     • 存储路径：资源在 Bucket 中的存放路径，默认为根目录。
     • 外链域名：对外服务的访问域名。如果使用七牛云 OSS，该字段为必填，否则声网将无法访问该存储服务内的资源。该字段必须包含协议头，比如 https:// 或 http://。

注意

要获取第三方存储空间的配置信息，请参考对应的云存储服务供应商的官方文档。

第三方存储空间应开启公共读或更高权限，以确保你的 App 客户端可以访问其中的文件。

6. 点击保存，仔细阅读弹窗提示后点击确定。

上传文件

发起文档转换任务前，你需要将待转换的文档上传至第三方云存储空间或你自己的 Nginx 服务器，生成一个声网互动白板服务可访问 URL 地址，确保声网互动白板服务可通过该 URL 地址访问待转换的文档。

使用文档转换服务

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

信息

调用 RESTful API 发起文档转换任务时，你需要传入待转换文件的 URL 地址、转换任务类型等参数。详见发起文档转换（旧版）。

调用 RESTful API 查询转换任务进度时，你需要传入转换任务的 UUID 和用转换任务 UUID 生成的 Task Token。详见查询文档转换任务进度（旧版）。

建议你设计轮询机制定时调用查询转换任务进度 API，以实时获取转换任务的状态。

文档转换服务按 QPS 计费

QPS（Queries-Per-Second）指每秒查询率，默认情况下，声网互动白板文档转换服务只能同时处理一个文档转换请求（即 QPS 为 1），在前一个转换完成后才会进行第二个任务的转换，并按成功转换的页数计费。

如果你的某个白板项目每秒并发请求数量较大，默认的 QPS 无法满足你的需求，你可以联系 sales@shengwang.cn，申请调整该项目的 QPS 配置并按 QPS 计费。QPS 计费方案细节详见文档转换服务按 QPS 计费。