tencent cloud

All product documents
Low-code Interactive Classroom
Data Types
Last updated: 2025-03-07 18:51:43
Data Types
Last updated: 2025-03-07 18:51:43

AnswerInfo

The answer to a quiz question.

Used by actions: DescribeAnswerList.

Name Type Description
Name String The username.
Answer Integer The answer. Bits are used to indicate the options chosen. For example, 0x1 indicates that option A is chosen; 0x11 indicates that A and B are chosen, and so on.
CostTime Integer The time used.
UserId String The user ID.
IsCorrect Integer Whether the answer is correct. 1: Correct; 0: Incorrect.

AnswerStat

The statistics for each type of answer.

Used by actions: DescribeQuestionList.

Name Type Description
Answer Integer The answer. Bits are used to indicate the options chosen. For example, 0x1 indicates that option A is chosen; 0x11 indicates that A and B are chosen, and so on.
Count Integer The number of users that submitted the answer.

AppCustomContent

Custom application content
Used by actions: SetAppCustomContent.

Used by actions: SetAppCustomContent.

Name Type Required Description
Scene String Yes Multiple scenarios can be set for an application.
LogoUrl String No Logo URL
HomeUrl String No Homepage URL, which can be used for redirection
JsUrl String No Custom JS URL
CssUrl String No Custom CSS URL

BackgroundPictureConfig

Background image settings.

Used by actions: GetWatermark.

Name Type Description
Url String The URL of the background image.
Note: This field may return null, indicating that no valid values can be obtained.

BatchUserInfo

The information of registered users.
Used by actions: BatchRegister.

Used by actions: BatchRegister.

Name Type Description
SdkAppId Integer The SDKAppID assigned by LCIC.
UserId String
Note: This field may return null, indicating that no valid values can be obtained.
OriginId String
Note: This field may return null, indicating that no valid values can be obtained.

BatchUserRequest

The information of the users to register.
Used by actions: BatchRegister.

Used by actions: BatchRegister.

Name Type Required Description
SdkAppId Integer Yes The SDKAppID assigned by LCIC. Note: This field may return null, indicating that no valid values can be obtained.
Name String No The username. Note: This field may return null, indicating that no valid values can be obtained.
OriginId String No The user’s ID in your system, which must be unique across the same application. Note: This field may return null, indicating that no valid values can be obtained.
Avatar String No The user’s profile photo. Note: This field may return null, indicating that no valid values can be obtained.

CustomMsgContent

Used by actions: GetRoomMessage.

Name Type Required Description
Data String No Custom message data.
Desc String No Customize the message description information.
Ext String No Extended Fields

DocumentInfo

Document Information.
Used by actions: DescribeDocumentsByRoom.

Used by actions: BatchDescribeDocument, DescribeDocuments, DescribeDocumentsByRoom.

Name Type Description
DocumentId String The document ID. Note: This field may return null, indicating that no valid values can be obtained.
DocumentUrl String The document's original URL. Note: This field may return null, indicating that no valid values can be obtained.
DocumentName String The document title. Note: This field may return null, indicating that no valid values can be obtained.
Owner String The user ID of the document's owner. Note: This field may return null, indicating that no valid values can be obtained.
SdkAppId Integer The application ID. Note: This field may return null, indicating that no valid values can be obtained.
Permission Integer The document access type. 0: Private; 1: Public. Note: This field may return null, indicating that no valid values can be obtained.
TranscodeResult String The transcoding result. If the file is not transcoded, this parameter will be empty. If it is successfully transcoded, this parameter will be the URL of the transcoded file. If transcoding fails, this parameter will indicate the error code. Note: This field may return null, indicating that no valid values can be obtained.
TranscodeType Integer The transcoding type. Note: This field may return null, indicating that no valid values can be obtained.
TranscodeProgress Integer The transcoding progress. Value range: 0-100. Note: This field may return null, indicating that no valid values can be obtained.
TranscodeState Integer The transcoding status. 0: The file is not transcoded. 1: The file is being transcoded. 2: Transcoding failed. 3: Transcoding is successful. Note: This field may return null, indicating that no valid values can be obtained.
TranscodeInfo String The error message for failed transcoding. Note: This field may return null, indicating that no valid values can be obtained.
DocumentType String The document type. Note: This field may return null, indicating that no valid values can be obtained.
DocumentSize Integer The document size (bytes). Note: This field may return null, indicating that no valid values can be obtained.
UpdateTime Integer The time (Unix timestamp) when the document was last updated. Note: This field may return null, indicating that no valid values can be obtained.
Pages Integer The number of pages.
Note: This field may return null, indicating that no valid values can be obtained.
Width Integer The width. This parameter is valid only if static document transcoding is used.
Note: This field may return null, indicating that no valid values can be obtained.
Height Integer The height. This parameter is valid only if static document transcoding is used.
Note: This field may return null, indicating that no valid values can be obtained.
Cover String The thumbnail. Only transcoded courseware has thumbnails.
Note: This field may return null, indicating that no valid values can be obtained.
Preview String Document preview address
Resolution String Document resolution.Note: This field may return null, indicating that no valid values can be obtained.
MinScaleResolution String Minimum resolution of a transcoded document, consistent with the parameters provided when the document is created.Note: This field may return null, indicating that no valid values can be obtained.

