From 25d81339e201d83dd7caa499c277bb6f0a6503b7 Mon Sep 17 00:00:00 2001
From: atovpeko <anastasia.tovpeko@agora.io>
Date: Fri, 23 Feb 2024 12:29:07 +0200
Subject: [PATCH 1/3] release notes

---
 .../release-notes/android.mdx                  | 15 +++++++++++++++
 .../flexible-classroom/release-notes/ios.mdx   | 15 +++++++++++++++
 shared/flexible-classroom/release-notes/js.mdx | 18 ++++++++++++++++++
 3 files changed, 48 insertions(+)

diff --git a/shared/flexible-classroom/release-notes/android.mdx b/shared/flexible-classroom/release-notes/android.mdx
index e3bf102fe..56fe6ecb0 100644
--- a/shared/flexible-classroom/release-notes/android.mdx
+++ b/shared/flexible-classroom/release-notes/android.mdx
@@ -1,5 +1,20 @@
 <PlatformWrapper platform="android">
 
+## v2.8.100
+
+v2.8.00 was released on xxx, 2024
+
+#### Improvements
+
+This release optimizes the network connection by supporting the cloud proxy configurations of the RTM service.
+
+#### Issues fixed
+
+This release fixes the following issues:
+
+- The sequence compensation mechanism was abnormal.
+- The on-stage state became inaccurate after students in a lecture hall joined and left the class.
+
 ## v2.8.81
 
 v2.8.81 was released on December 14, 2023.
diff --git a/shared/flexible-classroom/release-notes/ios.mdx b/shared/flexible-classroom/release-notes/ios.mdx
index 93af11833..bd0b9b943 100644
--- a/shared/flexible-classroom/release-notes/ios.mdx
+++ b/shared/flexible-classroom/release-notes/ios.mdx
@@ -1,5 +1,20 @@
 <PlatformWrapper platform="ios">
 
+## v2.8.100
+
+v2.8.00 was released on xxx, 2024
+
+#### Improvements
+
+This release optimizes the network connection by supporting the cloud proxy configurations of the RTM service.
+
+#### Issues fixed
+
+This release fixes the following issues:
+
+- The font size displayed on the whiteboard was abnormal.
+- The on-stage state became inaccurate after students in a lecture hall joined and left the class.
+
 ## v2.8.80
 
 v2.8.80 was released on December 14, 2023.
diff --git a/shared/flexible-classroom/release-notes/js.mdx b/shared/flexible-classroom/release-notes/js.mdx
index 1781cd0f2..af82b7629 100644
--- a/shared/flexible-classroom/release-notes/js.mdx
+++ b/shared/flexible-classroom/release-notes/js.mdx
@@ -1,3 +1,21 @@
+## v2.9.40
+
+v2.9.40 was released on xxx, 2024.
+
+#### Improvements
+
+This release adds the following improvements:
+
+- Optimizes the logic of audio device selection after plugging and unplugging an external audio device.
+- Supports adjusting video profile during class.
+
+#### Issues fixed
+
+This release fixes the following issues:
+
+- The on-stage state became inaccurate after students in a lecture hall joined and left the class.
+- The video window occasionally went black during live streaming on the H5 browser.
+
 ## v2.9.20
 
 v2.9.20 was released on January 17, 2024.

From 256f22a00ee892ff9e5d7139d8f83c675a57d66d Mon Sep 17 00:00:00 2001
From: atovpeko <anastasia.tovpeko@agora.io>
Date: Wed, 28 Feb 2024 14:10:28 +0200
Subject: [PATCH 2/3] review updates

---
 .../flexible-classroom/classroom-sdk/js.mdx   | 22 ++++++-------
 .../integrate-flexible-classroom-fcr/web.mdx  | 17 ++++++----
 .../integrate-flexible-classroom/electron.mdx | 12 +++----
 .../integrate-flexible-classroom/web.mdx      | 33 ++++++++++++-------
 4 files changed, 49 insertions(+), 35 deletions(-)

