PrevNext
search by keyword

Recent Pages

Documentation
Documentation

Data Types

Last updated: 2021-11-09 10:14:16

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, StartMCUMixTranscodeByStrRoomId.

Name Type Required Description
AudioSampleRate Integer Yes Output audio sample rate (Hz) for On-Cloud MixTranscoding. Valid values: 48000, 44100, 32000, 24000, 16000, 8000
AudioBitrate Integer Yes Output audio bitrate (Kbps) for On-Cloud MixTranscoding. Value range: 8-500
AudioChannels Integer Yes Number of sound channels of output stream for On-Cloud MixTranscoding. Valid values: 1, 2. 1 represents mono-channel, and 2 represents dual-channel.
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 bitrate (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 in FPS. This parameter is required for audio/video outputs. Value range: [1, 60].
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 background color for On-Cloud MixTranscoding. Valid values: decimal integers. Commonly used colors include:
Red: 0xff0000, whose decimal number is 16724736
Yellow: 0xffff00, whose decimal number is 16776960
Green: 0x33cc00, whose decimal number is 3394560
Blue: 0x0066ff, whose decimal number is 26367
Black: 0x000000, whose decimal number is 0
White: 0xFFFFFF, whose decimal number is 16777215
Grey: 0x999999, whose decimal number is 10066329
BackgroundImageId Integer No Output stream background image for stream mix. Its value is the ID of image uploaded through the TRTC Console.
AudioCodec Integer No Output audio codec for On-Cloud MixTranscoding. Valid values: 0, 1, 2. 0 (default): LC-AAC; 1: HE-AAC; 2: HE-AACv2. If this parameter is set to 2 (HE-AACv2), On-Cloud MixTranscoding can produce only dual-channel streams. If it is set to 1 (HE-AAC) or 2 (HE-AACv2), the valid values for the audio sample rate of output streams are 48000, 44100, 32000, 24000, and 16000.
BackgroundImageUrl String No URL of the background image for the mixed stream, which can be in PNG, JPG, JPEG, or BMP format and does not support the alpha channel. The URL must not exceed 512 bytes. When both BackgroundImageUrl and BackgroundImageId are specified, the former will be used. The background image must not exceed 10 MB.

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, StartMCUMixTranscodeByStrRoomId.

Name Type Required Description
Template Integer No On-cloud stream mix layout template ID. 0: floating template (default value); 1: grid template; 2: screen sharing template; 3: picture-in-picture template; 4: custom template.
MainVideoUserId String No ID of the user in the big image, which takes effect in a screen sharing, floating, or picture-in-picture template.
MainVideoStreamType Integer No Stream type of the big image, which takes effect in a screen sharing, floating, or picture-in-picture 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 Layout parameter of the small image, which takes effect in a picture-in-picture template.
MainVideoRightAlign Integer No You can set the layout parameter as 1 or 0 in the screen sharing template. 1: big image on the right and small images on the left, 0: big image on the left and small images on the right. The default value is 0.
MixVideoUids Array of String No A user list, which takes effect for floating, grid, or screen sharing templates. When the user list has been set, the stream mix output for users in this user list will include both audio and video; the stream mix output for users not in the list will only include audio. Up to 16 users can be set.
PresetLayoutConfig Array of PresetLayoutConfig No Valid in custom template, used to specify the video image position of a user in mixed streams.
PlaceHolderMode Integer No Valid in custom templates. 1: the placeholding feature is enabled; 0 (default): the feature is disabled. When the feature is enabled, but a user for whom a position is reserved is not sending video data, the position will show the corresponding placeholder image.
PureAudioHoldPlaceMode Integer No Whether an audio-only stream occupies an image spot, which takes effect in a floating, grid, or screen sharing template. Valid values: 0 (default): when a floating or grid template is used, users sending audio only occupy image spots; when a screen sharing template is used, users (except the user whose screen is shared) sending audio only do not occupy image spots; 1: users sending audio only occupy image spots; 2: users sending audio only do not occupy image spots.
WaterMarkParams WaterMarkParams No Watermark parameters

OneSdkAppIdTranscodeTimeUsagesInfo

Relaying and transcoding duration statistics

Used by actions: DescribeTrtcMcuTranscodeTime.

Name Type Description
SdkAppIdTranscodeTimeUsages Array of SdkAppIdTrtcMcuTranscodeTimeUsage Array of relaying and transcoding durations
TotalNum Integer Number of records returned
SdkAppId String ID of the application queried. Its value may be an application ID or total, which indicates that the total durations of all applications are queried.

OneSdkAppIdUsagesInfo

Array of billable audio/video interaction durations of a specific application (SdkAppId) and array length

Used by actions: DescribeTrtcInteractiveTime.

Name Type Description
TotalNum Integer Number of records returned for the SdkAppId
SdkAppIdTrtcTimeUsages Array of SdkAppIdTrtcUsage Array of durations
SdkAppId String Application ID

OutputParams

MCU On-Cloud MixTranscoding output parameters

Used by actions: StartMCUMixTranscode, StartMCUMixTranscodeByStrRoomId.

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 Prefix of custom recording file names. Please enable the recording feature in the TRTC console first. https://intl.cloud.tencent.com/document/product/647/50768?from_cn_redirect=1
RecordAudioOnly Integer No Whether to record audio only. Valid values: 0, 1. 0: no meaning; 1: records into MP3 files. This parameter is not recommended. Instead, you are advised to create an audio-only recording template in the TRTC console.

PictureInfo

Image information list

Used by actions: DescribePicture.

Name Type Description
Height Integer Image height
Width Integer Image width
XPosition Integer X-axis value of the image’s position
YPosition Integer Y-axis value of the image’s position
SdkAppId Integer Application ID
PictureId Integer Image ID

PresetLayoutConfig

Valid in custom template, used to specify the video image position of a user in mixed streams.

Used by actions: StartMCUMixTranscode, StartMCUMixTranscodeByStrRoomId.

Name Type Required Description
UserId String No Used to assign users to preset positions; if not assigned, users will occupy the positions set in PresetLayoutConfig in room entry sequence.
StreamType Integer No Stream type of the user when a specified user is assigned to the image. 0: camera; 1: screen sharing. Set this parameter to 0 when the small image is occupied by a web user.
ImageWidth Integer No Width of the output image in pixels. If this parameter is not set, 0 is used by default.
ImageHeight Integer No Height of the output image in pixels. If this parameter is not set, 0 is used by default.
LocationX Integer No X offset of the output image in pixels. The sum of LocationX and ImageWidth cannot exceed the total width of the mixed stream. If this parameter is not set, 0 is used by default.
LocationY Integer No Y offset of the output image in pixels. The sum of LocationY and ImageHeight cannot exceed the total height of the mixed stream. If this parameter is not set, 0 is used by default.
ZOrder Integer No Output order of the image. 0 is used if it is left empty.
RenderMode Integer No Render mode of the output image. 0: cropping; 1: scaling; 2: scaling on a black background. If this parameter is not set, 0 is used by default.
MixInputType Integer No Media type of the mixed stream of the user occupying the current position. 0 (default): audio and video; 1: audio; 2: video. You are advised to specify a user ID when using this parameter.
PlaceImageId Integer No ID of the placeholder image. If the placeholding feature is enabled, and a user for whom an image position is reserved is not sending video data, the position will show the placeholder image. The ID is generated after the placeholder image is uploaded in the TRTC console. https://intl.cloud.tencent.com/document/product/647/50769?from_cn_redirect=1

PublishCdnParams

Relayed push parameters of a non-Tencent Cloud CDN

Used by actions: StartMCUMixTranscode, StartMCUMixTranscodeByStrRoomId.

Name Type Required Description
BizId Integer Yes Tencent Cloud LVB BizId
PublishCdnUrls Array of String Yes Destination of non-Tencent Cloud CDN relayed push. It is possible to push to only one non-Tencent Cloud CDN address at a time.

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

RecordUsage

Recording duration statistics

Used by actions: DescribeRecordStatistic.

Name Type Description
TimeKey String Time point for the statistics, e.g., 2020-09-07 or 2020-09-07 00:05:05
Class1VideoTime Integer SD video duration (s)
Class2VideoTime Integer HD video duration (s)
Class3VideoTime Integer FHD video duration (s)
AudioTime Integer Audio duration (s)

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.

SdkAppIdRecordUsage

Recording duration statistics of a specific application (SdkAppId)

Used by actions: DescribeRecordStatistic.

Name Type Description
SdkAppId String Application ID
Usages Array of RecordUsage Durations for the period queried

SdkAppIdTrtcMcuTranscodeTimeUsage

Billable relaying and transcoding duration statistics
If the period queried is 1 day or shorter, the statistics returned are on a 5-minute basis. If the period queried is longer than 1 day, the statistics returned are on a daily basis.

Used by actions: DescribeTrtcMcuTranscodeTime.

Name Type Description
TimeKey String Time point for the statistics. e.g., 2020-09-07 or 2020-09-07 00:05:05
AudioTime Integer Audio duration (s)
VideoTimeSd Integer SD video duration (s)
VideoTimeHd Integer HD video duration (s)
VideoTimeFhd Integer FHD video duration (s)

SdkAppIdTrtcUsage

Audio/Video interaction duration statistics
If the period queried is 1 day or shorter, the statistics returned are on a 5-minute basis. If the period queried is longer than 1 day, the statistics returned are on a daily basis.

Used by actions: DescribeTrtcInteractiveTime.

Name Type Description
TimeKey String Time point for the statistics. e.g., 2020-09-07 or 2020-09-07 00:05:05
AudioTime Integer Audio duration (s)
AudioVideoTime Integer Audio/Video duration (s)
This parameter is returned only for users who signed up before October 11, 2019 and have not switched to the new billing standards.
VideoTimeSd Integer SD video duration (s)
VideoTimeHd Integer HD video duration (s)
VideoTimeHdp Integer FHD video duration (s)

SmallVideoLayoutParams

Layout parameter of the small image, which takes effect in a picture-in-picture template

Used by actions: StartMCUMixTranscode, StartMCUMixTranscodeByStrRoomId.

Name Type Required Description
UserId String Yes ID of the user in the small image.
StreamType Integer Yes Stream type of the small image. 0: camera; 1: screen sharing. If a web user's stream is displayed in the small image, enter 0 for this parameter.
ImageWidth Integer No Output width of the small image in pixels. If this parameter is left empty, 0 will be used by default.
ImageHeight Integer No Output height of the small image in pixels. If this parameter is left empty, 0 will be used by default.
LocationX Integer No Output X-axis offset of the small image in pixels. The sum of LocationX and ImageWidth cannot exceed the total width of the output mixed stream. If this parameter is left empty, 0 will be used by default.
LocationY Integer No Output Y-axis offset of the small image in pixels. The sum of LocationY and ImageHeight cannot exceed the total height of the output mixed stream. If this parameter is left empty, 0 will be used by default.

TimeValue

Returned quality data in the format of time:value

Used by actions: DescribeCallDetail.

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

User information, including when the user enters/exits a room

Used by actions: DescribeCallDetail, DescribeUserInformation.

Name Type Description
RoomStr String Room ID
UserId String User ID
JoinTs Integer The time when the user enters the room
LeaveTs Integer The time when the user exits the room. If the user is still in the room, the current time will be returned
DeviceType String Device type
SdkVersion String SDK version number
ClientIp String Client IP
Finished Boolean Determine whether a user has left the room

WaterMarkParams

Watermark parameters for On-Cloud MixTranscoding

Used by actions: StartMCUMixTranscode, StartMCUMixTranscodeByStrRoomId.

Name Type Required Description
WaterMarkId Integer Yes Image ID of the watermark, which is generated after the image is uploaded to the TRTC console
WaterMarkWidth Integer Yes Width (px) of the watermark for On-Cloud MixTranscoding
WaterMarkHeight Integer Yes Height (px) of the watermark for On-Cloud MixTranscoding
LocationX Integer Yes Horizontal offset (px) of the watermark
LocationY Integer Yes Vertical offset (px) of the watermark
WaterMarkUrl String No URL of the watermark image for the mixed stream, which can be in PNG, JPG, JPEG, or BMP format and does not support the alpha channel. The URL must not exceed 512 bytes. When both WaterMarkUrl and WaterMarkId are specified, the former will be used. The watermark image cannot exceed 10 MB.
tencent
Copyright © 2013-2021 Tencent Cloud. All Rights Reserved.
Privacy PolicyLegalCookie Policy