EventDataInfo

The information of a room event.

Used by actions: GetRoomEvent.

Name Type Description
RoomId Integer The room ID.
Note: This field may return null, indicating that no valid values can be obtained.
UserId String The ID of the user to whom the event occurred.
Note: This field may return null, indicating that no valid values can be obtained.
Device Integer User device type. 0: Unknown; 1: Windows; 2: macOS; 3: Android; 4: iOS; 5: Web; 6: Mobile webpage; 7: Wechat Mini Program.
Duration Integer Recording time. Unit: seconds
RecordSize Integer Recorded file size
RecordUrl String Recording url

EventInfo

The event information.

Used by actions: GetRoomEvent.

Name Type Description
Timestamp Integer The Unix timestamp (seconds) when the event occurred.
EventType String The event type. Valid values:
RoomStart: The class started. RoomEnd: The class ended. MemberJoin: A user joined. MemberQuit: A user left. RecordFinish: Recording is finished.
·Camera0n·: The camera is turned on.
Camera0ff: The camera is turned off.
MicOn: The mic is turned on.
MicOff: The mic is turned off.
ScreenOn: Screen sharing is enabled.
ScreenOff: Screen sharing is disabled.
VisibleOn: The page is visible.
VisibleOff: The page is invisible.
EventData EventDataInfo The details of the event, including the room ID and the user to whom the event occurred.
Note: This field may return null, indicating that no valid values can be obtained.

GroupBaseInfo

The information of the groups to create.
Used by actions: BatchCreateGroupWithMembers.

Used by actions: BatchCreateGroupWithMembers.

Name Type Required Description
GroupName String Yes The group names. Note: This field may return null, indicating that no valid values can be obtained.
TeacherId String No The user ID of the teacher. Note: This field may return null, indicating that no valid values can be obtained.

GroupInfo

The information of the groups queried.
Used by actions: DescribeGroupList.

Used by actions: DescribeGroupList.

Name Type Description
GroupId String
Note: This field may return null, indicating that no valid values can be obtained.
GroupName String
Note: This field may return null, indicating that no valid values can be obtained.
TeacherId String
Note: This field may return null, indicating that no valid values can be obtained.
GroupType Integer
Note: This field may return null, indicating that no valid values can be obtained.
SubGroupIds String
Note: This field may return null, indicating that no valid values can be obtained.

MemberRecord

Member record information
Used by actions: DescribeCurrentMemberList, DescribeRoomStatistics.

Used by actions: DescribeCurrentMemberList, DescribeRoomStatistics.

Name Type Description
UserId String User ID
UserName String Username
PresentTime Integer Online duration, in seconds
Camera Integer Whether the camera is enabled
Mic Integer Whether the mic is enabled
Silence Integer Whether the user is muted
AnswerQuestions Integer Number of questions answered by the user
HandUps Integer Number of hand raising times
FirstJoinTimestamp Integer First time that the user entered the room, in UNIX timestamp format
LastQuitTimestamp Integer Last time that the user left the room, in UNIX timestamp format
Rewords Integer Number of rewards received
IPAddress String The user's IP address.
Location String The user's location.
Device Integer The user's device type. 0: Unknown; 1: Windows; 2: macOS; 3: Android; 4: iOS; 5: Web; 6: Mobile webpage; 7: Weixin Mini Program.
PerMemberMicCount Integer The number of times a user turned their mic on.
PerMemberMessageCount Integer The number of messages sent by a user.
Role Integer The user role. 0: Student; 1: Teacher; 2: Teaching Assistant; 3: Spectator.
GroupId String The class number.
SubGroupId Array of String The sub-class number.
Note: This field may return null, indicating that no valid values can be obtained.
Stage Integer Whether the user is on the stage.
Note: This field may return null, indicating that no valid values can be obtained.
CurrentState Integer User status. 0 is not present, 1 is online, 2 is offline, 3 is kicked, 4 is permanently kicked, 5 is temporarily offline

