This page provides the release notes for Flexible Classroom.
v2.1.0 was released on February 23, 2022.
In v2.1.0, Agora fully optimizes the internal architecture of Flexible Classroom. Compared to earlier versions, v2.1.0 has the following advantages:
Lecture Hall: Expands audience capacity up to 5,000 students, from 1,000 in the last version.
Android and iOS clients:
Redesigns contexts for better abstraction of modular features in Flexible Classroom, where each context can be controlled separately.
Refactors context APIs with the following improvements:
If you have made changes to your Flexible Classroom UI in earlier versions, in order to migrate to v2.1.0, Agora recommends you create a new project based on v2.1.0 and re-implement the UI changes. Please refer to the following Flexible Classroom v2.1.0 migration guides:
If you encounter any problem during the migration process, or need to migrate from Flexible Classroom earlier than v1.1.5, please contact email@example.com so that Agora technical support team can help.
Answer selector and polling feature
To increase engagement and enhance interactivity, v2.1.0 adds the following teaching tools:
Ability to turn the whiteboard on or off in the classroom
As of v2.1.0, Agora supports turning the whiteboard on or off in the classroom. For details, see Turn the Whiteboard on or off in the Classroom. When using the APIs for this feature, after the whiteboard is closed, developers can use Flexible Classroom UIKit or UIStore to customize their unique classroom with their desired video gallery to fill the classroom window.
Video gallery rotation
Flexible Classroom gives teachers the ability to configure the classroom settings for improved student engagement and video. The Video Gallery Rotation feature lets the teacher automatically rotate the on-stage student gallery view at a desired frequency and sequence, thus eliminating the need for the teacher to scroll or page through the class participants.
Mobile HTML5 support
As of v2.1.0, students can join a lecture hall in Flexible Classroom simply by clicking on a shared webpage link within some mobile social applications that use a web view. After joining the classroom on mobile devices, students can do the following things:
v2.1.0 makes the following improvements:
v2.1.0 fixed the following issues:
v220.127.116.11 was released on October 20, 2021.
Support for customizing the video encoding configurations
As of v18.104.22.168, developers can customize the video encoding configurations, including the width, height, frame rate, and bitrate. When calling the
launch method, developers can set the
videoEncoderConfig parameter in
mediaOptions to customize the encoding configurations for the video stream captured by a camera or the screen-sharing video stream.
The recommended video encoding configurations are as follows:
Students automatically going onto the "stage"
v22.214.171.124 adds the feature of students automatically going onto the "stage" in the Small Classroom scenario. Once the teacher or TA enables this feature, students go onto the "stage" at specified intervals.
Support for setting the latency level of a receiver
As of v126.96.36.199, developers can set the latency level of an audience member. By default, the latency level is ultra-low. Developers can set the
latencyLevel parameter in the
launch method to change the latency level:
The charges for low latency and ultra-low latency are different. For details, see the pricing page.
Support for setting whether students automatically send streams after going onto the "stage"
v188.8.131.52 allows developers to control whether students automatically send audio or video streams after they go onto the "stage". By default, students do not send audio nor video streams after they go onto the "stage". You can change the default behavior by setting the
streamState parameter when calling
Pre-class device test and local video preview
As of v184.108.40.206, Flexible Classroom adds the Media Context API to allow developers to implement the pre-class test module, with which students can check whether their camera and microphone are functioning correctly and preview how they look and sound before they join a class.
The countdown timer
v220.127.116.11 adds a countdown timer in Flexible Classroom. The teacher can find the countdown time in the toolbox and set an initial value. After the teacher clicks the start button, students see a countdown window.
Support for media device management
As of v18.104.22.168, students can control whether local cameras, microphones, and speakers are on or off during the class. Agora adds the
IDeviceHandler classes in the Agora Edu Context and provides methods and callbacks for local device control.
Teachers making notes on their shared screen
As of v22.214.171.124, teachers can make notes notes on the screen that they share with the basic whiteboard tools.
Support for custom user properties and classroom properties
As of v126.96.36.199, developers can customize properties for users and classrooms. These properties can be updated, and the updates can be monitored. For example, developers can set the profile photo as a custom user property. To support this feature, Agora makes the following changes to the Agora Edu Context:
RoomContextfor adding or updating custom classroom properties.
IRoomHandlerfor indicating the initial custom classroom properties and subsequent classroom property changes.
AgoraEduLaunchConfigfor passing in custom user properties when launching a classroom.
UserContextfor adding or updating custom user properties.
IEduUserHandlerfor indicating user property changes.
AgoraEduLaunchConfigfor setting the PPT display mode. By default, the PPT display mode is fit, which means uniformly scaling the PPT until one of its dimensions fits the boundary. Developers can change the
Retainwhen calling the
launchmethod. In this mode, if the student manually adjusts the PPT size, the client maintains this size no matter what class the student joins.
v188.8.131.52 was released on July 7, 2021.
To ensure the security during real-time audio and video transmission, v184.108.40.206 adds the
mediaOptions parameter in AgoraEduLaunchConfig for supporting media stream encryption. By default, Flexible Classroom does not encrypt the media stream. To enable media encryption, use the
mediaOptions parameter to choose an encryption mode and set the encryption key. Flexible Classroom supports the following encryption modes:
AES_128_XTS: 128-bit AES encryption, XTS mode.
AES_128_ECB: 128-bit AES encryption, ECB mode.
AES_256_XTS: 256-bit AES encryption, XTS mode.
AES_128_GCM: 128-bit AES encryption, GCM mode.
AES_256_GCM: 256-bit AES encryption, GCM mode.
v220.127.116.11 fixes the issue that the default region was not NA (North America).
v1.1.0 was released on June 18, 2021. This is the first release of Agora Flexible Classroom with the following features: