Set Classroom Webcast Parameters
This interface is used to modify the web live streaming and playback-related parameters of an LMS classroom.
Notes
- Either
classId or activityId must be provided; if both are present, activityId takes priority.
- At least one optional parameter (other than the identifier fields) must be included to trigger an actual update.
useCoMainRecord can only be set for dual-teacher sub-classrooms.
- Certain parameters cannot be edited within 20 minutes before class starts, during an ongoing class, or after the class has ended. See ClassIn Help Center for details.
URL
https://root_url/lms/activity/setWebcast
HTTP Request Method
Encoding
Request Parameters
| Parameter |
Type |
Required |
Description |
X-EEO-SIGN |
string |
Yes |
Signature (see Signature Rules) |
X-EEO-UID |
string |
Yes |
Institution SID |
X-EEO-TS |
string |
Yes |
Timestamp |
Content-Type |
string |
Yes |
Fixed value: application/json |
Body Parameters (JSON)
| Parameter |
Type |
Required |
Description |
courseId |
integer |
No |
Course ID |
classId |
integer |
No* |
Classroom ID. Either classId or activityId must be provided; activityId takes priority if both are present. |
activityId |
integer |
No* |
Activity ID. Either classId or activityId must be provided; activityId takes priority if both are present. |
recordState |
integer |
No |
Enable cloud recording. 0=Off, 1=On |
recordType |
integer |
No |
Cloud recording type. 0=Record classroom, 1=Record on-site, 2=Record both |
liveState |
integer |
No |
Enable web live streaming. 0=Off, 1=On |
openState |
integer |
No |
Enable web playback. 0=Off, 1=On |
useCoMainRecord |
integer |
No |
Use dual-teacher main classroom recording (only applicable to dual-teacher sub-classrooms) |
omoStationBroadcast |
integer |
No |
Enable OMO Live Session. 0=Disable, 1=Enable |
watchByLogin |
integer |
No |
Require login to watch. 0=No, 1=Yes |
watchPassword |
string |
No |
Password for watching the live stream |
allowUnloggedChat |
integer |
No |
Allow unlogged users to chat. 0=No, 1=Yes |
webcastAllForbidden |
integer |
No |
Disable all web live streaming. 0=No, 1=Yes |
liveAndPlaybackViewingSet |
integer |
No |
Live streaming and playback viewing settings |
liveAndPlaybackClassMemberState |
integer |
No |
Live streaming and playback class member state |
liveAndPlaybackUserState |
integer |
No |
Live streaming and playback user state |
liveAndPlaybackStudentUids |
array[integer] |
No |
List of student UIDs permitted to view live streaming and playback |
webcastIntroduce |
string |
No |
Web live streaming description |
customColumn |
string |
No |
Custom column content |
* Either classId or activityId must be provided. In addition, at least one other optional parameter must be included.
Response Parameters
| Parameter |
Type |
Description |
code |
integer |
Status code. 1 indicates success. |
msg |
string |
Status description |
data |
object |
Response data; may be null |
Example Request
curl --location --request POST 'https://{root_url}/lms/activity/setWebcast' \
--header 'X-EEO-SIGN: {{sign}}' \
--header 'X-EEO-UID: {{UID}}' \
--header 'X-EEO-TS: {{timeStamp}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"courseId": 414193,
"activityId": 25096094,
"recordState": 1,
"recordType": 0,
"liveState": 1,
"openState": 1,
"watchByLogin": 0,
"webcastIntroduce": "Course introduction for this live session"
}'
Example Response
Success
{
"code": 1,
"msg": "Execution successful",
"data": null
}
Failure
{
"code": 121601009,
"msg": "Institution does not have live streaming permission",
"data": null
}
Error Codes
General Error Codes
| Error Code |
Description |
101001001 |
Parameter error |
101002005 |
Signature exception |
101002006 |
Timestamp expired |
101002008 |
Timestamp does not exist |
Business Error Codes
| Error Code |
Description |
104 |
Unknown error |
145 |
The classroom activity has already ended |
350 |
Cannot modify classroom parameters within 20 minutes before class starts |
121601005 |
Web live streaming not supported |
121601006 |
On-site recording not supported |
121601009 |
Institution does not have live streaming permission |
121601010 |
Institution does not have cloud recording permission |
121601031 |
Classroom does not belong to this institution |
121601045 |
Classroom has been deleted |
121604007 |
OMO Live Session setting not supported |
121604008 |
useCoMainRecord is not supported for non-dual-teacher sub-classrooms |
122301037 |
Recording and live streaming parameters do not match |