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

  • POST

Encoding

  • UTF-8

Request Parameters

Header 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

results matching ""

    No results matching ""