diff --git a/shared/flexible-classroom/classroom-sdk/js.mdx b/shared/flexible-classroom/classroom-sdk/js.mdx
index f8de8fbde..94ee776d2 100644
--- a/shared/flexible-classroom/classroom-sdk/js.mdx
+++ b/shared/flexible-classroom/classroom-sdk/js.mdx
@@ -456,28 +456,28 @@ Classroom event listener. Set in [`LaunchOption`](#launchoption).
 | Parameter | Description |
 | :----- | :----- |
 | `Ready`|	`1`: Entered the classroom successfully.|
-| `Destroyed`|	`2`: The classroom has been destroyed.|
+| `Destroyed`|	`2`: The classroom has been destroyed. Includes the reason for leaving as a parameter: <ul><li>`1`: Left the room voluntarily.</li><li>`2`: Have been kicked out of the room.</li></ul>|
 | `FailedToJoin`|	`3`: Failed to enter the classroom.|
 | `KickOut`|	`101`: Being kicked out of the room.|
 | `TeacherTurnOnMyMic`|	`102`: Audio streaming permission is enabled.|
 | `TeacherTurnOffMyMic`|	`103`: Audio streaming permission is turned off.|
 | `UserAcceptToStage`|	`106`: Get on the podium.|
 | `UserLeaveStage`|	`107`: Leave the podium.|
-| `RewardReceived`|	`108`: Reward received.|
+| `RewardReceived`|	`108`: Reward received. Includes a list of rewarded users as a parameter.|
 | `TeacherTurnOnMyCam`|	`109`: The video streaming permission is enabled.|
 | `TeacherTurnOffMyCam`|	`110`: The video streaming permission has been turned off.|
 | `CurrentCamUnplugged`|	`111`: The current camera device is unplugged.|
 | `CurrentMicUnplugged`|	`112`: The current microphone device is unplugged.|
 | `CurrentSpeakerUnplugged`|	`113`: The current speaker is unplugged.|
 | `CaptureScreenPermissionDenied`|	`114`: No screen capture permission.|
-| `BatchRewardReceived`|	`117`: Receive bulk rewards.|
-| `InvitedToGroup`|	`118`: Receive invitation to join group.|
-| `MoveToOtherGroup`|	`119`: Moved to other groups.|
+| `BatchRewardReceived`|	`117`: Receive bulk rewards. Includes a list of rewarded users as a parameter.|
+| `InvitedToGroup`|	`118`: Receive invitation to join group. Includes group information as parameters.|
+| `MoveToOtherGroup`|	`119`: Moved to other groups. Includes the following parameters:<ul><li>Previous group</li><li>New group</li></ul>|
 | `JoinSubRoom`|	`120`: Join a group.|
 | `LeaveSubRoom`|	`121`: Leave the group.|
-| `AcceptedToGroup`|	`122`: The user accepts to join the group.|
-| `UserJoinGroup`|	`123`: Other users join the group.|
-| `UserLeaveGroup`|	`124`: Other users leave the group.|
-| `RejectedToGroup`|	`125`: The user refuses to join the group.|
-| `RTCStateChanged`|	`201`: RTC connection status change.|
-| `ClassStateChanged`|	`202`: Classroom status changes. |
+| `AcceptedToGroup`|	`122`: The user accepts to join the group. Includes the following parameters: <ul><li>Group ID</li><li>Accepting user</li></ul>|
+| `UserJoinGroup`|	`123`: Other users join the group. Includes the following parameters: <ul><li>Group ID</li><li>List of joining users</li></ul>|
+| `UserLeaveGroup`|	`124`: Other users leave the group. Includes the following parameters: <ul><li>Group ID</li><li>List of leaving users</li></ul>|
+| `RejectedToGroup`|	`125`: The user refuses to join the group. Includes the following parameters: <ul><li>Group ID</li><li>List of refusing users</li></ul>|
+| `RTCStateChanged`|	`201`: RTC connection status change. Includes the RTC connection status as a parameter: <ul><li>`0`: Not connected</li><li>`1`: Connecting</li><li>`2`: Connected</li><li>`3`: Reconnecting</li></ul>|
+| `ClassStateChanged`|	`202`: Classroom status changes. Includes the class status as a parameter: <ul><li>`0`: Started </li><li>`1`: Not started</li><li>`2`: Dragging </li><li>`3`: Ended</li></ul> |
diff --git a/shared/flexible-classroom/integrate-flexible-classroom-fcr/web.mdx b/shared/flexible-classroom/integrate-flexible-classroom-fcr/web.mdx
index e9b81db7d..6ccdd869d 100644
--- a/shared/flexible-classroom/integrate-flexible-classroom-fcr/web.mdx
+++ b/shared/flexible-classroom/integrate-flexible-classroom-fcr/web.mdx
@@ -73,9 +73,10 @@ If you are satisfied with the default UI of Cloud Classroom and do not want to c
 1. Add the following code to the HTML file in your project:
 
     ```html
-    <!-- <!-- Please replace X.Y.Z with the cloud classroom version number, such as 1.0.10.
+    <!-- <!-- Please replace X.Y.Z with the cloud classroom version number, such as 1.0.40.
     You can check the latest version number through the release notes or GitHub repository branch. -->
     <script src="https://download.agora.io/edu-apaas/release/scene_sdk@X.Y.Z.bundle.js"></script>
+    <script src="https://download.agora.io/edu-apaas/release/scene_widget@X.Y.Z.bundle.js"></script>
     ```
 
 2. To launch a classroom, call [FcrUIScene.launch](../../client-api/ui-scene#launch).
@@ -88,10 +89,10 @@ If you are satisfied with the default UI of Cloud Classroom and do not want to c
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <!-- Introduce SDK, 1.0.20 is the sample version number. You can check the latest version number through the release notes or GitHub repository branch. -->
-    <script src="https://download.agora.io/edu-apaas/release/scene_sdk@1.0.20.bundle.js"></script>
-    <!-- Introduce Widget, 1.0.20 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch -->
-    <script src="https://download.agora.io/edu-apaas/release/scene_widget@1.0.20.bundle.js"></script>
+    <!-- Introduce SDK, 1.0.40 is the sample version number. You can check the latest version number through the release notes or GitHub repository branch. -->
+    <script src="https://download.agora.io/edu-apaas/release/scene_sdk@1.0.40.bundle.js"></script>
+    <!-- Introduce Widget, 1.0.40 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch -->
+    <script src="https://download.agora.io/edu-apaas/release/scene_widget@1.0.40.bundle.js"></script>
   </head>
 
   <body>
@@ -104,7 +105,7 @@ If you are satisfied with the default UI of Cloud Classroom and do not want to c
     <div id="root"></div>
     <script type="text/javascript">
       // Start cloud classroom
-      FcrUIScene.launch(document.querySelector("#root"), {
+      const unmount = FcrUIScene.launch(document.querySelector("#root"), {
         appId: "Your App ID",
         region: "NA",
         userUuid: "user id",
@@ -135,6 +136,10 @@ If you are satisfied with the default UI of Cloud Classroom and do not want to c
 
 The sample code requires passing in `rtmToken`. You can refer to [Generate a <Vg k="MESS" /> token](../get-started/manage-agora-account#generate-an-rtm-token) to learn what a <Vg k="MESS" /> token is, how to get a temporary <Vg k="MESS" /> token for testing purposes, and how to generate a <Vg k="MESS" /> token from the server. The generated token passed in `userId` must be consistent with the `userUuid` parameters passed in the `launch` method; otherwise, the generated token will be invalid.
 
+<Admonition type="info" title="Note">
+Calling `launch` returns `unmount`. When your App routing changes cause the unloading of a page, call `unmount` to disconnect the room and recycle resources.
+</Admonition>
+
 ### Customize the classroom UI
 
 If you want to customize the classroom UI based on the default UI of Cloud Classroom, you need to integrate  by downloading the source code on GitHub. Refer to the following steps:
diff --git a/shared/flexible-classroom/integrate-flexible-classroom/electron.mdx b/shared/flexible-classroom/integrate-flexible-classroom/electron.mdx
index 9143685f7..d1f9ccb84 100644
--- a/shared/flexible-classroom/integrate-flexible-classroom/electron.mdx
+++ b/shared/flexible-classroom/integrate-flexible-classroom/electron.mdx
@@ -67,10 +67,10 @@ To integrate the whole <Vg k="FC"/> through CDN if you're satisfied with the def
     <head>
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <!-- Introduce the SDK, 2.9.20 is the sample version number, you can check the latest version number through the release notes or GitHub warehouse branch -->
-        <script src="https://download.agora.io/edu-apaas/release/edu_sdk@2.9.20.bundle.js"></script>
-        <!-- Introducing Widget, 2.9.20 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch. (Widgets before 2.9.20 are packaged together with the SDK, and there is no need to introduce this library) -->
-        <script src="https://download.agora.io/edu-apaas/release/edu_widget@2.9.20.bundle.js"></script>
+        <!-- Introduce the SDK, 2.9.40 is the sample version number, you can check the latest version number through the release notes or GitHub warehouse branch -->
+        <script src="https://download.agora.io/edu-apaas/release/edu_sdk@2.9.40.bundle.js"></script>
+        <!-- Introducing Widget, 2.9.40 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch. (Widgets before 2.9.20 are packaged together with the SDK, and there is no need to introduce this library) -->
+        <script src="https://download.agora.io/edu-apaas/release/edu_widget@2.9.40.bundle.js"></script>
     </head>
     <body>
         <style>
@@ -141,10 +141,10 @@ If you want to customize the classroom UI based on the default UI of <Vg k="FC"/
 
 1. Switch to the latest branch.
 
-    For example, if you want to switch to the branch of v2.9.20, just run the following command:
+    For example, if you want to switch to the branch of v2.9.40, just run the following command:
 
     ```bash
-    git checkout release/2.9.20
+    git checkout release/2.9.40
     ```
 
    Agora recommends switching the branch to the latest release.
diff --git a/shared/flexible-classroom/integrate-flexible-classroom/web.mdx b/shared/flexible-classroom/integrate-flexible-classroom/web.mdx
index f3c4b54d8..12465f4a9 100644
--- a/shared/flexible-classroom/integrate-flexible-classroom/web.mdx
+++ b/shared/flexible-classroom/integrate-flexible-classroom/web.mdx
@@ -85,9 +85,10 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
 1. Add the following code to the HTML file in your project:
 
     ```html
-    <!-- Replace X.Y.Z with the Flexible Classroom version number, such as 2.9.20.
+    <!-- Replace X.Y.Z with the Flexible Classroom version number, such as 2.9.40.
     You can check the latest version number through the release notes or GitHub repository branch. -->
     <script src="https://download.agora.io/edu-apaas/release/edu_sdk@X.Y.Z.bundle.js"></script>
+    <script src="https://download.agora.io/edu-apaas/release/edu_widget@X.Y.Z.bundle.js"></script>
     ```
 
 2. To launch a classroom, call [AgoraEduSDK.config](../../client-api/classroom-sdk#config) and [AgoraEduSDK.launch](../../reference/classroom-sdk#launch) in the JavaScript code of the project.
@@ -100,10 +101,10 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
 <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <!-- Introducing SDK, 2.9.20 is the sample version number, you can check the latest version number through the release notes or GitHub warehouse branch  -->
-    <script src="https://download.agora.io/edu-apaas/release/edu_sdk@2.9.20.bundle.js"></script>
-    <!-- Introducing Widget, 2.9.20 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch. (Widgets before 2.9.20 are packaged together with the SDK, and there is no need to introduce this library) -->
-    <script src="https://download.agora.io/edu-apaas/release/edu_widget@2.9.20.bundle.js"></script>
+    <!-- Introducing SDK, 2.9.40 is the sample version number, you can check the latest version number through the release notes or GitHub warehouse branch  -->
+    <script src="https://download.agora.io/edu-apaas/release/edu_sdk@2.9.40.bundle.js"></script>
+    <!-- Introducing Widget, 2.9.40 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch. (Widgets before 2.9.0 are packaged together with the SDK, and there is no need to introduce this library) -->
+    <script src="https://download.agora.io/edu-apaas/release/edu_widget@2.9.40.bundle.js"></script>
 </head>
 <body>
     <style>
@@ -121,7 +122,7 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
                 region: 'NA'
         });
         // Start online classroom
-        AgoraEduSDK.launch(document.querySelector('#root'), {
+        const unmount = AgoraEduSDK.launch(document.querySelector("#root"), {
             userUuid: 'user id',
             userName: 'user name',
             roomUuid: 'room id',
@@ -159,6 +160,10 @@ The sample code requires passing in `rtmToken`. You can refer to [Generate a <Vg
 
 For details on the values of other parameters, see [LaunchOption](../../client-api/classroom-sdk#launchoption).
 
+<Admonition type="info" title="Note">
+Calling `launch` returns `unmount`. When your App routing changes cause the unloading of a page, call `unmount` to disconnect the room and recycle resources.
+</Admonition>
+
 <a name="change_default_ui_education"></a>
 ### Customize the classroom UI
 
@@ -249,7 +254,7 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
 1. Add the following code to the HTML file in your project:
 
     ```html
-    <!-- Replace X.Y.Z with the Flexible Classroom version number.
+    <!-- Replace X.Y.Z with the Flexible Classroom version number. For example, 1.0.40
     You can check the latest version number through the release notes or the GitHub repository branch. -->
     <script src="https://download.agora.io/edu-apaas/release/proctor_sdk@X.Y.Z.bundle.js"></script>
     ```
@@ -264,10 +269,10 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <!-- Introduce SDK, 1.0.10 is the sample version number. You can check the latest version number through the release notes or GitHub repository branch. -->
-    <script src="https://download.agora.io/edu-apaas/release/proctor_sdk@1.0.10.bundle.js"></script>
-    <!-- Introducing Widget, 1.0.10 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch. (Widgets before 1.0.10 are packaged together with the SDK, so there is no need to introduce this library) -->
-    <script src="https://download.agora.io/edu-apaas/release/proctor_widget@1.0.10.bundle.js"></script>
+    <!-- Introduce SDK, 1.0.40 is the sample version number. You can check the latest version number through the release notes or GitHub repository branch. -->
+    <script src="https://download.agora.io/edu-apaas/release/proctor_sdk@1.0.40.bundle.js"></script>
+    <!-- Introducing Widget, 1.0.40 is the sample version number. You can check the latest version number through the release notes or GitHub warehouse branch. (Widgets before 1.0.10 are packaged together with the SDK, so there is no need to introduce this library) -->
+    <script src="https://download.agora.io/edu-apaas/release/proctor_widget@1.0.40.bundle.js"></script>
   </head>
 
   <body>
@@ -286,7 +291,7 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
         region: "NA",
       });
       // Start online proctoring
-      AgoraProctorSDK.launch(document.querySelector("#root"), {
+      const unmount = AgoraProctorSDK.launch(document.querySelector("#root"), {
         userUuid: "user id", // Refer to the description below to fill in userUuid
         userName: "user name",
         roomUuid: "room id",
@@ -308,6 +313,10 @@ If you are satisfied with the default UI of <Vg k="FC"/> and do not want to chan
 </html>
 ```
 
+<Admonition type="info" title="Note">
+Calling `launch` returns `unmount`. When your App routing changes cause the unloading of a page, call `unmount` to disconnect the room and recycle resources.
+</Admonition>
+
 When being proctored online, students need to use the primary and secondary devices to access the exam. For example, the main device is a Web client used to collect students' videos and share their screens when they answer questions; the secondary device is an Android or iOS device used to capture students' bodies when they answer questions. The proctor observes students answering questions through videos from several points to prevent cheating. You need to fill in the `userUuid` on different devices. For example, for student A, pass it in the `AgoraProctorSDK.launch` parameter on the Web side, and then on the Android or iOS side. Flexible Classroom will identify them as student A's primary and secondary devices, merge their video streams, and render the merged video images in the teacher's proctoring video window.
 
 The sample code requires passing in `rtmToken`. You can refer to [Generate a <Vg k="MESS" /> token](../get-started/manage-agora-account#generate-an-rtm-token) to learn what a <Vg k="MESS" /> token is, how to get a temporary <Vg k="MESS" /> token for testing purposes, and how to generate a <Vg k="MESS" /> token from the server.  The generated token passed in `userId` must be consistent with the `launch` parameters passed in the `userUuid` method; otherwise, the generated token will be invalid.

From 6f13c36a1d6f14461cf10d3a864202f55680cfda Mon Sep 17 00:00:00 2001
From: atovpeko <anastasia.tovpeko@agora.io>
Date: Wed, 6 Mar 2024 13:09:55 +0200
Subject: [PATCH 3/3] release date

---
 shared/flexible-classroom/release-notes/android.mdx | 2 +-
 shared/flexible-classroom/release-notes/ios.mdx     | 2 +-
 shared/flexible-classroom/release-notes/js.mdx      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/shared/flexible-classroom/release-notes/android.mdx b/shared/flexible-classroom/release-notes/android.mdx
index 56fe6ecb0..99de84cb8 100644
--- a/shared/flexible-classroom/release-notes/android.mdx
+++ b/shared/flexible-classroom/release-notes/android.mdx
@@ -2,7 +2,7 @@
 
 ## v2.8.100
 
-v2.8.00 was released on xxx, 2024
+v2.8.00 was released on March 6, 2024
 
 #### Improvements
 
diff --git a/shared/flexible-classroom/release-notes/ios.mdx b/shared/flexible-classroom/release-notes/ios.mdx
index bd0b9b943..ee2c4f63a 100644
--- a/shared/flexible-classroom/release-notes/ios.mdx
+++ b/shared/flexible-classroom/release-notes/ios.mdx
@@ -2,7 +2,7 @@
 
 ## v2.8.100
 
-v2.8.00 was released on xxx, 2024
+v2.8.00 was released on March 6, 2024
 
 #### Improvements
 
diff --git a/shared/flexible-classroom/release-notes/js.mdx b/shared/flexible-classroom/release-notes/js.mdx
index af82b7629..73428df4a 100644
--- a/shared/flexible-classroom/release-notes/js.mdx
+++ b/shared/flexible-classroom/release-notes/js.mdx
@@ -1,6 +1,6 @@
 ## v2.9.40
 
-v2.9.40 was released on xxx, 2024.
+v2.9.40 was released on March 6, 2024.
 
 #### Improvements