Updated on 2022-09-26 GMT+08:00

Pushing Meeting Media Quality

You can monitor the quality of service (QoS) of each participant in an MCU meeting by subscribing to the NetConditionNotify event. The following figure shows the metrics that can be monitored.

Figure 1 MCU meeting QoS metrics
Table 1 Message frame for pushing meeting media quality

Parameter

Type

Description

action

String

"NetConditionNotify"

version

Long

For a full message, the value is the timestamp (in milliseconds) when the message is generated.

For an incremental message, the value is a sequence number in ascending order.

createTime

Long

Timestamp when a message is generated, in milliseconds.

msgID

String

Unique message ID.

msgMode

Integer

Message mode.

0: full message.

1: incremental message.

confID

String

ID of the subscribed-to meeting.

data

Array of NetConditionNotifyDTO objects

Media quality.

Table 2 NetConditionNotifyDTO data structure

Parameter

Type

Description

participantID

String

Unique participant identifier.

mode

Integer

0: Refresh the participant information.

1: Remove the participant.

netInfo

String

Quality rating information of the transport network.

  • good: The network quality is normal.
  • poor: The network quality is poor.

delay

String

Network round-trip time (RTT), in milliseconds.

jitter

String

Network jitter between when the video is sent from the terminal and when it is received on the server, in milliseconds.

outJitter

String

Network jitter between when the video is sent from the server and when it is received on the terminal, in milliseconds.

audioCodecType

String

Audio codec. Value: AACLD

videoCodecType

String

Video codec. Value: H264HP

fluxIn

String

Audio traffic from the server to the terminal. Unit: 100 bit/s.

fluxOut

String

Audio traffic from the terminal to the server. Unit: 100 bit/s.

lostPacketRate

String

Audio packet loss rate from the terminal to the server. The unit is 0.01%. For example, 1000 indicates that the packet loss rate is 10%.

audioOutLossPacketRate

String

Audio packet loss rate from the server to the terminal. The unit is 0.01%. For example, 1000 indicates that the packet loss rate is 10%.

bandwidth

Integer

Negotiated video bandwidth. Unit: 100 bit/s.

videoFluxIn

String

Video traffic from the server to the terminal. Unit: 100 bit/s.

videoFluxOut

String

Video traffic sent from the terminal to the server. Unit: 100 bit/s.

videoInLossPacketRate

String

Video packet loss rate from the terminal to the server. The unit is 0.01%. For example, 1000 indicates that the packet loss rate is 10%.

videoOutLossPacketRate

String

Video packet loss rate from the server to the terminal. The unit is 0.01%. For example, 1000 indicates that the packet loss rate is 10%.

assistVideoFluxIn

String

Presentation traffic from the server to the terminal. Currently, only video is available for presentation. Unit: 100 bit/s.

assistVideoFluxOut

String

Presentation traffic from the terminal to the server. Currently, only video is available for presentation. Unit: 100 bit/s.

assistVideoInLossPacketRate

String

Presentation packet loss rate from the terminal to the server. Currently, the presentation contains only video. The unit is 0.01%. For example, 1000 indicates that the packet loss rate is 10%.

assistVideoOutLossPacketRate

String

Presentation packet loss rate from the server to the terminal. Currently, the presentation contains only video. The unit is 0.01%. For example, 1000 indicates that the packet loss rate is 10%.

Example of Pushing Meeting Media Quality

{
	"data": [{
		"mode": 0,
		"participantID": "uzr571a9brwu11cvcibvru5a7r7rryiy",
		"netInfo": "good",
		"lostPacketRate": "0",
		"delay": "37",
		"jitter": "0",
		"fluxIn": "2",
		"fluxOut": "2",
		"audioOutLossPacketRate": "0",
		"videoInLossPacketRate": "0",
		"videoOutLossPacketRate": "0",
		"assistVideoInLossPacketRate": "0",
		"assistVideoOutLossPacketRate": "0",
		"outJitter": "0",
		"videoFluxIn": "0",
		"videoFluxOut": "0",
		"assistVideoFluxIn": "0",
		"assistVideoFluxOut": "0",
		"bandwidth": 61440,
		"audioCodecType": "AACLD",
		"videoCodecType": "H264HP"
	}],
	"confID": "900487914",
	"msgID": "244720b162d111eb980a6b11e9b06158",
	"msgMode": 1,
	"version": 39,
	"createTime": 1611993596126,
	"action": "NetConditionNotify"
}