快速接入

📌

Android版本1.68.110

1. 实时课堂集成方式

1. 项目升级到AndroidX支持库

项目需要用到AndroidX支持库，如果在使用Android Support库的请迁移，如果已经使用AndroidX请忽略。迁移可参考下面的说明，或查阅AndroidX迁移指南。

说明：

切换到单独的分支，迁移完成前最好不进行功能开发，然后将代码备份一份，防止迁移失败

检查项目中每个module中support库的依赖，将版本升级到28.0.0，需要将compileSdkVersion升级到28，保证项目正常能编译通过

在Android Studio中Refactor->Migrate to AndroidX完成迁移

编译项目，如果有编译错误，解决即可（如第三方依赖库版本不支持androidx需要升级到新版本，例如ButterKnife）

2. 配置伯索的maven仓库

在项目的build.gradle或settings.gradle文件中添加伯索的maven仓库。

3. app->build.gradle配置

在项目的app->build.gradle 中：

①配置minSdkVersion需要大于等于26，targetSdkVersion 大于等于33，

②添加SDK相关的依赖。

4. 实现IResourceProvider

IResourceProvider是定制化资料中心接口, APP提供该接口的实现，并传入SDK。IResourceProvider实现后我们需要创建一个StyleUpime对象，创建StyleUpime对象需要用到IResourceProvider，IResourceProvider不能为null，后续启动实时课堂需要使用StyleUpime对象。

在signQuery方法中我们需要生成一个query，生成方法参考如下形式：

5. 启动实时课堂

5.1 水印和日志配置（可选）

实时课堂支持配置日志和水印，在启动实时课堂之前我们可以根据自己的需要进行设置，如不需要可以忽略。

UpimeParameter 参数说明：

参数名	参数类型	是否必须	默认值	参数说明
appId	String	否	-	应用唯一标识
waterMark	String	否	-	水印
logDir	String	否	-	日志路径
logLevel	int	否	-1	日志级别 DEBUG: 0 INFO: 1 WARN: 2 ERROR: 3

5.2 设置违禁词 (可选)

用户可以在进课堂前传入自定义违禁词列表。设置后，课堂内的消息输入将应用此词库进行过滤。

5.3 启动实时课堂流程

query参数说明：参数说明表格
query生成完成后需要在启动实时课堂时传给SDK，需要构建一个ClassConfig对象，ClassConfig对象同样需要进行一些参数配置。ClassConfig对象创建完毕后只需要通过StyleUpime对象调用launchLiveClass方法即可启动实时课堂。

ClassConfig参数说明：

参数名	参数类型	是否必要	默认值	参数说明
classURL	String	是	-	实时课堂配置参数query ，如果query里面有中文字符串，此中文字符串需要编码后放到query里传入。
host	String	是	-	服务地址
userName	String	否	-	当前用户名称
classMember	ArrayList<User>	否	-	课堂成员列表
allowLocalPPT	boolean	否	true	是否允许在实时课堂中插入本地PPT
enableSendMessage	boolean	否	true	消息界面是否显示消息输入框
hideOtherClient	boolean	否	false	是否显示学生不在班级的所有学生和助教
endRemindTime	int	否	0	实时课堂添加双减的提示时间，到达这个时间之后，会提示用户 (:秒)
redPacketLimit	int	否	0	红包雨个数限制
defaultPermission	int	否	0	会议模式默认权限
supportSelect	boolean	否	true	是否支持工具栏选择箭头
openFileMode	int	否	null	文件打开模式
toolboxItems	int	否	-	百宝箱工具条目配置(工具请参考UpimeConfig.ToolBoxItem)
enableInteractPpt	Boolean	否	false	是否开启PPT交互
teachToolTypes	int	否	0	教具类型支持的类型(类型请参考UpimeConfig.TeacherToolType)
supportUndo	Boolean	否	false	是否支持撤销操作
useNewSmallBoard	Boolean	否	false	是否使用新版小黑板
supportHighlighter	Boolean	否	false	是否使用荧光笔
forbiddenScreenShot	Boolean	否	false	是否防止课堂截屏
enableVote	Boolean	否	false	是否支持投票工具
enableSaveBoard	Boolean	否	false	是否支持保存板书功能，如果支持需要对接实现onUpimeBoardSaved这个回调，保存数据到自己三方服务器
chatMsgPopup	int	否	0:本地记录; 1:远端控制开启; 2:远端控制关闭; 默认0，仅对学生生效，老师不受此配置控制	学生进入课堂是消息弹框提醒设置
enableAns	boolean	否	true	是否开启降噪功能
enableStarShow	boolean	否	false	是否支持显示积分排行榜
recordingPreparationTip	String	否	-	服务端录制课堂延时提示语，只有使用服务端录制课堂才需要添加这个提示语
hideRecordingIndicator	boolean	否	false	是否隐藏“录制中”状态字样
showStudentClassElapsedTime	boolean	否	false	学生端是否显示已开课时间文案

