Data Types

Last updated: 2020-07-31 11:17:39

AbnormalEvent

Types of exception events that can cause an exceptional experience

Used by actions: DescribeAbnormalEvent.

Name Type Description
AbnormalEventId Integer Exception event ID. For specific values, please see Appendix. Exceptional Experience ID Mapping Table.
PeerId String Remote user ID. If this parameter is left empty, it indicates that the exception event is not caused by the remote user.
Note: this field may return null, indicating that no valid values can be obtained.

AbnormalExperience

Exceptional user experience and possible causes

Used by actions: DescribeAbnormalEvent.

Name Type Description
UserId String User ID
ExperienceId Integer Exceptional experience ID
RoomId String Room ID in string type
AbnormalEventList Array of AbnormalEvent Exception event array
EventTime Integer Report time of the exception event

EncodeParams

Output stream encoding parameters for MCU On-Cloud MixTranscoding

Used by actions: StartMCUMixTranscode.

Name Type Required Description
AudioSampleRate Integer Yes Output stream audio sample rate for stream mix. Valid values: 48000, 44100, 32000,24000, 22050, 16000, 12000, 11025, 8000.
AudioBitrate Integer Yes Output stream audio bitrate in Kbps for On-Cloud MixTranscoding. Value range: [8, 500].
AudioChannels Integer Yes Number of output stream audio sound channels for On-Cloud MixTranscoding. Value range: [1, 2].
VideoWidth Integer No Output stream width in pixels for On-Cloud MixTranscoding, which is required for audio/video output. Value range: [0, 1920].
VideoHeight Integer No Output stream height in pixels for On-Cloud MixTranscoding, which is required for audio/video output. Value range: [0, 1080].
VideoBitrate Integer No Output stream bitrate in Kbps for On-Cloud MixTranscoding, which is required for audio/video output. Value range: [1, 10000].
VideoFramerate Integer No Output stream frame rate for On-Cloud MixTranscoding, which is required for audio/video output. Value range: [6, 12, 15, 24, 30, 48, 60]. If the frame rate lies outside the valid value range, it will be automatically modified to a value within the range.
VideoGop Integer No Output stream GOP in seconds for On-Cloud MixTranscoding, which is required for audio/video output. Value range: [1, 5].
BackgroundColor Integer No Output stream background color for On-Cloud MixTranscoding.
BackgroundImageId Integer No Output stream background image for stream mix. Its value is the ID of image uploaded through the TRTC Console.

EventList

List of SDK or WebRTC events.

Used by actions: DescribeDetailEvent.

Name Type Description
Content Array of EventMessage Data content
PeerId String Sender userId

EventMessage

Event information, including event timestamp and event ID.

Used by actions: DescribeDetailEvent.

Name Type Description
Type Integer Video stream type:
0: non-video event;
2: big image;
3: small image;
7: relayed stream image.
Time Integer Event reporting time in the format of UNIX timestamp, such as 1589891188801ms
EventId Integer Event ID. Events divide into SDK events and WebRTC events. For more information, please see Appendix - Event ID Mapping Table at https://intl.cloud.tencent.com/document/product/647/44916?from_cn_redirect=1
ParamOne Integer First event parameter, such as video resolution width
ParamTwo Integer Second event parameter, such as video resolution height

LayoutParams

MCU On-Cloud MixTranscoding layout parameters

Used by actions: StartMCUMixTranscode.

Name Type Required Description
Template Integer No On-Cloud MixTranscoding layout template ID. 0: floating template (default value); 1: 9-grid template; 2: screen sharing template
MainVideoUserId String No ID of the user in the big image on the left, which takes effect in the screen sharing template
MainVideoStreamType Integer No Stream type of the big image on the left, which takes effect in the screen sharing template. 0: camera; 1: screen sharing. If a web user's stream is displayed in the big image on the left, enter 0 for this parameter
SmallVideoLayoutParams SmallVideoLayoutParams No

OutputParams

MCU On-Cloud MixTranscoding output parameters

Used by actions: StartMCUMixTranscode.

Name Type Required Description
StreamId String Yes Custom live stream ID, which must be different from the ID of relayed stream.
PureAudioStream Integer No Value range: [0, 1]. If it is 0, live streams are audio and video; if it is 1, live streams are only audio. Default value: 0.
RecordId String No Custom recording file name
RecordAudioOnly Integer No Value range: [0, 1]. If it is 0, the recording template configured in the console will be used; if it is 1, streams are recorded as .mp3 files.

QualityData

Quality data returned by ES

Used by actions: DescribeCallDetail.

Name Type Description
Content Array of TimeValue Data content
UserId String User ID
PeerId String Peer ID. An empty value indicates that the returned data is upstream.
DataType String Data type

RealtimeData

Returned data of seconds-level monitoring

Used by actions: DescribeRealtimeNetwork, DescribeRealtimeQuality, DescribeRealtimeScale.

Name Type Description
Content Array of TimeValue Returned data
DataType String Data type field

RoomState

Room information list

Used by actions: DescribeRoomInformation.

Name Type Description
CommId String Call ID (unique call ID)
RoomString String Room ID of string type
CreateTime Integer Room creation time
DestroyTime Integer Room termination time
IsFinished Boolean Whether the room is terminated
UserId String Room creator ID

ScaleInfomation

Historical scale information

Used by actions: DescribeHistoryScale.

Name Type Description
Time Integer Start time for each day
UserNumber Integer Number of users in room. If a user enters the room for multiple times, the user will be counted as one user.
Note: this field may return null, indicating that no valid values can be obtained.
UserCount Integer Number of room entries. Every time when a user enters the room, it will be counted as one room entry.
Note: this field may return null, indicating that no valid values can be obtained.
RoomNumbers Integer Number of rooms under sdkappid on a day
Note: this field may return null, indicating that no valid values can be obtained.

SmallVideoLayoutParams

Used by actions: StartMCUMixTranscode.

Name Type Required Description
UserId String Yes
StreamType Integer Yes
ImageWidth Integer No
ImageHeight Integer No
LocationX Integer No
LocationY Integer No

TimeValue

Returned quality data in the format of time:value

Used by actions: DescribeCallDetail, DescribeRealtimeNetwork, DescribeRealtimeQuality, DescribeRealtimeScale.

Name Type Description
Time Integer Time in the format of UNIX timestamp, such as 1590065877s.
Value Float Parameter value returned in the current time. For example, if bigvCapFps is set to 0 when the current time is 1590065877s (UNIX timestamp), the value of this parameter is 0.

UserInformation

Used by actions: DescribeCallDetail.

Name Type Description
RoomStr String
UserId String
JoinTs Integer
LeaveTs Integer
DeviceType String
SdkVersion String
ClientIp String
Finished Boolean

Was this page helpful?

Was this page helpful?

  • Not at all
  • Not very helpful
  • Somewhat helpful
  • Very helpful
  • Extremely helpful
Send Feedback
Help