Skip to main content

说明

RTCMediaEvent 为媒体层事件回调接口。

接口方法

onMediaConnected()

方法说明:流媒体服务器连接成功回调。
参数说明:无。
返回值说明:无(Unit)。

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

方法说明:远端视频帧回调。
参数说明:
  • uidString,远端用户 ID。
  • trackDescString,轨道描述。
  • yByteArray?,Y 分量数据。
  • uByteArray?,U 分量数据。
  • vByteArray?,V 分量数据。
  • widthInt,帧宽度。
  • heightInt,帧高度。
  • formatInt,像素格式标识。
  • angleInt,帧角度。 返回值说明:无(Unit)。
本地预览帧回调已从 RTCMediaEvent 拆出,改由 RTCEngine.setRtcLocalVideoFrameEventRTCLocalVideoFrameEvent)提供,对应 onLocalVideoFrame / onLocalVideoFrameSizeChanged。原 onPreviewFrame / onPreviewRealSize 已移除。

onMediaMetric(metric)

方法说明:媒体性能指标回调,入会后每约 5 秒下发一份完整快照。
参数说明:
  • metricMediaMetric.Metric,媒体性能指标对象。字段参见 媒体质量。 返回值说明:无(Unit)。

onNetworkQualityChanged(change)

方法说明:网络质量档位变化回调。仅在质量等级发生跨档变化时触发(而非每个采样周期),内置非对称迟滞——等级下降(变差)立即回调,等级回升(变好)需连续多次采样确认后才回调;上行、下行各自独立触发,一次回调只表示一个方向的变化。适合驱动网络状态灯与弱网提示。
参数说明:
  • changeNetworkQualityChange,本次档位变化详情(方向、前后等级、趋势及触发时的完整质量报告)。字段参见 类型定义。 返回值说明:无(Unit)。
:::note 本回调在信令通道的后台线程触发,更新 UI 前请切换到主线程。用法与弱网处理示例见 网络质量。 :::

onVolumesReport(volumes)

方法说明:音量信息回调。
参数说明:
  • volumesMutableMap<UserTrackDesc, VolumeInfo>,音量映射(UserTrackDescVolumeInfo 字段参见 类型定义)。 返回值说明:无(Unit)。

onActiveSpeakersChanged(speakers)

方法说明:活跃说话人状态变化回调。
参数说明:
  • speakersList<ActiveSpeakerInfo>,当前活跃说话人列表(含 uidtrackId 与服务端量化后的音量强度 level)。字段参见 类型定义。 返回值说明:无(Unit)。

onCameraDeviceListChanged(devices)

方法说明:当前系统摄像头列表发生变化回调(如外接摄像头插拔)。
参数说明:
  • devicesList<CameraDeviceCapability>,最新的可用摄像头设备能力列表。字段参见 类型定义。 返回值说明:无(Unit)。

onCameraDeviceDisconnected(cameraId)

方法说明:指定摄像头设备与系统物理断开或不再可用时回调。
参数说明:
  • cameraIdString,断开的 Camera2 摄像头 ID。 返回值说明:无(Unit)。

onCameraDeviceError(cameraId, errorCode, message)

方法说明:指定摄像头设备在采集过程中发生运行时错误时回调。
参数说明:
  • cameraIdString,发生错误的 Camera2 摄像头 ID。
  • errorCodeInt,错误码。
  • messageString?,错误信息描述,可为 null。 返回值说明:无(Unit)。