接入流程

最近更新时间:2024-09-11 09:08:12

我的收藏
备用文档转码使用的是对象存储 COS 的文档转码能力,相对于主推的转码方案接入简单,只需要在对象存储 COS 控制台开通文档转码功能即可使用。关于对象存储文档预览更多信息请查看具体的 文档预览概述文档

备用转码方案的优势

1. 接入简单,一个 URL 和一个接口即可对接;
2. 备用转码方案针对 WPS 制作的课件兼容性好,主推转码方案针对 Office 制作的课件兼容性好;
3. 支持转码的格式类型多。

支持转码格式

动态演示文件:PPTX、PPT;
静态演示文件:PPTX、PPT、POT、POTX、PPS、PPSX、DPS、DPT、PPTM、POTM、PPSM;
文字文件:DOC、DOCX、DOT、WPS、WPT、DOTX、DOCM、DOTM;
表格文件:XLS、XLT、ET、ETT、XLSX、XLTX、CSV、XLSB、XLSM、XLTM、ETS;
其他格式文件:PDF、LRC、C、CPP、H、ASM、S、JAVA、ASP、BAT、BAS、PRG、CMD、RTF、TXT、LOG、XML、HTM、HTML。
说明:
1. 目前支持将上述文件类型转码为 JPG、PNG、PDF、HTML 格式。
2. 输入文件大小限制在200MB之内,输入文件页数限制在5000页之内。
3. 备用转码方案针对 WPS 制作的课件兼容性好,主推转码方案针对 Office 制作的课件兼容性好。

适用互动白板版本

互动白板从2.6.0的版本开始支持文档转码(备用)

转码服务开通

在腾讯云 对象存储控制台 中,在存储桶中开通转码服务。




在互动白板中使用

在页面中加载文档转码 SDK

注意:
只有 Web 端才需要加载,其他端忽略。
<script src="https://res.qcloudtiw.com/board/third/ci/sdk-beta-v1.1.9.js"></script>

获取课件的访问链接

将要转码的课件资源上传到 COS 存储桶中,并获取课件的 URL。






说明
请确保您使用的 URL 资源是可以跨域访问的。
如果您使用的是 COS 源站地址,请参考 COS 设置跨域访问 进行配置;
如果您使用的是 CDN 地址,请参考 HTTP 响应头配置 进行配置。

调用白板接口,将课件的 URL 设置到白板中

在上一步获取到的课件 URL 中,拼接参数 for_tiw=1for_tiw=1作为识别转码(备用)方案的标识,一定需要加上。
调用互动白板接口 addTranscodeFile 将 URL 设置到白板中。
注意
URL 中不需要带 COS 文档预览功能的 ci-process=doc-preview&dstType=html 这些参数,只需要保留 for_tiw=1 和您的业务参数。
// 以 web 端代码为例
// 示例三:2.6.0版本起,支持cos转码
teduBoard.addTranscodeFile({
title: "欢迎新同学", // 文件标题
url: "https://test-tic-1259648581.cos.ap-shanghai.myqcloud.com/%E6%AC%A2%E8%BF%8E%E6%96%B0%E5%90%8C%E5%AD%A6%20-%20%E5%BA%8F%E5%8F%B7%20(1).ppt?for_tiw=1" // cos资源的url,且携带for_tiw=1的参数
}, true)
说明
完成以上两步,转码添加到互动白板中的工作就已经完成了。

支持动态转码格式

目前互动白板中只支持:ppt(x) 。

支持的字体和动画

文档转 HTML 功能支持预览多种字体,并可预览演示文件中的动画效果,具体请参考字体支持表和动画支持表

特殊说明

1. 如果您是新接入用户,建议您将所有端的版本都接入至最新的2.6.0+的版本,即可体验最新的转码。
2. 如果您目前线上只有 Web 端,可以将互动白板升级至2.6.0+的版本,即可体验最新的转码。
3. 如果您目前线上还有存量移动端,客户端低于2.6.0的版本,也建议您提前接入2.6.0+版本,在存量用户都升级至2.6.0+的版本后,即可体验最新的转码。
4. 转码(备用)方案中,如果 PPT 中有未支持的动画,会采用默认的动画来代替,保证可以将 PPT 转码成功,这个是符合预期的。
5. 转码(备用)方案中,暂时不支持获取全量和获取每一页对应的步数。
6. 转码(备用)方案中,不支持客户端 snapshot 接口截图功能,支持使用 addSnapshotMark 接口用 云 API 板书生成服务