agoraio-community/cloudclass-desktop

agora-classroom-sdk

For publishing npm package agora-classroom-sdk (Web & Electron). Get more information from https://docs.agora.io

Requirements

• TypeScript/JavaScript
• React
• Agora Developer Account
• Chrome Web Browser / Electron Environment

Platform Support

• = 66.0 Chrome Browser

• = Electron 7.1.2

Question / Issue Report

• https://github.com/AgoraIO-Community/CloudClass-Desktop/issues/new

• www.agora.io

cloudclass-desktop's Issues

400 Error trying to load https://api.agora.io/cn/edu/apps/.../v2/configs

I'm trying to run this CloudClass-Desktop sample on my system. I'm running Ubuntu 20.04 and using Visual Studio Code with Remote Containers.

I've spun up a container using VSC that runs Debian 10 (buster) and runs node.js 12.22.3.

I've installed yarn using npm i -g yarn and lerna via yarn global add lerna. I've then run yarn bootstrap. This fails initially due to the Electron code (it's an unsupported system).

I start the application: yarn run:apaas. It seems to run but the page is empty.

To be safe I remove the algora-electron-edu-demo folder and it's contents. Then I rerun yarn bootstrap followed by yarn run:apaas and the same thing happens.

All yarn's logging indicates everything is working fine. Looking at the browser console I'm seeing it:

1. set the config appId,
2. "launch"
3. GET https://api.agora.io/cn/edu/apps/deletedappId/v2/configs returning a 400 error
4. Returns the HTTP 400 response
5. Throws "Uncaught (in promise) s: Please setting Netless token in the Console."

Any suggestions on resolving this?

Thanks!

demo创建房间登入请求的时候404，在哪改

登入的时候请求地址域名后面貌似是区域获取到的是 /Undefined，但是看了很久也不太清楚哪里改

“我的资源”无法上传文件

在我的资源中进行上传文件操作，上传进度达到100%的时候停止不动，文件无法上传成功。

如下图：

error Command "bootstrap" not found.

https://docs.agora.io/en/flexible-classroom/get-started/?platform=web

I followed the steps on this page and successfully ran 2.7.1
But 2.8.1 failed and got the error reported, as shown in the picture

The link to plugin gallery in website is wrong

In this part of the guide clicking on the link to the plugin gallery ends up in 404 error. The link must probably be updated to this.

进入房间失败，响应400：{"message":"appid is invalid"}

我确认我的appid是跟agora管理系统-项目配置里的一模一样的
但是为何这里返回400？响应信息是appid不对呢？

用的分支：release1.0.1
修改的都是依赖的版本，没有动代码
在.env和.env.dev里加了REACT_APP_NETLESS_APP_ID，否则运行报错

@plutoless @Matrixbirds @fridaythx @saino @QinZhen001
汗。。。

NextJs App With Agora Flexible Classroom Issue on error - Module not found: Can't resolve '../../build/Release/agora_node_ext'

Hello Support,

We are trying to install the Agora classroom SDK on our Next Js Application, We are not getting the direction from where the code is breaking once it starting to build the application.

Here is attached reference screenshot of error message we are facing.

Error is - error - ./node_modules/agora-classroom-sdk/node_modules/agora-electron-sdk/js/Api/index.js:6:0
Module not found: Can't resolve '../../build/Release/agora_node_ext'

Could you please help us or direct us how can we resolve this and take the right direction for installation of the SDK on our codebase.

I have hosted my codebase on Vercel Platform.
https://agoraclassroom.vercel.app/

Thank You so much.

Global css isolation

Your script add a lot of global css which conflicts with the css of my application... Is there a way to avoid this?

The script is loaded like this:

<script
  id="agora-edu-sdk"
  src="https://download.agora.io/edu-apaas/release/[email protected]"
/>

electron本地运行失败

按文档的步骤进行，在运行到npm run dev时报错，麻烦看一下是什么情况呢
npm ERR! code 127
npm ERR! path /Users/yueke/Desktop/毕业设计相关/CloudClass-Desktop/packages/agora-electron-edu-demo
npm ERR! command failed
npm ERR! command sh -c cross-env NODE_OPTIONS=--max-old-space-size=8196 electron-webpack dev

Possible to upgrade electron to support darwin-arm64?

Hi maintainers,

With the current version of electron

CloudClass-Desktop/packages/agora-electron-edu-demo/package.json

Line 61 in 5d6c97a

"electron": "7.1.14",

I find it hard to install electron on my MacBook Pro (13-inch, M1, 2020), with the following output

➜  CloudClass-Desktop git:(release/apaas/1.1.2) ✗ node ./node_modules/electron/install.js 
(node:43866) UnhandledPromiseRejectionWarning: HTTPError: Response code 404 (Not Found) for https://github.com/electron/electron/releases/download/v7.1.14/electron-v7.1.14-darwin-arm64.zip
    at EventEmitter.<anonymous> (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/got/source/as-stream.js:35:24)
    at EventEmitter.emit (events.js:375:28)
    at module.exports (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/got/source/get-response.js:22:10)
    at ClientRequest.handleResponse (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/got/source/request-as-event-emitter.js:155:5)
    at Object.onceWrapper (events.js:482:26)
    at ClientRequest.emit (events.js:387:35)
    at ClientRequest.origin.emit (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/@szmarczak/http-timer/source/index.js:37:11)
    at HTTPParser.parserOnIncomingClient [as onIncoming] (_http_client.js:647:27)
    at HTTPParser.parserOnHeadersComplete (_http_common.js:126:17)
    at TLSSocket.socketOnData (_http_client.js:515:22)
(Use `node --trace-warnings ...` to show where the warning was created)
(node:43866) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). To terminate the node process on unhandled promise rejection, use the CLI flag `--unhandled-rejections=strict` (see https://nodejs.org/api/cli.html#cli_unhandled_rejections_mode). (rejection id: 1)
(node:43866) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

打包web

怎么打包web，部署到服务器了？谢谢v

How to restart a room?

When the room end we have an error message: Room is end! (Error 600001-20410100). How to reset or remove the room and launch it again?

Edit:

Found some doc here: https://docs.agora.io/en/agora-class/faq/agora_class_state

It seems impossible to reset the classroom when it has been ended. You have to wait 1 hour, for the server to delete it.

依赖项错误: white-web-sdk

使用yarn安装的依赖：

"agora-classroom-sdk": "^1.1.5-rc.2",

需要展示课件视频，运行时显示：

index.js:1 Error: @netless/[email protected] requires white-web-sdk@^2.13.8 to work properly.

课件中图片可以展示，但是音频/视频不行。

谢谢

可以加入房间，但无法显示对方视频画面

一对一班级，用的rtmToken 测试，学生和老师都可以进入房间，可以打开视频，但相互看不到对方画面，只能看到自己的画面。我理解房间号其实就是channel吧，进入同一个channel是可以视频通信吧，是因为rtmtoken支持？

demo 太难跑了

https://api.agora.io/cn/edu/apps/61a6e2f99da14a2ba9ae34a36cbea236/v2/configs

不是 401 就是 400

本地运行失败？

D:\prototype2021\CloudClass-Desktop-master>yarn run:apaas
yarn run v1.22.10
$ lerna exec --scope=agora-apaas-demo npm run dev
lerna notice cli v3.22.1
lerna info versioning independent
lerna notice filter including "agora-apaas-demo"
lerna info filter [ 'agora-apaas-demo' ]
lerna info Executing command in 1 package: "npm run dev"

[email protected] dev
webpack-cli && NODE_ENV=development webpack serve

Hash: 86dde2dccecdc80c3f4d
Version: webpack 4.46.0
Time: 3444ms
Built at: 2021-06-25 12:21:48
Asset Size Chunks Chunk Names
bundle.js 10 MiB main [emitted] main
Entrypoint main = bundle.js
[0] multi ./src/index.js 28 bytes {main} [built]
[../../node_modules/agora-classroom-sdk/lib/edu_sdk.bundle.js] D:/prototype2021/CloudClass-Desktop-master/node_modules/agora-classroom-sdk/lib/edu_sdk.bundle.js 9.81 MiB {main} [built]
[../../node_modules/process/browser.js] D:/prototype2021/CloudClass-Desktop-master/node_modules/process/browser.js 5.29 KiB {main} [built]
[../../node_modules/setimmediate/setImmediate.js] D:/prototype2021/CloudClass-Desktop-master/node_modules/setimmediate/setImmediate.js 6.32 KiB {main} [built]
[../../node_modules/timers-browserify/main.js] D:/prototype2021/CloudClass-Desktop-master/node_modules/timers-browserify/main.js 1.97 KiB {main} [built]
[../../node_modules/webpack-cli/node_modules/webpack/buildin/global.js] (webpack)/buildin/global.js 472 bytes {main} [built]
[./src/components/app/index.js] 1.71 KiB {main} [built]
[./src/index.js] 223 bytes {main} [built]
'NODE_ENV' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
lerna ERR! npm run dev exited 2 in 'agora-apaas-demo'
lerna ERR! npm run dev exited 2 in 'agora-apaas-demo'
error Command failed with exit code 2.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

怎么加日语翻译

你好，我想把UI上的句子给翻译成日语，请问该修改什么文件？

前端如何监听在classroom触发的各种事件

比如开始上课、结束上课等事件，有回调的函数么。我只看到了一个事件监听回调
AgoraEduSDK.launch( document.querySelector(#${this.elem.id}), { rtmToken: "006ab68718dc761451fb9207c2f6406f28cIAB09glttLE9/F4pCdnPT2BZMzFzyA1px7NwZwZkogjIxqFa4MYAAAAAEABay44EKCBTYAEA6AO43FFg", userUuid: "ddd9254b136748179adff69aa6892327", userName: "teacher", roomUuid: "testa689232712", roleType: 1, roomType: 0, roomName: "测试课堂", pretest: false, language: "zh", listener: (evt) => { console.log("evt", evt) } } )
是在listener中监听各种事件，有没有具体的文档，我用的是agro-web-edu-demo 这个demo。

agora-rc-extension error

测试环境1：vite2.x + vue3 + typescript
externals已经配置 'agora-electron-sdk': 'commonjs2 agora-electron-sdk'
Could not resolve "../build/Release/agora-rc-extension" 错误加载失败。

Please setting Netless token in the Console这个在哪设置

code: 30400420
msg: "Please setting Netless token in the Console."
ts: 1624621645164

关于mac屏幕分享问题

你好,electron编译的mac端屏幕分享是不是需要授权?

目前是黑的,系统授权界面也没有需要授权的选项

本人是做移动平台开发的,对于electron是菜鸟,不知道是sdk问题,还是需要额外添加屏幕授权的代码,望指教,谢谢!

因为npm源导致 yarn pack:electron:win 执行失败

.npmrc配置的是走阿里的源。但是在打包下载electron的时候报错

发现是红圈处最前面少了v导致。但我不知道怎么fix这个问题，不熟前端工具

目前我是注释掉了，去走腾讯源是ok的

这个错误是找不到sdk么

在编译的时候报了这个错，Module not found: Error: ERROR in ./src/components/app/index.js
Module not found: Error: Can't resolve 'agora-classroom-sdk' in '/Users/jastyle/Desktop/Jastyle/pythonProjects/CloudClass-Desktop/packages/agora-web-edu-demo/src/components/app' 这个问题如何解决

demo跑不起来

2.4.1跑就报错了

Any plan to upgrade electron to support darwin-arm64?

Dear maintainers,

With the current version of electron

CloudClass-Desktop/packages/agora-electron-edu-demo/package.json

Line 61 in 5d6c97a

"electron": "7.1.14",

I find it hard to install electron on my MacBook Pro (13-inch, M1, 2020), with the following output

➜  CloudClass-Desktop git:(release/apaas/1.1.2) ✗ node ./node_modules/electron/install.js 
(node:43866) UnhandledPromiseRejectionWarning: HTTPError: Response code 404 (Not Found) for https://github.com/electron/electron/releases/download/v7.1.14/electron-v7.1.14-darwin-arm64.zip
    at EventEmitter.<anonymous> (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/got/source/as-stream.js:35:24)
    at EventEmitter.emit (events.js:375:28)
    at module.exports (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/got/source/get-response.js:22:10)
    at ClientRequest.handleResponse (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/got/source/request-as-event-emitter.js:155:5)
    at Object.onceWrapper (events.js:482:26)
    at ClientRequest.emit (events.js:387:35)
    at ClientRequest.origin.emit (/Users/syx/Code/CloudClass-Desktop/node_modules/@electron/get/node_modules/@szmarczak/http-timer/source/index.js:37:11)
    at HTTPParser.parserOnIncomingClient [as onIncoming] (_http_client.js:647:27)
    at HTTPParser.parserOnHeadersComplete (_http_common.js:126:17)
    at TLSSocket.socketOnData (_http_client.js:515:22)
(Use `node --trace-warnings ...` to show where the warning was created)
(node:43866) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). To terminate the node process on unhandled promise rejection, use the CLI flag `--unhandled-rejections=strict` (see https://nodejs.org/api/cli.html#cli_unhandled_rejections_mode). (rejection id: 1)
(node:43866) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

Is there a plan to support the Apple M1 macbook?

Thanks and best regards,
Jennifer

能不能设置聊天用户的头像

能不能修改聊天用户的头像 直接使用sdk都是默认的头像

示例里的H5课件怎么对接和上传？

Agora web education

yarn run v1.22.10
$ webpack-cli && NODE_ENV=development webpack serve
[webpack-cli] TypeError: Cannot read property 'name' of undefined
at new WebpackCLI (C:\Users\Projtrac\Desktop\Class\new-class\CloudClass-Desktop\node_modules\webpack-cli\lib\webpack-cli.js:19:22)
at runCLI (C:\Users\Projtrac\Desktop\Class\new-class\CloudClass-Desktop\node_modules\webpack-cli\lib\bootstrap.js:7:21)
at Object. (C:\Users\Projtrac\Desktop\Class\new-class\CloudClass-Desktop\node_modules\webpack-cli\bin\cli.js:23:5)
at Module._compile (internal/modules/cjs/loader.js:1068:30)
at Object.Module._extensions..js (internal/modules/cjs/loader.js:1097:10)
at Module.load (internal/modules/cjs/loader.js:933:32)
at Function.Module._load (internal/modules/cjs/loader.js:774:14)
at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)
at internal/main/run_main_module.js:17:47
error Command failed with exit code 2.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

Cannot install on M1 mac from version 2.5.0

I got an error when executing npm install agora-classroom-sdk.

Agora Flexible classroom - Chat not working

I just launched agora flexible classroom. But the chat module is not working and it's showing this console error. How do I solve this issue and chat work? Here are my codes. Please check:

SDK: https://download.agora.io/edu-apaas/release/edu_sdk_1.1.5.10.js

AgoraEduSDK.config({
// Here pass in the Agora App ID you have got
appId: self.agora_id,
})
AgoraEduSDK.launch(
document.querySelector("#classroom"), {
// Here pass in the RTM token you have generated
rtmToken: self.token,
// The user ID must be the same as the one you used for generating the RTM token
userUuid: self.authuserid,
userName: self.authuser,
roomUuid: "6441444714144", //Should be unique and generate when join
roomName: "demo-class", //Any
roleType: 1, //teacher = 1, student = 2, assistant = 3
roomType: 4, // Room1v1Class = 0, RoomBigClass = 2, RoomSmallClass = 4
pretest: true,
language: "en",
startTime: new Date().getTime(),
duration: 60 * 30, // dynamic time
courseWareList: [],
listener: (evt) => {
if (evt == 1){
this.joined = true //Ready
}
if (evt == 2){
this.joined = false //Leave
}
console.log("evt", evt)
}
}
)

Win10LTSC-1809 中 执行 yran run:pass 后报错 'NODE_ENV' is not recognized as an internal or external command

'NODE_ENV' is not recognized as an internal or external command,
operable program or batch file.
lerna ERR! npm run dev exited 2 in 'agora-apaas-demo'
lerna ERR! npm run dev exited 2 in 'agora-apaas-demo'
error Command failed with exit code 2.

摄像头和麦克风选择列表里只有一个“禁用”选项，无法选择摄像头

如果所示，在摄像头和麦克风选择列表中只有一个“禁用”选项。

我们的需求是显示多个摄像头(如虚拟摄像头+自带的摄像头)，并可以自由切换，请问这是一个bug，还是功能没有实现？

Chat, whiteboard not working

We tried with the testing appID, appSecret to run the project locally. But the chat & whiteboard not working as expected.

When hit a enter at chat window.

Uncaught TypeError: Cannot read properties of undefined (reading 'getUniqueId') exception appered.

换肤，换logo该怎么换呢

这样配置的形式，感觉灵活性不够

How to list rooms

Is there a way to list all active rooms from the api?

怎么解

[webpack-cli] Failed to load 'C:\Users\dell\Desktop\yuyin\CloudClass-Desktop-dev-apaas-kaikeba\packages\agora-classroom-sdk\webpack\webpack.dev.js' config
[webpack-cli] Error: Cannot find module 'agora-edu-core/package.json'

Can not import 'agora-classroom-sdk'

I want to use customized flexible classroom, so I read whole documents about Flexible classroom.

I alerady understand about which components can be customized. (concepts about open source and closed source)

On 'Integrate Flexible Classroom into Your App', the document said that If I want to integrate Flexible Classroom through npm, import agora-classroom-sdk.

$ npm install agora-classroom-sdk

Is there any problems with agora-classroom-sdk on react environment?
I tested two environments (react v-17, react v-18) to use agora-classroom-sdk.
But It didn't work and make same errors on two environments.

./node_modules/agora-electron-sdk/js/Api/index.js
Module not found: Can't resolve '../../build/Release/agora_node_ext' in '.../agora-classroom-immsi/node_modules/agora-electron-sdk/js/Api'

./node_modules/agora-rdc-core/lib/agora-rdc-core.es.js
Module not found: Can't resolve '../build/Release/agora-rc-extension' in '.../agora-classroom-immsi/node_modules/agora-rdc-core/lib'

It works through CDN, (<script src="https://download.agora.io/edu-apaas/release/[email protected]"></script>)

But I want to customize UI components. So I need to use import 'agora-classroom-sdk' on my pacakage.json

"agora-classroom-sdk": "^2.6.0",

Can we use 'Flexible classroom' service by importing agora-classroom-sdk?

I just want to import my own projects and customize some layouts and color that's it.

repository URL is here