RTCMediaEvent

RTCMediaEvent 承载一条频道的媒体事件。RTCEngine.setRtcMediaEvent(...) 设置默认频道监听器；额外频道使用 RTCChannel.setRtcMediaEvent(...)。只关心少量事件时，建议继承 RTCMediaSimpleEvent。所有回调的第一个参数都是 channel: String，用于在多频道场景中明确事件归属。

接口方法

onMediaConnected(channel)

fun onMediaConnected(channel: String)

本频道的流媒体服务器连接成功。

onRemoteVideoFrame(channel, uid, trackDesc, y, u, v, width, height, format, angle)

fun onRemoteVideoFrame(
    channel: String,
    uid: String,
    trackDesc: String,
    y: ByteArray?,
    u: ByteArray?,
    v: ByteArray?,
    width: Int,
    height: Int,
    format: Int,
    angle: Int
)

收到本频道的一帧远端视频。uid 和 trackDesc 定位远端 Track；y、u、v 为图像分量，width / height 为尺寸，format 为像素格式，angle 为旋转角度。

onLocalQualitySnapshot(channel, snapshot)

fun onLocalQualitySnapshot(channel: String, snapshot: LocalQualitySnapshot)

本频道本地网络质量与下行播放体验的同帧快照，采样完成后约每 2 秒回调一次。三个时间戳相同；详细原始统计使用 getMetric() 按需查询。字段见媒体质量。

onNetworkQualityChanged(channel, change)

fun onNetworkQualityChanged(
    channel: String,
    change: NetworkQualityChange
)

本频道收到服务端质量报告。每份报告都为上、下行各回调一次，等级未变时 trend 为 STABLE；SDK 不做跨档判定与去抖，需要时请自行去抖。回调运行在 SDK 后台线程，更新 UI 前请切换到主线程。用法见网络质量。

onVolumesReport(channel, volumes)

fun onVolumesReport(
    channel: String,
    volumes: MutableMap<UserTrackDesc, VolumeInfo>
)

本频道的音量信息。

onActiveSpeakersChanged(channel, speakers)

fun onActiveSpeakersChanged(
    channel: String,
    speakers: List<ActiveSpeakerInfo>
)

本频道的活跃说话人列表发生变化。 :::note 摄像头设备增删和运行时错误是 Engine 全局事件，已从 RTCMediaEvent 移至 RTCCameraDeviceEvent，不会因多频道而重复回调。本地视频帧与本地音频帧也分别使用独立监听器。 :::

概览

Web SDK

Android SDK

Windows SDK

Swift SDK（iOS/macOS）

iOS SDK

HarmonyOS SDK

C SDK（服务端/嵌入式）

Python SDK（服务端 AI）

服务端 API

接口方法

onMediaConnected(channel)

onRemoteVideoFrame(channel, uid, trackDesc, y, u, v, width, height, format, angle)

onLocalQualitySnapshot(channel, snapshot)

onNetworkQualityChanged(channel, change)

onVolumesReport(channel, volumes)

onActiveSpeakersChanged(channel, speakers)

​接口方法

​onMediaConnected(channel)

​onRemoteVideoFrame(channel, uid, trackDesc, y, u, v, width, height, format, angle)

​onLocalQualitySnapshot(channel, snapshot)

​onNetworkQualityChanged(channel, change)

​onVolumesReport(channel, volumes)

​onActiveSpeakersChanged(channel, speakers)

接口方法

onMediaConnected(channel)

onRemoteVideoFrame(channel, uid, trackDesc, y, u, v, width, height, format, angle)

onLocalQualitySnapshot(channel, snapshot)

onNetworkQualityChanged(channel, change)

onVolumesReport(channel, volumes)

onActiveSpeakersChanged(channel, speakers)