# 视频渲染 (/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## enableInstantMediaRendering [#enableinstantmediarendering] 启用音视频帧的极速渲染。 ```cpp virtual int enableInstantMediaRendering() = 0; ``` :::info[自从] 自 v4.1.1 版本新增。 ::: 调用该方法后,SDK 会启用极速帧渲染模式,从而加快用户加入频道后首帧的渲染速度。 :::note 注: 主播和观众都需要调用该方法,才能体验音视频帧的极速渲染。如需关闭该模式,只能通过调用 [release](/zh-CN/api-reference/rtc/cpp-all-platforms/initialize#api_irtcengine_release) 销毁 [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) 对象。 ::: ### 适用场景 [#适用场景] 声网建议在直播场景中为观众开启该模式。 ### 调用时机 [#调用时机] 该方法需要在加入频道前调用。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -7:在 [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) 初始化之前调用了该方法。 ### 所属接口类 [#所属接口类] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setLocalRenderMode [1/2] [#setlocalrendermode-12] 更新本地视频画面的显示模式。 ```cpp virtual int setLocalRenderMode(media::base::RENDER_MODE_TYPE renderMode) __deprecated = 0; ``` :::error[废弃] 自 v4.0.0 版本废弃,请改用 [setLocalRenderMode [2/2]](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setlocalrendermode2)。 ::: 你可以在初始化本地视频画面后调用该方法,更新其渲染模式和镜像模式。该方法仅影响本地用户看到的视频画面,不影响发布的视频流。 :::note 注: - 请确保在调用该方法前已调用 [setupLocalVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setuplocalvideo) 初始化本地视频画面。 - 通话过程中,你可以多次调用该方法以更新本地视频画面。 ::: ### 参数 [#参数] 本地画面的显示模式。详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-rendermodetype)。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setLocalRenderMode [2/2] [#setlocalrendermode-22] 更新本地视频画面的显示模式。 ```cpp virtual int setLocalRenderMode(media::base::RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; ``` 你可以在初始化本地视频画面后调用该方法,更新其渲染模式和镜像模式。该方法仅影响本地用户看到的视频画面,不影响本地视频的发布。 :::note 注: `setLocalRenderMode` 仅对主摄像头(`PRIMARY_CAMERA_SOURCE`)生效。在使用自定义视频采集或其他视频源的场景中,请使用 [setupLocalVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setuplocalvideo) 代替。 ::: ### 调用时机 [#调用时机-1] - 请确保在调用该方法前已调用 [setupLocalVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setuplocalvideo) 初始化本地视频画面。 - 通话过程中,可多次调用该方法更新本地视频画面的显示模式。 ### 参数 [#参数-1] 本地视频画面的显示模式。详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-rendermodetype)。 本地视频画面的镜像模式。详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videomirrormodetype)。 :::note 注: 如果使用前置摄像头,SDK 默认开启镜像模式;如果使用后置摄像头,SDK 默认关闭镜像模式。 ::: ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setLocalRenderTargetFps [#setlocalrendertargetfps] 设置本地视频渲染的最大帧率。 ```cpp virtual int setLocalRenderTargetFps(VIDEO_SOURCE_TYPE sourceType, int targetFps) = 0; ``` ### 适用场景 [#适用场景-1] 在对视频渲染帧率要求不高的场景(如屏幕共享或在线教育)中,你可以调用该方法设置本地视频渲染的最大帧率。SDK 会尝试将本地渲染的实际帧率保持在该值附近,以降低 CPU 消耗并提升系统性能。 ### 调用时机 [#调用时机-2] 你可以在加入频道前或加入频道后调用该方法。 ### 参数 [#参数-2] 视频源类型,详见 [VIDEO_SOURCE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videosourcetype)。 本地视频的采集帧率(fps)。支持的值包括:1、7、10、15、24、30、60。 :::note 注: 将该参数设置为低于实际视频帧率的值,否则设置无效。 ::: ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setLocalVideoMirrorMode [#setlocalvideomirrormode] 设置本地视频镜像模式。 ```cpp virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) __deprecated = 0; ``` :::error[废弃] 该方法已废弃,请改用 [setupLocalVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setuplocalvideo) 或 `setLocalRenderMode`。 ::: ### 参数 [#参数-3] 本地视频镜像模式。详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videomirrormodetype)。 ### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setRemoteRenderMode [#setremoterendermode] 更新远端用户视频视图的显示模式。 ```cpp virtual int setRemoteRenderMode(uid_t uid, media::base::RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; ``` 你可以在初始化远端用户视频视图后调用此方法,更新其渲染模式和镜像模式。该方法仅影响本地用户看到的远端视频视图。 :::note 注: - 请在调用 [setupRemoteVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setupremotevideo) 初始化远端视图后再调用此方法。 - 通话过程中,你可以根据需要多次调用此方法更新远端用户视频视图的显示模式。 ::: ### 参数 [#参数-4] 远端用户 ID。 远端用户视图的渲染模式,详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-rendermodetype)。 远端用户视图的镜像模式,详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videomirrormodetype)。 ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-5] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setRemoteRenderModeEx [#setremoterendermodeex] 设置指定远端用户的视频显示模式。 ```cpp virtual int setRemoteRenderModeEx(uid_t uid, media::base::RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode, const RtcConnection& connection) = 0; ``` 调用 [setupRemoteVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setupremotevideo) 初始化远端用户的视频视图后,可以调用该方法更新其渲染模式和镜像模式。该方法仅影响本地用户看到的视频视图。 :::note 注: - 请在调用 [setupRemoteVideo](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setupremotevideo) 初始化远端视图后调用此方法。 - 通话过程中,可以多次调用此方法更新远端用户视频视图的显示模式。 ::: ### 适用场景 [#适用场景-2] 该方法适用于多频道场景。 ### 参数 [#参数-5] 远端用户的用户 ID。 视频显示模式,详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-rendermodetype)。 镜像模式,详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videomirrormodetype)。 连接信息,详见 [RtcConnection](/zh-CN/api-reference/rtc/cpp-all-platforms/class-rtcconnection)。 ### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-6] - [IRtcEngineEx](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineex) ## setRemoteRenderTargetFps [#setremoterendertargetfps] 设置远端视频渲染的最大帧率。 ```cpp virtual int setRemoteRenderTargetFps(int targetFps) = 0; ``` ### 适用场景 [#适用场景-3] 在视频渲染帧率要求不高的场景(例如屏幕共享、在线教育)或远端用户使用中低端设备的情况下,你可以调用该方法设置远端客户端的视频渲染最大帧率。SDK 会尽可能将实际渲染帧率控制在该值附近,从而降低 CPU 消耗并提升系统性能。 ### 调用时机 [#调用时机-3] 你可以在加入频道前或加入频道后调用该方法。 ### 参数 [#参数-6] 远端视频的渲染最大帧率(fps)。支持的取值包括:1、7、10、15、24、30、60。 - 请将该参数设置为低于实际视频帧率的值,否则设置不会生效。 ### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setRenderMode [#setrendermode] 设置媒体播放器的渲染模式。 ```cpp virtual int setRenderMode(media::base::RENDER_MODE_TYPE renderMode) = 0; ``` ### 参数 [#参数-7] 渲染模式,详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-rendermodetype)。 ### 返回值 [#返回值-8] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## setupLocalVideo [#setuplocalvideo] 初始化本地视频画面。 ```cpp virtual int setupLocalVideo(const VideoCanvas& canvas) = 0; ``` 该方法在本地设备上初始化本地视频流的画面视图,仅影响本地用户看到的视频画面,不影响本地视频的发布。你可以调用该方法将本地视频流绑定到指定的视频视图(`view`),并设置该视图的渲染模式和镜像模式。 绑定关系在离开频道后仍然有效。若需停止渲染或解绑本地视频与视图的绑定关系,可将 `view` 设置为 NULL。 在实时互动场景中,如果你需要在本地视频预览中同时查看多个不同观察位置的画面,可以多次调用该方法,为每个 `view` 设置不同的观察位置。例如,将视频源设置为摄像头后,配置两个 `view`,其 `position` 分别设置为 `POSITION_POST_CAPTURER_ORIGIN` 和 `POSITION_POST_CAPTURER`,即可同时预览原始未处理的视频帧和经过美颜特效、虚拟背景、水印等预处理后的视频帧。 :::note 注: 若仅需在通话中更新本地视频视图的渲染模式或镜像模式,请改用 `setLocalRenderMode`。 ::: ### 适用场景 [#适用场景-4] 初始化后调用该方法设置本地视频,然后加入频道。在实时互动场景中,如需在本地预览中同时查看多个不同观察位置的画面,可多次调用该方法设置不同的 `view` 和观察位置。 ### 调用时机 [#调用时机-4] 你可以在加入频道前或后调用该方法。 ### 参数 [#参数-8] 本地视频视图及相关设置,详见 [VideoCanvas](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videocanvas)。 ### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-9] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setupRemoteVideo [#setupremotevideo] 初始化远端用户的视频视图。 ```cpp virtual int setupRemoteVideo(const VideoCanvas& canvas) = 0; ``` 该方法在本地设备上初始化远端视频流的视频视图,仅影响本地用户所见的视频画面。你可以通过该方法将远端视频流绑定到指定视图,并设置该视图的渲染模式和镜像模式。你需要在调用该方法时指定远端用户的 ID。如果应用尚未获取远端用户的 ID,请在收到 [onUserJoined](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#callback_irtcengineeventhandler_onuserjoined) 回调后再设置。若要解绑远端用户与视图的绑定关系,可将 `view` 参数设置为 NULL。当远端用户离开频道时,SDK 会自动解绑该用户。在移动端进行视频合流布局自定义的场景中,你可以调用该方法,并为合流视频流中的每个子视频流设置独立的 `view` 进行渲染。 :::note 注: - 若需在通话过程中更新远端视频视图的渲染模式或镜像模式,请使用 [setRemoteRenderMode](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_setremoterendermode2) 方法。 - 使用录制服务时,应用无需绑定视图,因为录制服务不会发送视频流。如果你的应用无法识别录制服务,请在 SDK 触发 [onFirstRemoteVideoDecoded](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-basic#callback_irtcengineeventhandler_onfirstremotevideodecoded) 回调时将远端用户绑定到视图。 ::: ### 参数 [#参数-9] 远端视频视图及其相关设置。详见 [VideoCanvas](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videocanvas)。 ### 返回值 [#返回值-10] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-10] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setupRemoteVideoEx [#setupremotevideoex] 初始化远端用户的视频视图。 ```cpp virtual int setupRemoteVideoEx(const VideoCanvas& canvas, const RtcConnection& connection) = 0; ``` 该方法在本地设备上初始化远端视频流的视图,仅影响你本地看到的画面。调用该方法可以将远端视频流绑定到指定视图,并设置该视图的渲染模式和镜像模式。 你需要在远端用户加入频道前,通过 [VideoCanvas](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videocanvas) 设置远端用户的用户 ID。如果你尚未获取远端用户 ID,可以在收到 [onUserJoined](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#callback_irtcengineeventhandler_onuserjoined) 回调后再设置。 如果启用了视频录制功能,录制服务会以虚拟客户端身份加入频道,其他客户端也会因此收到 [onUserJoined](/zh-CN/api-reference/rtc/cpp-all-platforms/channel#callback_irtcengineeventhandler_onuserjoined) 回调。不要将该虚拟客户端绑定到视图,因为它不会发送任何视频流。 若要解除远端用户与视图的绑定,可将 `view` 参数设置为 NULL。当远端用户离开频道后,SDK 会自动解除绑定。 :::note 注: 若需在通话过程中更新远端视频视图的渲染模式或镜像模式,请使用 [setRemoteRenderModeEx](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengineex_setremoterendermodeex) 方法。 ::: ### 适用场景 [#适用场景-5] 该方法适用于多频道场景。 ### 参数 [#参数-10] 远端视频视图的设置。详见 [VideoCanvas](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videocanvas)。 连接信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/cpp-all-platforms/class-rtcconnection)。 ### 返回值 [#返回值-11] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-11] - [IRtcEngineEx](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineex) ## startMediaRenderingTracing [#startmediarenderingtracing] 启用视频帧渲染过程的追踪功能。 ```cpp virtual int startMediaRenderingTracing() = 0; ``` :::info[自从] 自 v4.1.1 版本新增。 ::: 从成功调用该方法开始,SDK 会追踪频道中视频帧的渲染状态,并通过 [onVideoRenderingTracingResult](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#callback_irtcengineeventhandler_onvideorenderingtracingresult) 回调报告相关信息。 :::note 注: - 如果你未调用该方法,SDK 会从调用 `joinChannel` 加入频道时开始追踪视频帧的渲染事件。你可以根据实际应用场景在合适的时间调用该方法,以设置追踪视频渲染事件的起始位置。 - 本地用户离开当前频道后,SDK 会自动从你再次加入频道时开始追踪视频渲染事件。 ::: ### 适用场景 [#适用场景-6] 你可以结合应用中的 UI 设置(如按钮、滑块)调用该方法,以提升用户体验。例如,在用户点击“加入频道”按钮时调用该方法,然后通过 [onVideoRenderingTracingResult](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#callback_irtcengineeventhandler_onvideorenderingtracingresult) 回调获取视频帧渲染过程所耗费的时间,从而优化相关指标。 ### 返回值 [#返回值-12] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -7:在初始化 [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) 之前调用了该方法。 ### 所属接口类 [#所属接口类-12] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## startMediaRenderingTracingEx [#startmediarenderingtracingex] 启用视频帧渲染过程的追踪。 ```cpp virtual int startMediaRenderingTracingEx(const RtcConnection& connection) = 0; ``` :::info[自从] 自 v4.1.1 版本新增。 ::: 调用该方法后,SDK 会从调用时刻开始追踪频道中视频帧的渲染状态,并通过 [onVideoRenderingTracingResult](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#callback_irtcengineeventhandler_onvideorenderingtracingresult) 回调报告相关信息。你可以结合应用中的 UI 控件(如按钮、滑块)调用该方法,以优化用户体验,例如在用户点击“加入频道”按钮时调用该方法,并通过 [onVideoRenderingTracingResult](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#callback_irtcengineeventhandler_onvideorenderingtracingresult) 回调获取视频帧渲染过程所耗时间,从而优化相关指标。 :::note 注: - 如果你未调用该方法,SDK 会从调用 `joinChannel` 加入频道时开始追踪视频帧的渲染事件。你可以根据实际应用场景在合适的时间调用该方法,以设置追踪视频渲染事件的起始位置。 - 本地用户离开当前频道后,SDK 会自动从你加入频道的时刻开始追踪视频渲染事件。 ::: ### 适用场景 [#适用场景-7] 该方法适用于多频道场景。 ### 参数 [#参数-11] 连接信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/cpp-all-platforms/class-rtcconnection)。 ### 返回值 [#返回值-13] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-13] - [IRtcEngineEx](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineex) ## onTranscodedStreamLayoutInfo [#ontranscodedstreamlayoutinfo] 本地用户接收到携带视频合图布局信息的合图视频时触发。 ```cpp virtual void onTranscodedStreamLayoutInfo(uid_t uid, int width, int height, int layoutCount,const VideoLayout* layoutlist) ``` 当你首次接收到视频合图服务器发送的合图视频,或合图布局信息发生变化时,SDK 会触发该回调,报告合图视频中每个子视频流的布局信息。 :::note 注: 该回调仅适用于 Android 和 iOS 平台。 ::: ### 触发时机 [#触发时机] 当本地用户首次接收到视频合流服务器发送的合图视频,或混合流的布局信息发生变化时触发。 ### 参数 [#参数-12] 发布该合图视频的用户 ID。 合图视频的宽度(单位为像素)。 合图视频的高度(单位为像素)。 合图视频中包含的布局信息数量。 子视频流的布局信息数组。详见 [VideoLayout](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videolayout)。 ### 所属接口类 [#所属接口类-14] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineeventhandler) ## onVideoRenderingTracingResult [#onvideorenderingtracingresult] 视频帧渲染事件回调。 ```cpp virtual void onVideoRenderingTracingResult(uid_t uid, MEDIA_TRACE_EVENT currentEvent, VideoRenderingTracingInfo tracingInfo) ``` 调用 [startMediaRenderingTracing](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_startmediarenderingtracing) 方法或加入频道后,SDK 会触发该回调,用于上报视频帧渲染事件及渲染过程中的各项指标。你可以通过优化这些指标,提高首帧视频的渲染效率。 ### 触发时机 [#触发时机-1] 调用 [startMediaRenderingTracing](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-rendering#api_irtcengine_startmediarenderingtracing) 方法或加入频道后触发。 ### 参数 [#参数-13] 用户 ID。 当前视频帧渲染事件,详见 [MEDIA_TRACE_EVENT](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-mediatraceevent)。 视频帧渲染过程中的各项指标,详见 [VideoRenderingTracingInfo](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videorenderingtracinginfo)。 ### 所属接口类 [#所属接口类-15] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineeventhandler)