「Agora 灵动课堂 aPaaS」FAQ 大汇总

灵动课堂 aPaaS 常见FAQ


更多 Agora 灵动课堂 aPaaS 相关链接:

Agora 灵动课堂 aPaaS 官网FAQ
Agora GitHub 链接1: 可下载demo
Agora GitHub 链接2: 可下载demo
Agora GitHub 社区


论坛内常见FAQ相关链接:

RTC 常见FAQ:论坛链接
RTM 常见FAQ:论坛链接
Web 常见FAQ:论坛链接
小知识 常见FAQ:论坛链接
云端录制 常见FAQ:论坛链接
本地录制 常见FAQ:论坛链接
小程序 常见FAQ:论坛链接
Vue 常见FAQ:论坛链接


点击问题展开答案


Q1. 在 Agora 控制台配置 aPaaS 时碰到“请先获取 Agora RESTful API ID 和密钥”时该如何处理?

参考文档:官网文档解释


  • 登录 Agora Console,点击右上角账户名,进入下拉菜单 RESTful API 页面。
  • 点击 添加密钥 ,获取客户 ID和客户密钥。获取后继续配置 aPaaS 即可。

Q2. 我在 Agora 控制台配置了我的阿里云 OSS 账号相关信息用于储存课件,为什么文件无法上传?

参考文档:官网文档解释


请检查你的阿里云 OSS 账号中是否进行以下配置:

  • 读写权限设为 公共读
  • 跨域规则配置:

Q3. 灵动课堂是否支持直播模式一样的推流CDN,是否支持第三方美颜、鉴黄等接入?

目前都不支持,需要客户自己在源码修改集成。


Q4. 移动端是否支持教师端,预计什么时候能够支持?

移动端目前不支持教师端,只支持学生端,预计Q3第三季度上线。


Q5. 灵动课堂restfulAPI请求报错401如何解决?

401是鉴权失败导致,启动课堂之前确保灵动课堂前提条件必须配置完成,参考文档:官网文档解释

特别说明:启动课堂调用launch方法中传递的token是rtm token,需要在rtm token生成器来生成临时token或者在服务端来生成rtm token,参考文档:官网文档解释


Q6. 想要自定义UI布局怎么做?

灵动课堂1.1.0版本新增自定义UI功能,参考文档:官网文档解释


Q7. 课程结束后下节课是否还能进入之前的课堂接着教学?

声网灵动课堂支持“未开始”、“开始”和“结束”三种课堂状态,课堂结束后无法再次加入无法再重新开始,教室结束1小时后会被销毁。可以通过restfulAPI来设置课堂状态,参考文档:官网文档解释

灵动课堂云服务 RESTful API 中还可以将指定用户从课堂中踢出、设置录制状态、获取课堂事件等接口服务,参考文档:官网文档解释


Q8. demo里roomType是0,修改课堂模式为其他的都会报错roomType conflict,是什么原因?

修改了课堂模式,各个端要保持统一。另外在进入房间时,要重新更换roomUid。


Q9. 报错:Uncaught (in promise) Error: Please setting Netless token in the Console.

这个报错是因为没有配置白板的token,参考文档:配置白板token


Q10. 报错:Unhandled Rejection (Error): you can only call it when the room is writable

这个报错是因为是因为设为了只读模式,参考文档:官网文档解释,切换为互动模式。


Q11.为什么灵动课堂使用屏幕共享时获取不到某些应用窗口(黑屏)?

旧SDK无法采集到采用新的windows新渲染技术的方法(dx加速)渲染的窗口,对于使用gdr渲染的我们就能抓到,该问题已于3.4.0修复。灵动课堂目前使用的SDK为教育专版2.9.0.107未修复此问题。


Q12. 课堂状态管理是怎样的?课件什么时候被销毁?

课堂会在频道内没有用户之后一小时被销毁,课件也会被删除。


Q13. 灵动课堂支持H5实时直播吗?

目前我们的灵动课堂不支持H5实时直播,预计Q3第三季度上线。


Q14. web学生端能否共享屏幕?

参考:官网demo,web可以参考shareTheScreen。事实上,教师和观众都可以直接调用方法AgoraRTC.createScreenVideoTrack()开始分享屏幕。


Q15. 灵动课堂web端上传ppt无法展示?

灵动课堂实现用白板上传ppt需要在netless 控制台开启文档转图片功能。


Q16. 声网云课堂中是否支持传输多个文档同时上白板?

很抱歉,Agora目前不支持全选文件然后队列上传文件的功能,现在只能支持文件一个个的上传。


Q17. 能否实现其他用户跟随学生端白板?

参考:,web可以参考shareTheScreen。事实上,教师和观众都可以直接调用方法AgoraRTC.createScreenVideoTrack()开始分享屏幕。

可以实现。可以体验我们的开源产品 Flat,
官网demo
官网demo
里面有学生跟随功能,把“视角跟随”的权限开给学生就可以实现。


Q18. 刚进入直播间,如何显示主播端之前在白板绘制的内容?

我们是支持显示主播端已经绘制的内容的,因为白板传输的是 diff 数据,也就是老师和学生之间相差的都会传过去。集成我们白板就会有这个功能。


Q19. 声网云课堂和灵动课堂的差别是什么?

灵动课堂是aPaaS解决方案,对 Agora RTC SDK、Agora RTM SDK、互动白板 SDK 和云端录制的复杂 API 进行模块化封装。声网云课堂是初代产品,功能并不完善。


Q20. 灵动课堂引入自定义UI报错

image

报错原因:内存泄漏导致

解决方案:编译前执行export NODE_OPTIONS=–max_old_space_size=3072


Q21. 怎么设置课程录制?

参考:官网文档


Q22. 如何在服务端获取指定App ID下所有课堂中发生的事件?

参考文档: 获取课堂事件


Q23. 如何向App报告课堂相关的事件回调?

参考文档:官网文档解释


Q24. 响应状态码对应含义 参考文档:官网文档解释
HTTP 响应状态码 业务状态码 描述
200 0 请求成功。
400 400 请求的参数错误。
401 N/A 可能的原因:1) App ID 无效。2) Token Authorization 中 x-agora-uidx-agora-token 错误或不匹配。
403 30403200 课堂已禁言,无法发送聊天消息。
404 N/A 服务器无法找到请求的资源。
404 20404100 课堂不存在。
404 20404200 用户不存在。
409 30409410 录制状态冲突,录制未开始。
409 30409411 录制状态冲突,录制未结束。
409 30409100 课程状态冲突,课程已开始。
409 30409101 课程状态冲突,课程已结束。
500 500 服务器内部错误,无法完成请求。
503 N/A 服务器内部错误。充当网关或代理的服务器未从远端服务器获取响应。