开发者学堂课程【低代码音视频开发教程:文档、白板功能模块集成说明】学习笔记,与课程紧密联系,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/936/detail/14874
文档、白板功能模块集成说明
内容介绍:
一、文档白板结合举例
二、文档模块简介
三、白板模块简介
一、文档白板结合举例
以 Web 为教师端,以安卓为学生端的课堂场景使用示例
首先左侧画面中的是事先准备好的依赖文本功能上传的的文档同步展示到学生端,结合到白板上面可以使用一些比较常规的例如激光笔画笔或者添加文本之类的操作,这些操作都会同步展示到学生端,同时支持的学生端还有安卓,IOS,iPad,Windows
二、文档模块简介
1.文档功能模块集成说明:
及上传转码下载为一体的快速且安全地 SDK
2.基础能力
(1)上传
支持类型: ppt 、 pptx 、 pdf 。
每次上传任务限定 PPT 不超过100页、文件大小不超过100MB。
(2)下载
需使用特定文档 ID
(3)转码
限制:转码功能目前仅支持输出 jpg 类型文件。
访问链接:通过 getUrIList 接ロ获取转码后的访问链接
3.优势
(1)免费
限制范围内完全免费
(2)快速
CDN 加速
(3)安全
①访问鉴权
过期时长限制
接下来从上传转码下载三部分对文档模块进行说明,覆盖平台有IOS,安卓,web还有 Windows,不是所有功能在全端均可用,具体情况需查询支持平台
②接入说明
上传
示例 API 较为简单,通过本地拿到的文件透给 API 进行上传,调用回调里面会有处理结果通知,包括成功或者结束。
文档ID数据返回回来,像 iOS 的 docID 等。文档 ID 是后续的访问凭证
Web暂无
Windows:
(2)获取文档下载地址
通过刚才拿到的 docID 进行下载,支持的平台有安卓,iOS,基本的 API 如下
限制:一定要使用上传、转码中获取到的文档ID才能查询到相关信息
Android:
Web暂无
Windows暂无
(3)下载
限制:一定要使用上传、转码中获取到的文档ID才能成功查询到相关信息
iOS
Web暂无
Windows暂无
(4)转码
文档模块支持对指定文档 Id 的文件进行转码。您可以通过上传、转码功能获取文档 Id 。
转码功能目前仅支持输出 jpg、PNG 类文件。转码至其它类型的功能正在开发中。
API列举如下
iOS:
Android
Web
Windows
三、白板功能模块集成说明
接口回调中会获取到使用白板的一些敏感数据,例如 docKey (又称 WhiteBoardlnstanceld )、 accessToken (各端略有差异)。此类数据在白板 SDK 内部有针对性处理,如无特殊要求无需关注
基础能力
1.初始化
2.录制
白板录制为白板的回放功能提供数据源。
3.回放
白板支持录制操作。白板录制为白板的回放功能提供数据源。
4.图片与页码操作
白板可以设置 URL 形式背景图片,此能力可以与文档模块结合起来,实现白板内展示文档的功能。
接入说明:
1.初始化
自板正常初始化是所有其它操作的基础,其它对自板 API 的调用,都需要保证在此操作收到成功回调之后进行。
各端 API 命名会有差异,但都类似有打开白板等字样.
Android
Web:需要直接通过白板SDK接入白板
Windows
2.录制
使用白板的前提是完成白板的初始化。
支持的功能有:打开录制、结束录制、暂停录制、恢复录制。
开始录制
Windows
结束录制
iOS
Web
暂停录制
Android
恢复录制
iOS
录制之后,正常结束后服务端做完转换处理后会把整场的白板的操作全部存下来,做完转换处理后,就可以运用白板的回放功能进行操作。
3.回放
白板操作开启录制之后,动作都会被录制下来。录制内容支持回放。本文提供实现白板已录制内容回放的接口及其描述。通过本章的 API ,可以实现白板已录制内容的回放。
前提条件1:完成白板初始化。初始化接口请参见初始化。
前提条件2:白板录制已完成。
支持的功能有:开始回放、暂停回放、恢复回放、跳转至某个时刻( seek )。
各端在各个功能方面API略有差异,安卓相对分装的更完整一些,更彻底一些。
(1)开始回放
Web :
需要在白板 SDK 初始化时提供 replay 参数开启回放模式,之后就可以使用白板提供的 API 进行回放了。详情请参阅:白板 Web 端集成与使用。
(2)暂停回放
Web :需要在白板 SDK 初始化时提供 replay 参数开启回放模式,之后就可以使用白板提供的 API 进行回放了。详情请参阅:白板 Web 端集成与使用。
(3)恢复回放
(4)跳转至某一时刻
4.白板图片与页码操作
白板可以设置 URL 形式背景图片,此能力可以与文档模块结合起来,实现白板内展示文档的功能。配合使用的 API 有上报、获取页码映射关系。
使用白板图片与页码操作的前提是完成白板初始化。
支持的功能有:为当前白板添加背景图片、上报白板页码映射关系、获取白板文档映射关系。
首先我们需要在了解到文档模块的一个转码功能之后获取到文档转码的结果,对每一个文档的图片访问链接,将图片访问链接设置到背景图上,进行映射的使用。
注意图片安全保护方面会有健全与过期的限制,需要做一个初期使用和后期操作。具体看开源工程SDK使用原码操作。
上报白板页码映射关系可用来管理多文档,删除文档,下面是各端API
(1)添加背景图
(2)上报白板页码映射关系
获取白板文档映射关系
iOS暂无
Android