腾讯云实时互动教育版Web 和 H5_音视频解决方案_同尘科技

实时互动教育版 1年前 (2023-12-19) 浏览 376

本文主要介绍如何快速将腾讯云实时互动-教育版 LCIC Web/H5 应用快速集成到您的项目中。

前提条件

1. 您已经 注册腾讯云 账号,并完成 实名认证。2. 您使用的桌面或手机浏览器能够支持音视频服务。详细要求可参考 Web 端常见问题。

步骤一:创建新的应用

1. 登录 实时互动-教育版控制台,在左侧导航栏选择快速跑通。2. 默认进入创建应用页面,应用类型可选择“新建应用”,输入应用名称,例如 TestLCIC。若您已创建应用,应用类型项可以单击“关联已有应用”。说明:每个账号可免费领用一个试用版应用,若需创建商用版应用,可根据业务需求在 购买页 选择并购买对应版本。3. 添加或编辑标签(可选) ,单击下一步。
说明:应用名称只允许使用下划线、数字或中英文字符。标签用于标识和组织您在腾讯云的各种资源。例如:企业可能有多个业务部门,每个部门有1个或多个 LCIC 应用,这时,企业可以通过给 LCIC 应用添加标签来标记部门信息。标签并非必选项,您可根据实际业务需求添加或编辑。

步骤二:获取 SDKAppId 和密钥(SecretKey)

1. 进入 应用管理 > 应用配置,获取 SDKAppId。2. 进入 访问管理(CAM)控制台 获取密钥,若无密钥,需要在 API 密钥管理中进行新建,具体可参见 访问密钥管理。

步骤三:获取进入课堂所需参数

1. 通过调用云 API 接口 RegisterUser 注册用户,可以获取到对应的用户 ID(userid)信息。2. 通过云 API 接口 LoginUser 登录,可以获取到用户鉴权token信息。3. 通过云 API 接口 CreateRoom 创建课堂,可以获取到课堂号(classid)信息。4. 明确需要集成的课堂版本:latest。5. 其中scenedebugjsdebugcss为非必填参数,在需要自定义 UI 时才需设置,具体可参见 自定义 UI 集成。其中debugjsdebugcss只用于自定义布局、组件时的调试,且只支持通过localhost127.0.0.1的地址进行访问,在发布阶段请勿使用此参数。6. lnglocationlayout也是非必填参数,业务侧可自行判断是否需要传入,不传则使用默认值,其中layout参数只有在教室布局为视频+文档布局(videodoc)时才生效。

字段 类型 含义 备注 必填 
userid string 用户名 通过 RegisterUser 接口获取
classid string 课堂 ID 通过 CreateRoom 接口创建返回获取 
token string 后台鉴权参数 通过 LoginUser 接口获取
version string 课堂版本号 通过发布日志选择对应版本。说明:互动课堂客户端版本,建议使用 latest 
scene string 场景名称 用于区分不同的定制布局,通过 SetAppCustomContent 接口配置,默认为 default
debugjs string 自定义 UI 的 JS 链接 通过自定义 UI 集成方式获取
debugcss string 自定义 UI 的 CSS 链接 通过自定义 UI 集成方式获取
role string 进入课堂角色,默认空 可选参数 supervisor(巡课/内容审查) ,只有已注册应用内巡课用户才有权限 
lng string 语言参数,默认 zh-CN 当前支持 zh-CN、en-US
location boolean 是否上报经纬度位置信息 默认 false 不上报 
layout string 页面布局 默认顶部布局(top),当前仅视频文档模式有效,支持双排布局(double)、右侧布局(right)、左侧布局(left)、三分布局(three) 
boardColor string 白板颜色 白板颜色设置,默认为:#182E25 ,支持 Hex 格式,也支持 rgba(0, 0, 0, .3)设置 
back_url string 退出课堂回调地址 默认为空,单击返回或退出课堂时需要回跳的页面地址。参数需要使用 encodeURIComponent 编码 

步骤四:进入课堂

标准功能

将刚才获取到的参数,按以下规范拼接出用户进入课堂的 URL,通过跳转此 URL 链接即可实现 Web 端的集成。https://class.qcloudclass.com/latest/class.html?userid=${userid}&token=${token}&classid=${classid}具体链接如下所示:

https://class.qcloudclass.com/latest/class.html?userid=12345&token=yJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODAwNzQwMjEsImlhdCI6MTY3OTQ2OTIyMSwiaXNzIjoibFpNQ2tvTjNkSGlnVmhhcXJkdFc0cU9JYWpleVh2RWwiLCJzY2hvb2xfaWQiOjM5MjMxOTMsInVzZXJfaWQiOiIyTG9XREU2aHhzOUNCNVhCczZHT1BnVXpweUgifQ.2wzh6eUC4llbbGhchGDOYbDrsdSdymfP3zjLLPjnOII&classid=368507569

说明:在拼接的 URL 中userid与 创建课堂 指定的老师 ID(teacherid)是一致的,则当前用户为老师。若与当前课堂的助教 ID (assistantid)一致,则为助教,否则为学生。

高级功能

自定义 UI 集成

实时互动-教育版 LCIC Web/H5 目前还提供了自定义 UI 的集成方案。用户可自定义业务侧课中的布局及样式,通过 自定义 UI 部分 可以获取到业务侧的 JS 及 CSS 链接,将debugjsdebugcss参数拼接到上方的链接上即可(此参数只用于调试),如下所示:

https://class.qcloudclass.com/latest/class.html?userid=12345&token=yJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODAwNzQwMjEsImlhdCI6MTY3OTQ2OTIyMSwiaXNzIjoibFpNQ2tvTjNkSGlnVmhhcXJkdFc0cU9JYWpleVh2RWwiLCJzY2hvb2xfaWQiOjM5MjMxOTMsInVzZXJfaWQiOiIyTG9XREU2aHhzOUNCNVhCczZHT1BnVXpweUgifQ.2wzh6eUC4llbbGhchGDOYbDrsdSdymfP3zjLLPjnOII&classid=368507569&debugjs=http://localhost:443/demo/dist/myLib.umd.min.js&debugcss=http://localhost:443/demo/dist/myLib.css

当自定义 JS 与 CSS 调试完成后,可通过云 API 接口 SetAppCustomContent 或控制台 > 应用配置 > 场景配置将场景与自定义的 JS、CSS 链接进行绑定,在进入课堂时将scene参数拼接到 URL 上,即可加载对应场景的布局及组件。在涉及多种班型、多种布局时,业务侧可根据此参数实现场景的切换。如下所示:

http://class.qcloudclass.com/latest/class.html?userid=12345&token=yJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODAwNzQwMjEsImlhdCI6MTY3OTQ2OTIyMSwiaXNzIjoibFpNQ2tvTjNkSGlnVmhhcXJkdFc0cU9JYWpleVh2RWwiLCJzY2hvb2xfaWQiOjM5MjMxOTMsInVzZXJfaWQiOiIyTG9XREU2aHhzOUNCNVhCczZHT1BnVXpweUgifQ.2wzh6eUC4llbbGhchGDOYbDrsdSdymfP3zjLLPjnOII&classid=368507569&scene=default

自定义业务域名

在课中页面时,若业务侧想隐藏课堂域名,只显示业务域名,可通过 内容分发网络(CDN)控制台 新建业务域名,并回源到课堂域名即可,详细流程请参考 自定义业务域名。

其他相关文档

LCIC API自定义 UI 集成Web 常见问题

对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案

- 0人点赞 -

发表点评 (0条)

not found

暂无评论,你要说点什么吗?