StartMediaRenderingTracing
开启视频帧渲染数据打点。
public abstract int StartMediaRenderingTracing();
详情
成功调用该方法后,SDK 会以调用该方法的时刻作为起点,并通过 OnVideoRenderingTracingResult 回调报告视频帧渲染的相关信息。
注:
- SDK 默认在成功加入频道的时刻起打点,自动开始跟踪视频频的渲染事件。你可以根据实际业务场景,在合适的时机调用该方法,进行自定义打点。
- 离开当前频道后,SDK 会自动重置该时间点为下一次成功加入频道的时刻。
适用场景
声网推荐你将该方法和 app 中的 UI 设置(按钮、滑动条等)结合使用,用于针对终端用户的体验改进。例如:在终端用户在点击 加入频道
按钮的时刻调用该方法进行打点,然后通过 OnVideoRenderingTracingResult 回调获取视频帧渲染过程中的指标,从而针对指标进行专项优化。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
- -7: IRtcEngine 尚未初始化就调用方法。