6. 资料中心接入事项

本章节说明资料中心两类文件（非预解析、预解析）的接入要点与回调契约，保持原有对接逻辑不变：

非预解析文件：通过 insertObject 直接插入，视 info 类型决定是否触发回调签名（getExtFileName）。

预解析文件：通过 insertObject 插入后，由 SDK 回调 getPreParseFileName 按页/资源后缀返回可访问直链。

通用回调接口（签名与取址）：

getExtFileName（非预解析使用）

方法签名（Kotlin）：fun getExtFileName(info: Any?, callback: IResourceCallback?)

语义：基于插入时的 info 计算资源直链（含签名），成功回调 callback.onFilePath(realUrl)，失败回调 callback.onFilePath(null)。

getPreParseFileName（预解析使用）

方法签名（Kotlin）：fun getPreParseFileName(info: Any?, suffix: String?, callback: IResourceCallback?)

语义：基于预解析文件标识（info）与页面后缀（suffix）计算资源直链（含签名），成功回调 callback.onFilePath(realUrl)，失败回调 callback.onFilePath(null)。

6.1 非预解析文件

资料中心打开非预解析文件时，需要创建如下 UpimeObject 并调用 insertObject 将文件插入课堂：

(1) info 传入 String 类型

type 可为 TYPE_PPT、TYPE_DOC、TYPE_XLS、TYPE_PDF、TYPE_AUDIO、TYPE_VIDEO；

info 必须是“可直接访问的 HTTP 地址”（无需额外签名）。

行为：调用 insertObject 后，直接将文件插入白板，不会触发额外回调（无需实现方处理）。

(2) info 传入 List 类型

type 建议用于 TYPE_AUDIO、TYPE_VIDEO；

info 为 List 类型（实现方自定义结构）。

行为：调用 insertObject 插入后会回调 getExtFileName。实现方需在 getExtFileName 中完成签名并返回完整可访问的 HTTP 地址。

getExtFileName 方法与参数约定（Kotlin）：

方法签名：fun getExtFileName(info: Any?, callback: IResourceCallback?)

参数说明：

info: 插入文件时 UpimeObject.info 的原始对象。常见做法是包含用于定位与签名的标识信息（例如携带 id 的 List 或其他结构）。

callback:

成功：callback.onFilePath(realUrl)（建议在主线程回调）。

失败：callback.onFilePath(null)（或记录错误后结束，避免长时间无回调）。

6.2 预解析文件

资料中心打开预解析文件时，需要创建如下 UpimeObject 并调用 insertObject 将文件插入课堂：

行为：调用 insertObject 后，会回调 getPreParseFileName；实现方需在该函数中完成签名并返回完整可访问的 HTTP 地址。

getPreParseFileName 方法与参数约定（Kotlin）：

方法签名：fun getPreParseFileName(info: Any?, suffix: String?, callback: IResourceCallback?)

参数说明：

info: 预解析文件的唯一标识。常见形态为 List，包含键 "id"：例如 ["parsed", {"id":"abcdef123456"}]（推荐）。实现方应优先从 List 中读取 id，据此计算文件地址。

suffix: 资源相对路径/页面后缀，例如："/1.jpg"、"/index.html"、"/ispring.html"、"/info.json"（用于指示要获取的具体页码或页面文件）。

callback:

成功：callback.onFilePath(realUrl)（建议在主线程回调）。

失败：callback.onFilePath(null)（或记录错误后结束，避免长时间无回调）。

提示：suffix 在参与拼接与请求时通常需要进行 URL 编码；若包含图片处理等查询参数，请整体进行编码后透传到服务端签名。

参考示例代码:(详细代码可参考demo)

7. 对接注意事项

(1). 在DemoApp.kt文件中传入appId 和appKey 值,详情参考下文例子;签名请通过在服务器中完成，Demo 中只是样例。

(2). AndroidManifest.xml添加下面代码，不然课堂里面截图至相册功能可能会失败

<meta-data
    android:name="ScopedStorage"
    android:value="true" />

(3). targetSdkVersion 设置成 33；

8. 参考代码demo

以上就是实时课堂SDK的集成步骤，更加详细步骤请参考代码Demo，请点击下载。

使用步骤：

1）下载代码并解压到本地

2）修改build.gradle文件，升级版本到version=1.68.110

3）修改文件： app/src/main/java/cn/plaso/liveclasssdkdemo/Config.kt，填入伯索分配的appid和key后即可体验

1. 实时课堂集成方式#

1. 项目升级到AndroidX支持库#

2. 配置伯索的maven仓库#

3. app->build.gradle配置#

4. 实现IResourceProvider#

5. 启动实时课堂#

5.1 水印和日志配置（可选）#

5.2 设置违禁词 (可选)#

5.3 启动实时课堂流程#

6. 资料中心接入事项#

6.1 非预解析文件#

6.2 预解析文件#

7. 对接注意事项#

8. 参考代码demo#