视频渲染
enableInstantMediaRendering
开启音视频帧加速渲染。
Future<void> enableInstantMediaRendering();
详情
- 一旦开启快速渲染功能，只能通过调用 release 方法销毁 RtcEngine 对象来取消。
- 在该模式下，SDK 启用声网自定义加密算法来缩短建立传输链路的耗时，安全性相对于标准 DTLS (Datagram Transport Layer Security) 有所降低。如果业务场景对安全标准要求较高，请谨慎调用该方法。
适用场景
声网推荐在直播场景下，对观众开启该模式。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类setLocalRenderMode
更新本地视图显示模式。
Future<void> setLocalRenderMode(
{required RenderModeType renderMode,
VideoMirrorModeType mirrorMode =
VideoMirrorModeType.videoMirrorModeAuto});
详情
初始化本地用户视图后，你可以调用该方法更新本地用户视图的渲染和镜像模式。该方法只影响本地用户看到的视频画面，不影响本地发布视频。
- 请在调用 setupLocalVideo 方法初始化本地视图后，调用该方法。
- 你可以在通话中多次调用该方法，多次更新本地用户视图的显示模式。
- 该方法仅对第一个摄像头
(primaryCameraSource)生效。在自定义视频采集或使用其他类型视频源的场景下，你需要使用 setupLocalVideo 方法替代该方法。
参数
- renderMode
本地视图显示模式。详见 RenderModeType。
- mirrorMode
本地视图的镜像模式，详见 VideoMirrorModeType。
注意如果你使用前置摄像头，默认启动本地用户视图镜像模式；如果你使用后置摄像头，默认关闭本地视图镜像模式。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类setLocalVideoMirrorMode
设置本地视频镜像。
Future<void> setLocalVideoMirrorMode(VideoMirrorModeType mirrorMode);
详情
参数
- mirrorMode
本地视频镜像模式。详见 VideoMirrorModeType。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类setRemoteRenderMode
更新远端视图显示模式。
Future<void> setRemoteRenderMode(
{required int uid,
required RenderModeType renderMode,
required VideoMirrorModeType mirrorMode});
详情
初始化远端用户视图后，你可以调用该方法更新远端用户视图在本地显示时的渲染和镜像模式。该方法只影响本地用户看到的视频画面。
- 请在调用 setupRemoteVideo 方法初始化远端视图后，调用该方法。
- 你可以在通话中多次调用该方法，多次更新远端用户视图的显示模式。
参数
- uid
- 远端用户 ID。
- renderMode
远端用户视图的渲染模式，详见 RenderModeType。
- mirrorMode
远端用户视图的镜像模式，详见 VideoMirrorModeType。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setRemoteRenderModeEx
设置远端视图显示模式。
Future<void> setRemoteRenderModeEx(
{required int uid,
required RenderModeType renderMode,
required VideoMirrorModeType mirrorMode,
required RtcConnection connection});
详情
- 请在调用 setupRemoteVideo 方法初始化远端视图后，调用该方法。
- 你可以在通话中多次调用该方法，多次更新远端用户视图的显示模式。
参数
- uid
- 远端用户 ID。
- renderMode
远端视图显示模式，详见 RenderModeType。
- mirrorMode
远端用户视图的镜像模式，详见 VideoMirrorModeType。
- connection
- Connection 信息。详见 RtcConnection。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setRenderMode
设置播放器视图的渲染模式。
Future<void> setRenderMode(RenderModeType renderMode);
参数
- renderMode
播放器视图的渲染模式。详见 RenderModeType。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类setupLocalVideo
初始化本地视图。
Future<void> setupLocalVideo(VideoCanvas canvas);
详情
该方法初始化本地视图并设置本地用户视频显示属性，只影响本地用户看到的视频画面，不影响本地发布视频。调用该方法绑定本地视频流的显示视窗(view)，并设置本地用户视图的渲染模式和镜像模式。
在 App 开发中，通常在初始化后调用该方法进行本地视频设置，然后再加入频道。退出频道后，绑定仍然有效，如果需要解除绑定，可以调用该方法将参数 view 设为 NULL。
在实时互动场景下，如果你需要在本地视频预览的画面中同时看到多个预览画面、且不同画面分别处于视频链路上不同观测点，可以重复调用该方法设置不同的 view，并针对每个 view 设置不同的观测位置。例如：将视频源设置为摄像头，然后对应两个 view 分别设置 position 为 positionPostCapturerOrigin 和 positionPostCapturer，即可在本地视频预览中同时看到没有经过视频前处理的原始画面和已经过视频前处理（美颜、虚拟背景、水印本地预览）的画面。
- 在 Flutter 中你不需要主动调用该方法，请使用 AgoraVideoView 渲染本地和远端视图。
- 该方法在加入频道前后都能调用。
- 如果你希望在通话中更新本地用户视图的渲染或镜像模式，请使用 setLocalRenderMode 方法。
参数
- canvas
- 本地视频显示属性。详见 VideoCanvas。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setupRemoteVideo
初始化远端用户视图。
Future<void> setupRemoteVideo(VideoCanvas canvas);
详情
该方法绑定远端用户和显示视图，并设置远端用户视图在本地显示时的渲染模式和镜像模式，只影响本地用户看到的视频画面。
调用该方法时需要指定远端视频的用户 ID，一般可以在进频道前提前设置好。如果无法在加入频道前得到远端用户的 ID，可以在收到 onUserJoined 回调时调用该方法。
如需解除某个远端用户的绑定视图，可以调用该方法并将 view 设置为空。
离开频道后，SDK 会清除远端用户视图的绑定关系。
在移动端自定义合图布局场景下，你可以调用该方法并针对合图视频流的每一路子视频流设置一个单独的 view 进行渲染。
- 在 Flutter 中你不需要主动调用该方法，请使用 AgoraVideoView 渲染本地和远端视图。
- 如果你希望在通话中更新远端用户视图的渲染或镜像模式，请使用 setRemoteRenderMode 方法。
- 如果你使用了录制服务，录制服务会作为一个哑客户端加入频道，因此也会触发 onUserJoined 回调。由于录制服务不会发送视频流，App 无需为它绑定视图。如果 App 无法识别哑客户端，可以在收到 onFirstRemoteVideoDecoded 回调时再绑定远端用户视图。
参数
- canvas
远端视频显示属性。详见 VideoCanvas。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setupRemoteVideoEx
初始化远端用户视图。
Future<void> setupRemoteVideoEx(
{required VideoCanvas canvas, required RtcConnection connection});
详情
该方法绑定远端用户和显示视图，并设置远端用户视图在本地显示时的渲染模式和镜像模式，只影响本地用户看到的视频画面。
调用该方法时需要在 VideoCanvas 中指定远端视频的用户 ID，一般可以在进频道前提前设置好。
如果无法在加入频道前得到远端用户的 uid，可以在收到 onUserJoined 回调时调用该方法。如果启用了视频录制功能，视频录制服务会做为一个哑客户端加入频道，因此其他客户端也会收到它的 onUserJoined 事件， App 不应给它绑定视图（因为它不会发送视频流）。
如需解除某个远端用户的绑定视图，可以调用该方法并将 view 设置为空。
离开频道后，SDK 会清除远端用户视图的绑定关系。
- 在 Flutter 中你不需要主动调用该方法，请使用 AgoraVideoView 渲染本地和远端视图。
- 如果你希望在通话中更新远端用户视图的渲染或镜像模式，请使用 setRemoteRenderModeEx 方法。
参数
- canvas
视频画布信息。详见 VideoCanvas。
- connection
- Connection 信息。详见 RtcConnection。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
startMediaRenderingTracing
开启视频帧渲染数据打点。
Future<void> startMediaRenderingTracing();
详情
成功调用该方法后，SDK 会以调用该方法的时刻作为起点，并通过 onVideoRenderingTracingResult 回调报告视频帧渲染的相关信息。
- SDK 默认在成功加入频道的时刻起打点，自动开始跟踪视频频的渲染事件。你可以根据实际业务场景，在合适的时机调用该方法，进行自定义打点。
- 离开当前频道后，SDK 会自动重置该时间点为下一次成功加入频道的时刻。
适用场景
声网推荐你将该方法和 App 中的 UI 设置（按钮、滑动条等）结合使用，用于针对终端用户的体验改进。例如：在终端用户在点击 加入频道
按钮的时刻调用该方法进行打点，然后通过 onVideoRenderingTracingResult 回调获取视频帧渲染过程中的指标，从而针对指标进行专项优化。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类startMediaRenderingTracingEx
开启视频帧渲染数据打点。
Future<void> startMediaRenderingTracingEx(RtcConnection connection);
详情
成功调用该方法后，SDK 会以调用该方法的时刻作为起点，并通过 onVideoRenderingTracingResult 回调报告视频帧渲染的相关信息。
- SDK 默认在成功加入频道的时刻起打点，自动开始跟踪视频频的渲染事件。你可以根据实际业务场景，在合适的时机调用该方法，进行自定义打点。
- 离开当前频道后，SDK 会自动重置该时间点为下一次成功加入频道的时刻。
适用场景
声网推荐你将该方法和 App 中的 UI 设置（按钮、滑动条等）结合使用，用于针对终端用户的体验改进。例如：在终端用户在点击 加入频道
按钮的时刻调用该方法进行打点，然后通过 onVideoRenderingTracingResult 回调获取视频帧渲染过程中的指标，从而针对指标进行专项优化。
参数
- connection
- Connection 信息。详见 RtcConnection。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类onTranscodedStreamLayoutInfo
已接收携带布局信息的合图视频流回调。
final void Function(
RtcConnection connection,
int uid,
int width,
int height,
int layoutCount,
List<VideoLayout> layoutlist)? onTranscodedStreamLayoutInfo;
详情
当本地第一次接收到合图服务器发送的合图视频流，或者合图流的布局信息有变化时，SDK 会触发该回调，报告合图视频流中每一路子视频流的布局信息。
参数
- connection
- Connection 信息。详见 RtcConnection。
- uid
- 发布合图视频流的用户 ID。某一路合图视频流的详细布局信息。详见 VideoLayout。
onVideoRenderingTracingResult
视频帧渲染事件回调。
final void Function(
RtcConnection connection,
int uid,
MediaTraceEvent currentEvent,
VideoRenderingTracingInfo tracingInfo)? onVideoRenderingTracingResult;
详情
调用 startMediaRenderingTracing 方法或加入频道后，SDK 会触发该回调，报告视频帧渲染的事件和渲染过程中的指标。开发者可以针对指标进行专项优化，以提高出图效率。
参数
- connection
- Connection 信息。详见 RtcConnection。
- uid
- 用户 ID。
- currentEvent
- 当前视频帧渲染事件。详见 MediaTraceEvent。
- tracingInfo
- 视频帧渲染过程中的指标。开发者需要尽可能降低指标值，以提高出图效率。详见 VideoRenderingTracingInfo。