MessageItem

The information of a message.

Used by actions: GetRoomMessage.

Name Type Description
MessageType Integer The message type. 0: Text; 1: Image.
Note: This field may return null, indicating that no valid values can be obtained.
TextMessage String The text. This parameter is valid if MessageType is 0.
Note: This field may return null, indicating that no valid values can be obtained.
ImageMessage String The image URL. This parameter is valid if MessageType is 1.
Note: This field may return null, indicating that no valid values can be obtained.
CustomMessage CustomMsgContent Customize the message content. Vaild when message type=2.

MessageList

The list of historical messages.

Used by actions: GetRoomMessage.

Name Type Description
Timestamp Integer The message timestamp.
Note: This field may return null, indicating that no valid values can be obtained.
FromAccount String The sender.
Note: This field may return null, indicating that no valid values can be obtained.
Seq Integer The message sequence, which is unique across a class. The earlier a message is sent, the lower the sequence.
Note: This field may return null, indicating that no valid values can be obtained.
MessageBody Array of MessageItem The message content.
Note: This field may return null, indicating that no valid values can be obtained.

QuestionInfo

A quiz question in a room.

Used by actions: DescribeQuestionList.

Name Type Description
QuestionId String The question ID.
QuestionContent String The question.
Duration Integer The time limit for the question. If you set this parameter to 0, there will not be a time limit.
CorrectAnswer Integer The correct answer. Bits are used to indicate the options that should be chosen. For example, 0x1 indicates option A; 0x11 indicates A and B, and so on.
AnswerStats Array of AnswerStat The statistics for each type of answer.
Note: This field may return null, indicating that no valid values can be obtained.

RoomInfo

The information of the room to create.
Used by actions: BatchCreateRoom.

Used by actions: BatchCreateRoom.

Name Type Required Description
Name String Yes The room name.
StartTime Integer Yes The room start time (Unix timestamp).
EndTime Integer Yes The room end time (Unix timestamp).
Resolution Integer Yes The resolution. Valid values: 1: SD; 2: HD; 3: FHD.
MaxMicNumber Integer Yes The maximum number of mic-on users (excluding the teacher). Value range: 0-16.
SubType String Yes The room subtype. Valid values: videodoc: Document + Video; video: Video only; coteaching: Dual-teacher.
TeacherId String No The user ID of the teacher. User IDs are returned by the user registration APIs.
AutoMic Integer No Whether to automatically turn the mic on when a user enters the room. Valid values: 0 (default): No; 1: Yes.
TurnOffMic Integer No Whether to disconnect communication after audio/video permissions are revoked. Valid values: 0 (default): Yes; 1: No.
AudioQuality Integer No Whether to enable the high audio quality mode. Valid values: 0 (default): No; 1: Yes.
DisableRecord Integer No Whether to disable auto recording. Valid values: 0 (default): No; 1: Yes. If this parameter is 0, recording will start when the class starts and stops when the class ends.
Assistants Array of String No The user IDs of the teacher assistants. User IDs are returned by the user registration APIs.
RTCAudienceNumber Integer No The number of RTC users.
AudienceType Integer No The audience type.
RecordLayout Integer No The recording layout.
GroupId String No The ID of the group to bind. Note: This field may return null, indicating that no valid values can be obtained.
EnableDirectControl Integer No Whether the students' consent is required to control their cameras/microphones.
InteractionMode Integer No Turn on focus mode. 0 Watch all character audio and video (default) 1 Watch only teachers and teaching assistants
VideoOrientation Integer No Horizontal and vertical screen. 0: Horizontal screen to open broadcast (default); 1: Vertical screen to open broadcast, currently only support mobile pure video type
IsGradingRequiredPostClass Integer No Whether the room is enabled for grading after the lesson. 0: not enabled 1: enabled
RoomType Integer No Room Type: 0 Small Classroom(default); 1 Lecture Hall(public class)
EndDelayTime Integer No Drag class time: unit minutes, 0 is unlimited (default), -1 is can't drag the class, greater than 0 is the time of dragging the class, the maximum value of 120 minutes
LiveType Integer No Live type: 0 regular (default) 1 Simulated Live
RecordLiveUrl String No Simulated Live link
EnableAutoStart Integer No Whether to start the lesson automatically: 0 not automatic lesson (default) 1 automatic lesson live_type=1 is valid
RecordBackground String No Recorded file background image, support png, jpg, jpeg, bmp format, does not support transparent channel for the time being
RecordScene String No Record customized scene, only recordlayout=9 this parameter is valid, the data content for the user-defined scene parameters, data format for the json key-value pairs, where the key-value pairs of the value for the string type.

RoomItem

The room list.

Used by actions: GetRooms.

Name Type Description
Name String The name.
Note: This field may return null, indicating that no valid values can be obtained.
RoomId Integer The room ID.
Note: This field may return null, indicating that no valid values can be obtained.
Status Integer The room status. 0: Not started; 1: Started; 2: Ended.
Note: This field may return null, indicating that no valid values can be obtained.
StartTime Integer The scheduled start time.
Note: This field may return null, indicating that no valid values can be obtained.
EndTime Integer The scheduled end time.
Note: This field may return null, indicating that no valid values can be obtained.
RealStartTime Integer The actual start time.
Note: This field may return null, indicating that no valid values can be obtained.
RealEndTime Integer The actual end time.
Note: This field may return null, indicating that no valid values can be obtained.
Resolution Integer The resolution. 1: SD.
2: HD
3: FHD
Note: This field may return null, indicating that no valid values can be obtained.
MaxRTCMember Integer The maximum number of mic-on users allowed.
Note: This field may return null, indicating that no valid values can be obtained.
ReplayUrl String The URL of the room's recording. This parameter has been deprecated. Please use RecordUrl instead.
Note: This field may return null, indicating that no valid values can be obtained.
RecordUrl String The recording URL (HTTPS), which is generated only after a room ends.
Note: This field may return null, indicating that no valid values can be obtained.
MaxMicNumber Integer The maximum number of users allowed (including teachers) in the room. The default value is 0, which indicates that no limit is set.
Note: This field may return null, indicating that no valid values can be obtained.
EnableDirectControl Integer Whether the students' consent is required to control their cameras/microphones.
Note: This field may return null, indicating that no valid value was found.
InteractionMode Integer
VideoOrientation Integer
IsGradingRequiredPostClass Integer
RoomType Integer Room Type: 0 Small Classroom(default); 1 Lecture Hall(public class)
EndDelayTime Integer
LiveType Integer
RecordLiveUrl String
EnableAutoStart Integer
RecordBackground String
RecordScene String
RecordLang String

TextMarkConfig

The watermark text.
Used by actions: GetWatermark.

Used by actions: GetWatermark.

Name Type Description
Text String The watermark text. Note: This field may return null, indicating that no valid values can be obtained.
Color String The watermark text color. Note: This field may return null, indicating that no valid values can be obtained.

UserInfo

The user information.
Used by actions: DescribeSdkAppIdUsers.

Used by actions: DescribeSdkAppIdUsers.

Name Type Description
SdkAppId Integer
Note: This field may return null, indicating that no valid values can be obtained.
UserId String
Note: This field may return null, indicating that no valid values can be obtained.
Name String
Note: This field may return null, indicating that no valid values can be obtained.
Avatar String
Note: This field may return null, indicating that no valid values can be obtained.
OriginId String User's Id in the client system

WatermarkConfig

Watermark settings.
Used by actions: GetWatermark.

Used by actions: GetWatermark.

Name Type Description
Url String The URL of the watermark image. Note: This field may return null, indicating that no valid values can be obtained.
Width Float The watermark width, which is expressed as a percentage of the video width. Note: This field may return null, indicating that no valid values can be obtained.
Height Float The watermark height, which is expressed as a percentage of the video height. Note: This field may return null, indicating that no valid values can be obtained.
LocationX Float The horizontal offset of the watermark, which is expressed as a percentage of the video width. For example, 50 indicates that the watermark will appear in the middle horizontally. Value range: 0-100. Note: This field may return null, indicating that no valid values can be obtained.
LocationY Float The vertical offset of the watermark, which is expressed as a percentage of the video width. For example, 50 indicates that the watermark will appear in the middle vertically. Value range: 0-100. Note: This field may return null, indicating that no valid values can be obtained.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support