# 视频渲染 (/zh-CN/api-reference/rtc/unity/video/video-rendering)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## EnableInstantMediaRendering [#enableinstantmediarendering]
开启音视频帧加速渲染。
```csharp
public abstract int EnableInstantMediaRendering();
```
成功调用该方法后,SDK 会开启加速出图和出声模式,可加快用户加入频道后的首帧出图与出声速度。
:::note
注: 主播端和观众端都需调用该方法开启音视频帧加速渲染才可体验该功能。
一旦成功调用该方法,只能通过调用 [Dispose](/zh-CN/api-reference/rtc/unity/initialize#api_irtcengine_release) 方法销毁 [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象来取消加速渲染。
:::
### 适用场景 [#适用场景]
声网推荐在直播场景下,对观众开启该模式。
### 调用时机 [#调用时机]
该方法需要在加入频道前调用。
### 返回值 [#返回值]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -7: [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 尚未初始化就调用方法。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetEnable [#setenable]
开始/停止视频渲染。
```csharp
public void SetEnable(bool enable)
{
Enable = enable;
}
```
### 参数 [#参数]
是否开始视频渲染。
- true:(默认)开启
- false:不开启
### 所属接口类 [#所属接口类-1]
- [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface)
## SetForUser [#setforuser]
设置本地/远端视频显示。
```csharp
public void SetForUser(uint uid = 0, string channelId = "",
VIDEO_SOURCE_TYPE source_type = VIDEO_SOURCE_TYPE.VIDEO_SOURCE_CAMERA_PRIMARY)
{
Uid = uid;
ChannelId = channelId;
SourceType = source_type;
}
```
:::note
注:
- 确保在主线程中调用此方法。
- 确保在绑定 VideoSurface.cs 前调用此方法。
:::
### 参数 [#参数-1]
远端用户的 ID,通过 [OnUserJoined](/zh-CN/api-reference/rtc/unity/channel#callback_irtcengineeventhandler_onuserjoined) 获得。默认值为 0,表示可以看到本地视频。
频道 ID。
视频流类型,详见[VIDEO_SOURCE_TYPE](/zh-CN/api-reference/rtc/unity/enum-videosourcetype)。
### 所属接口类 [#所属接口类-2]
- [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface)
## SetLocalRenderMode [1/2] [#setlocalrendermode-12]
设置本地视图显示模式。
```csharp
public abstract int SetLocalRenderMode(RENDER_MODE_TYPE renderMode);
```
:::error[废弃]
弃用: 该方法已废弃,请使用 [SetLocalRenderMode [2/2]](/zh-CN/api-reference/rtc/unity/video/video-rendering#api_irtcengine_setlocalrendermode2) 作为替代。
:::
该方法设置本地视图显示模式。 App 可以多次调用此方法更改显示模式。
### 参数 [#参数-2]
本地视图显示模式。详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-rendermodetype)。
### 返回值 [#返回值-1]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-3]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetLocalRenderMode [2/2] [#setlocalrendermode-22]
更新本地视图显示模式。
```csharp
public abstract int SetLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode);
```
初始化本地用户视图后,你可以调用该方法更新本地用户视图的渲染和镜像模式。该方法只影响本地用户看到的视频画面,不影响本地视频的发布。
### 调用时机 [#调用时机-1]
- 请在调用 [SetupLocalVideo](/zh-CN/api-reference/rtc/unity/video/video-rendering#api_irtcengine_setuplocalvideo) 方法初始化本地视图后,调用该方法。
- 你可以在通话中多次调用该方法,多次更新本地用户视图的显示模式。
### 参数 [#参数-3]
本地视图显示模式。详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-rendermodetype)。
本地视图的镜像模式,详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-videomirrormodetype)。
:::note
注: 该参数仅对 SDK 自渲染生效,如果你想要设置视图镜像,可以将 GameObject 的 scaleX 设为 `-1` 或 `+1`。
如果你使用前置摄像头,默认启动本地用户视图镜像模式;如果你使用后置摄像头,默认关闭本地视图镜像模式。
:::
### 返回值 [#返回值-2]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-4]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetLocalRenderTargetFps [#setlocalrendertargetfps]
设置本地视频渲染的最大帧率。
```csharp
public abstract int SetLocalRenderTargetFps(VIDEO_SOURCE_TYPE sourceType, int targetFps);
```
### 适用场景 [#适用场景-1]
在对视频渲染帧率要求不高的场景(例如:屏幕共享、在线教育)下,你可以调用该方法设置本地视频渲染的最大帧率,SDK 进行本地渲染的实际帧率会尽量接近该值,从而减小 CPU 消耗、提升系统性能。
### 调用时机 [#调用时机-2]
该方法在加入频道前后均可调用。
### 参数 [#参数-4]
视频源的类型,详见 [VIDEO_SOURCE_TYPE](/zh-CN/api-reference/rtc/unity/enum-videosourcetype)。
最大渲染帧率 (fps)。支持的参数值为:1、7、10、15、24、30、60。
:::note
注: 请将此参数设置为低于视频实际帧率的渲染帧率,否则设置将不会生效。
:::
### 返回值 [#返回值-3]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-5]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetLocalVideoDataSourcePosition [#setlocalvideodatasourceposition]
设置本地视频帧的观测位置。
```csharp
public abstract int SetLocalVideoDataSourcePosition(VIDEO_MODULE_POSITION position);
```
:::note
注: 该方法仅支持观测通过 [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface) 及其子类渲染的本地视频数据。
:::
### 调用时机 [#调用时机-3]
该方法需要在创建第一个 [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface) 视图之前调用。
### 参数 [#参数-5]
视频帧的观测位置,详见 [VIDEO_MODULE_POSITION](/zh-CN/api-reference/rtc/unity/enum-videomoduleposition)。
:::note
注:
- 该方法目前仅支持将观测位置设为 POSITION_POST_CAPTURER 或 POSITION_PRE_ENCODER。
- 在 POSITION_POST_CAPTURER 处获取的视频帧未经裁剪且帧率较高,POSITION_PRE_ENCODER 位置获取的视频帧经过发送前的裁剪,帧率小于或等于摄像头采集的帧率。
:::
### 返回值 [#返回值-4]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-6]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetLocalVideoMirrorMode [#setlocalvideomirrormode]
设置本地视频镜像。
```csharp
public abstract int SetLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode);
```
:::error[废弃]
弃用: 该方法已废弃。
:::
### 参数 [#参数-6]
本地视频镜像模式。详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-videomirrormodetype)。
### 返回值 [#返回值-5]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-7]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetRemoteRenderMode [#setremoterendermode]
更新远端视图显示模式。
```csharp
public abstract int SetRemoteRenderMode(uint uid, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode);
```
初始化远端用户视图后,你可以调用该方法更新远端用户视图在本地显示时的渲染和镜像模式。该方法只影响本地用户看到的视频画面。
:::note
注:
- 你可以在通话中多次调用该方法,多次更新远端用户视图的显示模式。
:::
### 参数 [#参数-7]
远端用户 ID。
远端用户视图的渲染模式,详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-rendermodetype)。
远端用户视图的镜像模式,详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-videomirrormodetype)。
### 返回值 [#返回值-6]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-8]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetRemoteRenderModeEx [#setremoterendermodeex]
设置远端视图显示模式。
```csharp
public abstract int SetRemoteRenderModeEx(uint uid, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode, RtcConnection connection);
```
初始化远端用户视图后,你可以调用该方法更新远端用户视图在本地显示时的渲染和镜像模式。该方法只影响本地用户看到的视频画面。
### 参数 [#参数-8]
远端用户 ID。
远端视图显示模式,详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-rendermodetype)。
远端用户视图的镜像模式,详见 [VIDEO_MIRROR_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-videomirrormodetype)。
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unity/class-rtcconnection)。
### 返回值 [#返回值-7]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-9]
- [IRtcEngineEx](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengineex)
## SetRemoteRenderTargetFps [#setremoterendertargetfps]
设置视频在远端渲染的最大帧率。
```csharp
public abstract int SetRemoteRenderTargetFps(int targetFps);
```
### 适用场景 [#适用场景-2]
在对视频渲染帧率要求不高的场景(例如:屏幕共享、在线教育)或者远端使用中低端设备的场景下,你可以调用该方法设置视频在远端渲染的最大帧率,SDK 进行远端视频渲染的实际帧率会尽量接近该值,从而减小 CPU 消耗、提升系统性能。
### 调用时机 [#调用时机-4]
该方法在加入频道前后均可调用。
### 参数 [#参数-9]
最大渲染帧率 (fps)。支持的参数值为:1、7、10、15、24、30、60。
:::note
注: 请将此参数设置为低于视频实际帧率的渲染帧率,否则设置将不会生效。
:::
### 返回值 [#返回值-8]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-10]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetRenderMode [#setrendermode]
设置播放器视图的渲染模式。
```csharp
public abstract int SetRenderMode(RENDER_MODE_TYPE renderMode);
```
### 参数 [#参数-10]
播放器视图的渲染模式。详见 [RENDER_MODE_TYPE](/zh-CN/api-reference/rtc/unity/enum-rendermodetype)。
### 返回值 [#返回值-9]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-11]
- [IMediaPlayer](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_imediaplayer)
## SetupLocalVideo [#setuplocalvideo]
初始化本地视图。
```csharp
public abstract int SetupLocalVideo(VideoCanvas canvas);
```
该方法初始化本地视图并设置本地用户视频显示属性,只影响本地用户看到的视频画面,不影响本地视频的发布。调用该方法绑定本地视频流的显示视窗 (`view`),并设置本地用户视图的渲染模式和镜像模式。
退出频道后绑定仍然有效。如果需要停止渲染或解除绑定,可以调用该方法将参数 `view` 设为 NULL,以停止渲染并清理渲染缓存。
:::note
注:
- 在 Flutter 中你不需要主动调用该方法,请使用 `AgoraVideoView` 渲染本地和远端视图。
- 如果你想要在原生窗口上渲染图像,请调用此方法;如果你仅需在 Unity 项目内渲染图像,可直接通过 [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface) 类来实现。
- 如果你希望在通话中仅更新本地用户视图的渲染或镜像模式,请使用 [SetLocalRenderMode [2/2]](/zh-CN/api-reference/rtc/unity/video/video-rendering#api_irtcengine_setlocalrendermode2) 方法。
:::
### 适用场景 [#适用场景-3]
在 App 开发中,通常在初始化后调用该方法进行本地视频设置,然后再加入频道。
如果你需要在本地视频预览的画面中同时看到多个预览画面、且不同画面分别处于视频链路上不同观测点,可以重复调用该方法设置不同的 `view`,并针对每个 `view` 设置不同的观测位置。例如:将视频源设置为摄像头,然后对应两个 `view` 分别设置 `position` 为 PositionPostCapturerOrigin 和 PositionPostCapturer,即可在本地视频预览中同时看到没有经过视频前处理的原始画面和已经过视频前处理(美颜、虚拟背景、水印本地预览)的画面。
### 调用时机 [#调用时机-5]
该方法在加入频道前后均可调用。
### 参数 [#参数-11]
本地视频显示属性。详见 [VideoCanvas](/zh-CN/api-reference/rtc/unity/class-videocanvas)。
### 返回值 [#返回值-10]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-12]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetupRemoteVideo [#setupremotevideo]
初始化远端用户视图。
```csharp
public abstract int SetupRemoteVideo(VideoCanvas canvas);
```
该方法绑定远端用户和显示视图,并设置远端用户视图在本地显示时的渲染模式和镜像模式,只影响本地用户看到的视频画面。
调用该方法时需要指定远端视频的用户 ID,一般可以在进频道前提前设置好。如果无法在加入频道前得到远端用户的 ID,可以在收到 [OnUserJoined](/zh-CN/api-reference/rtc/unity/channel#callback_irtcengineeventhandler_onuserjoined) 回调时调用该方法。
如需解除某个远端用户的绑定视图,可以调用该方法并将 `view` 设置为空。
离开频道后,SDK 会清除远端用户视图的绑定关系。
在移动端自定义合图布局场景下,你可以调用该方法并针对合图视频流的每一路子视频流设置一个单独的 `view` 进行渲染。
:::note
注:
- 如果你想要在原生窗口上渲染图像,请调用此方法;如果你仅需在 Unity 项目内渲染图像,可直接通过 [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface) 类来实现。
- 如果你希望在通话中更新远端用户视图的渲染或镜像模式,请使用 [SetRemoteRenderMode](/zh-CN/api-reference/rtc/unity/video/video-rendering#api_irtcengine_setremoterendermode2) 方法。
- 当使用录制服务时,由于它不会发送视频流,App 无需为它绑定视图。如果 App 无法识别录制服务,可以在收到 [OnFirstRemoteVideoDecoded](/zh-CN/api-reference/rtc/unity/video/video-basic#callback_irtcengineeventhandler_onfirstremotevideodecoded) 回调时再绑定远端用户视图。
:::
### 参数 [#参数-12]
远端视频显示属性。详见 [VideoCanvas](/zh-CN/api-reference/rtc/unity/class-videocanvas)。
### 返回值 [#返回值-11]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-13]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## SetupRemoteVideoEx [#setupremotevideoex]
初始化远端用户视图。
```csharp
public abstract int SetupRemoteVideoEx(VideoCanvas canvas, RtcConnection connection);
```
该方法绑定远端用户和显示视图,并设置远端用户视图在本地显示时的渲染模式和镜像模式,只影响本地用户看到的视频画面。
调用该方法时需要在 [VideoCanvas](/zh-CN/api-reference/rtc/unity/class-videocanvas) 中指定远端视频的用户 ID,一般可以在进频道前提前设置好。
如果无法在加入频道前得到远端用户的 uid,可以在收到 [OnUserJoined](/zh-CN/api-reference/rtc/unity/channel#callback_irtcengineeventhandler_onuserjoined) 回调时调用该方法。如果启用了视频录制功能,视频录制服务会做为一个哑客户端加入频道,因此其他客户端也会收到它的 `onUserJoined` 事件, App 不应给它绑定视图(因为它不会发送视频流)。
如需解除某个远端用户的绑定视图,可以调用该方法并将 `view` 设置为空。
离开频道后,SDK 会清除远端用户视图的绑定关系。
:::note
注:
- 该方法需要在 [JoinChannelEx](/zh-CN/api-reference/rtc/unity/channel#api_irtcengineex_joinchannelex) 之后调用。
- 在 Flutter 中你不需要主动调用该方法,请使用 `AgoraVideoView` 渲染本地和远端视图。
- 如果你希望在通话中更新远端用户视图的渲染或镜像模式,请使用 [SetRemoteRenderModeEx](/zh-CN/api-reference/rtc/unity/video/video-rendering#api_irtcengineex_setremoterendermodeex) 方法。
:::
### 参数 [#参数-13]
视频画布信息。详见 [VideoCanvas](/zh-CN/api-reference/rtc/unity/class-videocanvas)。
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unity/class-rtcconnection)。
### 返回值 [#返回值-12]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-14]
- [IRtcEngineEx](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengineex)
## StartMediaRenderingTracing [#startmediarenderingtracing]
开启视频帧渲染数据打点。
```csharp
public abstract int StartMediaRenderingTracing();
```
成功调用该方法后,SDK 会以调用该方法的时刻作为起点,并通过 [OnVideoRenderingTracingResult](/zh-CN/api-reference/rtc/unity/video/video-rendering#callback_irtcengineeventhandler_onvideorenderingtracingresult) 回调报告视频帧渲染的相关信息。
:::note
注:
- 如果你未调用该方法,SDK 默认以调用 [JoinChannel [2/2]](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_joinchannel2) 加入频道的时刻为起始点开始打点,自动开始跟踪视频的渲染事件。你可以根据实际业务场景,在合适的时机调用该方法,进行自定义打点。
- 离开当前频道后,SDK 会自动重置该时间点为下一次加入频道的时刻。
:::
### 适用场景 [#适用场景-4]
声网推荐你将该方法和 App 中的 UI 设置(按钮、滑动条等)结合使用,用于获取符合终端用户实际体验的首帧出图耗时的场景。例如:在终端用户在点击 加入频道 按钮的时刻调用该方法进行打点,然后通过 `onVideoRenderingTracingResult` 回调获取视频帧渲染过程中的各阶段耗时,从而针对各阶段耗时进行专项优化。
### 返回值 [#返回值-13]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -7: [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 尚未初始化就调用方法。
### 所属接口类 [#所属接口类-15]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## StartMediaRenderingTracingEx [#startmediarenderingtracingex]
开启视频帧渲染数据打点。
```csharp
public abstract int StartMediaRenderingTracingEx(RtcConnection connection);
```
成功调用该方法后,SDK 会以调用该方法的时刻作为起点,并通过 [OnVideoRenderingTracingResult](/zh-CN/api-reference/rtc/unity/video/video-rendering#callback_irtcengineeventhandler_onvideorenderingtracingresult) 回调报告视频帧渲染的相关信息。
:::note
注:
- 如果你未调用该方法,SDK 默认以调用 [JoinChannel [2/2]](/zh-CN/api-reference/rtc/unity/channel#api_irtcengine_joinchannel2) 加入频道的时刻为起始点开始打点,自动开始跟踪视频的渲染事件。你可以根据实际业务场景,在合适的时机调用该方法,进行自定义打点。
- 离开当前频道后,SDK 会自动重置该时间点为下一次加入频道的时刻。
:::
### 适用场景 [#适用场景-5]
声网推荐你将该方法和 App 中的 UI 设置(按钮、滑动条等)结合使用,用于获取符合终端用户实际体验的首帧出图耗时的场景。例如:在终端用户在点击 加入频道 按钮的时刻调用该方法进行打点,然后通过 `onVideoRenderingTracingResult` 回调获取视频帧渲染过程中的各阶段耗时,从而针对各阶段耗时进行专项优化。
### 参数 [#参数-14]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unity/class-rtcconnection)。
### 返回值 [#返回值-14]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-16]
- [IRtcEngineEx](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengineex)
## OnTextureSizeModify [#ontexturesizemodify]
Texture 的宽高发生改变回调。
```csharp
public event OnTextureSizeModifyHandler OnTextureSizeModify;
```
该回调在 Texture 的宽高发生变化时被触发。
### 所属接口类 [#所属接口类-17]
- [VideoSurface](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_videosurface)
## OnTranscodedStreamLayoutInfo [#ontranscodedstreamlayoutinfo]
已接收携带布局信息的合图视频流回调。
```csharp
public virtual void OnTranscodedStreamLayoutInfo(RtcConnection connection, uint uid, int width, int height, int layoutCount, VideoLayout[] layoutlist)
```
当本地第一次接收到合图服务器发送的合图视频流,或者合图流的布局信息有变化时,SDK 会触发该回调,报告合图视频流中每一路子视频流的布局信息。
:::note
注: 该回调仅适用于 Android 和 iOS。
:::
### 参数 [#参数-15]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unity/class-rtcconnection)。
发布合图视频流的用户 ID。
合图视频流的宽度 (px)。
合图视频流的高度 (px)。
合图视频流中布局信息的数量。
某一路合图视频流的详细布局信息。详见 [VideoLayout](/zh-CN/api-reference/rtc/unity/class-videolayout)。
### 所属接口类 [#所属接口类-18]
- [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengineeventhandler)
## OnVideoRenderingTracingResult [#onvideorenderingtracingresult]
视频帧渲染事件回调。
```csharp
public virtual void OnVideoRenderingTracingResult(RtcConnection connection, uint uid, MEDIA_TRACE_EVENT currentEvent, VideoRenderingTracingInfo tracingInfo) { }
```
调用 [StartMediaRenderingTracing](/zh-CN/api-reference/rtc/unity/video/video-rendering#api_irtcengine_startmediarenderingtracing) 方法或加入频道后,SDK 会触发该回调,报告视频帧渲染的事件和渲染过程中的指标。开发者可以针对指标进行专项优化,以提高出图效率。
### 参数 [#参数-16]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unity/class-rtcconnection)。
用户 ID。
当前视频帧渲染事件。详见 [MEDIA_TRACE_EVENT](/zh-CN/api-reference/rtc/unity/enum-mediatraceevent)。
视频帧渲染过程中的指标。开发者需要尽可能降低指标值,以提高出图效率。详见 [VideoRenderingTracingInfo](/zh-CN/api-reference/rtc/unity/class-videorenderingtracinginfo)。
### 所属接口类 [#所属接口类-19]
- [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengineeventhandler)