# 视频基础功能 (/zh-CN/api-reference/rtc/flutter/video/video-basic) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## disableVideo [#disablevideo] 关闭视频模块。 ```dart Future disableVideo(); ``` 该方法用于关闭视频模块。 :::note 注: - 该方法设置的是内部引擎为禁用状态,在离开频道后仍然有效。 - 调用该方法会重置整个引擎,响应时间较慢。你可以根据实际需求用以下方法来独立控制视频模块的某一项功能: - [enableLocalVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablelocalvideo): 是否启动摄像头采集并创建本地视频流。 - [muteLocalVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalvideostream): 是否发布本地视频流。 - [muteRemoteVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteremotevideostream): 是否接收并播放远端视频流。 - [muteAllRemoteVideoStreams](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteallremotevideostreams): 是否接收并播放所有远端视频流。 ::: ### 调用时机 [#调用时机] 加入频道前后均可调用: - 如果在加入频道前调用,则开启纯音频模式。 - 如果在加入频道后调用,则由视频模式切换为纯音频模式,然后再调用 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 方法可开启视频模式。 ### 相关回调 [#相关回调] 成功调用该方法后,远端会触发 [onUserEnableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onuserenablevideo) (false) 回调。 ### 返回值 [#返回值] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## enableLocalVideo [#enablelocalvideo] 开关本地视频采集。 ```dart Future enableLocalVideo(bool enabled); ``` 该方法禁用或重新启用本地视频采集,不影响接收远端视频。 调用 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 后,本地视频采集即默认开启。 如果你在频道内调用 [enableLocalVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablelocalvideo)(false) 关闭本地视频采集,也会同时停止在频道内发布视频流。如果想要重新开启,则可调用 [enableLocalVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablelocalvideo)(true),然后调用 [updateChannelMediaOptions](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_updatechannelmediaoptions) 并设置 `options` 参数,将本地采集的视频流发布到频道中。 成功禁用或启用本地视频采集后,远端会触发 [onRemoteVideoStateChanged](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onremotevideostatechanged) 回调。 :::note 注: - 该方法在加入频道前后均可调用,但加入频道前调用的设置,在加入频道后才会生效。 - 该方法设置内部引擎为启用状态,在离开频道后仍然有效。 ::: ### 参数 [#参数] 是否开启本地视频采集。 - true:(默认)开启本地视频采集。 - false: 关闭本地视频采集。关闭后,远端用户会接收不到本地用户的视频流;但本地用户依然可以接收远端用户的视频流。设置为 false 时,该方法不需要本地有摄像头。 ### 返回值 [#返回值-1] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## enableVideo [#enablevideo] 启用视频模块。 ```dart Future enableVideo(); ``` 视频模块默认为关闭状态,需要调用该方法启用。如果后续需要关闭视频模块,需调用 [disableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_disablevideo) 方法。 :::note 注: - 该方法设置的是内部引擎为启用状态,在离开频道后仍然有效。 - 调用该方法会重置整个引擎,响应时间较慢。你可以根据实际需求用以下方法来独立控制视频模块的某一项功能: - [enableLocalVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablelocalvideo): 是否启动摄像头采集并创建本地视频流。 - [muteLocalVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalvideostream): 是否发布本地视频流。 - [muteRemoteVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteremotevideostream): 是否接收并播放远端视频流。 - [muteAllRemoteVideoStreams](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteallremotevideostreams): 是否接收并播放所有远端视频流。 - 在频道内调用该方法时,会重置 [enableLocalVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablelocalvideo)、[muteRemoteVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteremotevideostream) 和 [muteAllRemoteVideoStreams](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteallremotevideostreams) 的设置,需谨慎使用。 ::: ### 调用时机 [#调用时机-1] 该方法可以在加入频道前或者频道内调用: - 如果在加入频道前调用,则开启视频模块。 - 如果在纯音频通话中调用,则音频通话将自动切换为视频通话。 ### 相关回调 [#相关回调-1] 成功调用该方法后,远端会触发 [onRemoteVideoStateChanged](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onremotevideostatechanged) 回调。 ### 返回值 [#返回值-2] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## setVideoEncoderConfiguration [#setvideoencoderconfiguration] 设置视频编码属性。 ```dart Future setVideoEncoderConfiguration(VideoEncoderConfiguration config); ``` 设置本地视频的编码属性。每一种视频编码属性对应一系列视频相关参数设置,包含分辨率、帧率和码率。 :::note 注: - 该方法的 `config` 参数设置是在理想网络状态下能达到的最大值。如果网络状态不好,视频引擎便不能使用该 `config` 渲染本地视频,它会自动降低到一个合适的视频参数设置。 ::: ### 调用时机 [#调用时机-2] 该方法在加入频道前后都能调用。如果用户在加入频道后不需要重新设置视频编码属性,则建议在 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 前调用该方法,可以加快首帧出图的时间。 ### 参数 [#参数-1] 视频编码参数配置。详见 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/flutter/class-videoencoderconfiguration)。 ### 返回值 [#返回值-3] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## setVideoEncoderConfigurationEx [#setvideoencoderconfigurationex] 设置视频编码属性。 ```dart Future setVideoEncoderConfigurationEx( {required VideoEncoderConfiguration config, required RtcConnection connection}); ``` 设置本地视频的编码属性。每一种视频编码属性对应一系列视频相关参数设置,包含分辨率、帧率和码率。 :::note 注: 该方法的 `config` 参数设置是在理想网络状态下能达到的最大值。如果网络状态不好,视频引擎便不能使用该 `config` 渲染本地视频,它会自动降低到一个合适的视频参数设置。 ::: ### 调用时机 [#调用时机-3] 该方法需要在 [joinChannelEx](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengineex_joinchannelex) 之后调用。 ### 参数 [#参数-2] 视频编码参数配置。详见 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/flutter/class-videoencoderconfiguration)。 Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 ### 返回值 [#返回值-4] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [RtcEngineEx](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineex) ## setVideoScenario [#setvideoscenario] 设置视频业务场景。 ```dart Future setVideoScenario(VideoApplicationScenarioType scenarioType); ``` 成功调用该方法设置视频业务场景后,SDK 会基于指定场景启用最佳实践策略,自动调整关键性能指标,进而优化视频体验质量。 :::note 注: 该方法需要在加入频道前调用。 ::: ### 参数 [#参数-3] 视频业务场景。详见 [VideoApplicationScenarioType](/zh-CN/api-reference/rtc/flutter/enum-videoapplicationscenariotype)。 `applicationScenarioMeeting` (1) 适用于会议场景。如果用户已调用 [setDualStreamMode](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_setdualstreammode2) 将小流设置为始终不发送 (`disableSimulcastStream`),会议场景对小流的动态开关不生效。 该枚举值仅适用于主播 vs 主播场景。SDK 会针对该场景启用以下策略: - 针对会议场景对小流码率要求较高的情况,自动启用多项抗弱网技术,提升小流的抗弱网能力,确保多路流订阅时接收端的流畅性。 - 实时监测接收端大流的订阅人数,根据订阅人数动态调节大流配置: - 无人订阅大流时,会自动降低大流的码率和帧率,节省上行带宽和消耗。 - 有人订阅大流时,大流会重置为用户最近一次调用 [setVideoEncoderConfiguration](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 时的 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/flutter/class-videoencoderconfiguration) 配置。如果用户此前没有进行设置,则使用如下值: - 视频分辨率:桌面端为 1280 × 720;移动端为 960 × 540 - 视频帧率:15 fps - 码率:桌面端为 1600 Kbps;移动端为 1000 Kbps - 实时监测接收端小流的订阅人数,根据订阅人数动态开启和关闭小流: - 无人订阅小流时,自动关闭小流,节省上行带宽和消耗。 - 有人订阅小流时,开启小流并重置为用户最近一次调用 [setDualStreamMode](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_setdualstreammode2) 时的 [SimulcastStreamConfig](/zh-CN/api-reference/rtc/flutter/class-simulcaststreamconfig) 配置。如果用户此前没有进行设置,则使用如下值: - 视频分辨率:480 × 272 - 视频帧率:15 fps - 码率:500 Kbps `applicationScenario1v1` (2) 适用于[视频 1v1 通话](/zh-CN/solutions/one-to-one-live/rtm)场景。针对该场景低延迟、高画质的体验要求,SDK 进行了策略调优,提升了画质、首帧出图、中低端机延迟及弱网流畅度等性能表现。`applicationScenarioLiveshow` (3) 适用于秀场直播场景。针对该场景对首帧出图时间和画质清晰度的高要求,SDK 进行了策略调优,例如,默认开启音视频帧加速渲染来提升首帧出图体验,无需再额外调用 [enableInstantMediaRendering](/zh-CN/api-reference/rtc/flutter/video/video-rendering#api_irtcengine_enableinstantmediarendering),同时会默认开启 B 帧来确保较高的图像质量、提高传输效率。此外,也增强了在弱网环境和低端设备上的画质和流畅度表现。 ### 返回值 [#返回值-5] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-5] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## startPreviewWithoutSourceType [#startpreviewwithoutsourcetype] 开启视频预览。 ```dart Future startPreviewWithoutSourceType(); ``` 该方法用于启动本地视频预览。 :::note 注: - 本地预览默认开启镜像功能。 - 在离开频道后,本地预览依然处于开启状态。你需要调用 [stopPreview](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_stoppreview2) 关闭本地预览。 ::: ### 调用时机 [#调用时机-4] 该方法必须在 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 之后调用。 ### 返回值 [#返回值-6] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-6] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## startPreview [#startpreview] 开启视频预览并指定预览的视频源。 ```dart Future startPreview( {VideoSourceType sourceType = VideoSourceType.videoSourceCameraPrimary}); ``` 该方法用于启动本地视频预览,并指定出现在预览画面中的视频源。 :::note 注: - 本地预览默认开启镜像功能。 - 在离开频道后,本地预览依然处于开启状态。你需要调用 [stopPreview](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_stoppreview2) 关闭本地预览。 ::: ### 调用时机 [#调用时机-5] 该方法必须在 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 之后调用。 ### 参数 [#参数-4] 视频源的类型,详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 ### 返回值 [#返回值-7] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## stopPreview [#stoppreview] 停止视频预览。 ```dart Future stopPreview( {VideoSourceType sourceType = VideoSourceType.videoSourceCameraPrimary}); ``` ### 适用场景 [#适用场景] 调用 `startPreview` 开启预览后,如果你想关闭本地视频预览,请调用该方法。 ### 调用时机 [#调用时机-6] 请在加入频道前或离开频道后调用该方法。 ### 参数 [#参数-5] 视频源的类型,详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 ### 返回值 [#返回值-8] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-8] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## onFirstLocalVideoFrame [#onfirstlocalvideoframe] 已显示本地视频首帧回调。 ```dart final void Function( VideoSourceType source, int width, int height, int elapsed)? onFirstLocalVideoFrame; ``` 本地视频首帧显示在本地视图上时,SDK 会触发此回调。 ### 参数 [#参数-6] 视频源的类型。详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 本地渲染视频的宽 (px) 。 本地渲染视频的高 (px)。 从调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 加入频道时到发生此事件过去的时间(毫秒)。如果在加入频道前调用了 [startPreviewWithoutSourceType](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_startpreview)/[startPreview](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_startpreview2),则该参数表示从调用 [startPreviewWithoutSourceType](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_startpreview) 或 [startPreview](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_startpreview2) 开启本地视频预览到发生此事件过去的时间。 ### 所属接口类 [#所属接口类-9] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onFirstLocalVideoFramePublished [#onfirstlocalvideoframepublished] 已发布本地视频首帧回调。 ```dart final void Function(RtcConnection connection, int elapsed)? onFirstLocalVideoFramePublished; ``` SDK 会在以下三种时机触发该回调: - 开启本地视频模块的情况下,调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 成功加入频道后。 - 调用 [muteLocalVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalvideostream)(true),再调用 [muteLocalVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalvideostream)(false) 后。 - 调用 [disableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_disablevideo),再调用 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 后。 ### 参数 [#参数-7] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 从调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 方法到触发该回调的时间间隔(毫秒)。 ### 所属接口类 [#所属接口类-10] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onFirstRemoteVideoDecoded [#onfirstremotevideodecoded] 已接收到远端视频并完成解码回调。 ```dart final void Function(RtcConnection connection, int remoteUid, int width, int height, int elapsed)? onFirstRemoteVideoDecoded; ``` SDK 会在以下时机触发该回调: - 远端用户首次上线后发送视频。 - 远端用户视频离线再上线后发送视频。出现这种中断的可能原因包括: - 远端用户离开频道。 - 远端用户掉线。 - 远端用户调用 [disableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_disablevideo) 方法关闭视频模块。 ### 参数 [#参数-8] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 用户 ID,指定是哪个用户的视频流。 视频流宽(px)。 视频流高(px)。 从本地调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 开始到该回调触发的延迟(毫秒)。 ### 所属接口类 [#所属接口类-11] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onFirstRemoteVideoFrame [#onfirstremotevideoframe] 渲染器已接收首帧远端视频回调。 ```dart final void Function(RtcConnection connection, int remoteUid, int width, int height, int elapsed)? onFirstRemoteVideoFrame; ``` :::note 注: 该回调只在 SDK 渲染时才会触发;如果用户采用自定义视频渲染则不会触发,客户需要通过 SDK 以外的方法自行实现。 ::: ### 参数 [#参数-9] 用户 ID,指定是哪个用户的视频流。 Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 视频流宽(px)。 视频流高(px)。 从本地调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 到发生此事件过去的时间(毫秒)。 ### 所属接口类 [#所属接口类-12] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onLocalVideoEvent [#onlocalvideoevent] 本地视频事件发生时触发的回调。 ```dart final void Function(VideoSourceType source, LocalVideoEventType event)? onLocalVideoEvent; ``` :::info[自从] 自 v6.6.2 版本新增。 ::: 你可以通过该回调获取本地视频事件的原因。 ### 参数 [#参数-10] 视频源类型,详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 本地视频事件类型,详见 [LocalVideoEventType](/zh-CN/api-reference/rtc/flutter/enum-localvideoeventtype)。 - `localVideoEventTypeScreenCaptureWindowHidden`:屏幕采集窗口被隐藏。 - `localVideoEventTypeScreenCaptureWindowRecoverFromHidden`:屏幕采集窗口从隐藏状态恢复。 - `localVideoEventTypeScreenCaptureStoppedByUser`:屏幕采集被用户停止。 - `localVideoEventTypeScreenCaptureSystemInternalError`:屏幕采集过程中发生系统内部错误。 - `localVideoEventTypeCameraFocalLengthApplied`:请求的广角或超广角摄像头已应用。 - `localVideoEventTypeCameraFocalLengthFallbackToDefault`:请求的广角或超广角摄像头无法打开,SDK 回退到默认摄像头。 ### 所属接口类 [#所属接口类-13] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onLocalVideoStateChanged [#onlocalvideostatechanged] 本地视频状态发生改变回调。 ```dart final void Function(VideoSourceType source, LocalVideoStreamState state, LocalVideoStreamReason reason)? onLocalVideoStateChanged;; ``` 本地视频的状态发生改变时,SDK 会触发该回调,报告当前的本地视频状态以及状态改变的原因。 :::note 注: - 帧重复检测仅针对分辨率大于 200 × 200、帧率大于等于 10 fps、码率小于 20 Kbps 的视频帧。 - 如果视频采集出现异常,正常情况下可以通过该回调的 `reason` 参数来排查问题。但在部分设备上,采集出现问题时(如卡死) Android 系统不会抛出任何错误回调,因此 SDK 无法报告本地视频状态改变的原因,此时你可以通过下列方式来判断采集是否无帧:该回调报告 `state` 为 `localVideoStreamStateCapturing` 或 `localVideoStreamStateEncoding`,且 [onLocalVideoStats](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onlocalvideostats) 回调的 `captureFrameRate` 为 0。 ::: ### 触发时机 [#触发时机] - SDK 会在如下情况触发该回调,且 `state` 为 localVideoStreamStateFailed,`reason` 为 `localVideoStreamReasonCaptureFailure`: - 应用退到后台,系统回收摄像头。 - Android 9 及以上版本,App 切后台一段时间后,系统会收回相机权限。 - Android 6 及以上版本,如果相机被第三方应用占用一段时间后释放,则 SDK 会触发该回调,并报告 [onLocalVideoStateChanged](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged)(`localVideoStreamStateCapturing,localVideoStreamReasonOk`) 回调。 - 摄像头正常启动,但连续 4 秒都没有输出采集的视频。 - 当摄像头输出采集的视频帧时,如果 SDK 检测到连续 15 个重复的视频帧,会触发该回调,且 `state` 为 `localVideoStreamStateCapturing`,`reason` 为 `localVideoStreamReasonCaptureFailure`。 ### 参数 [#参数-11] 视频源的类型。详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 本地视频状态,详见 [LocalVideoStreamState](/zh-CN/api-reference/rtc/flutter/enum-localvideostreamstate)。 本地视频状态改变原因,详见 [LocalVideoStreamReason](/zh-CN/api-reference/rtc/flutter/enum-localvideostreamreason)。 ### 所属接口类 [#所属接口类-14] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onLocalVideoStats [#onlocalvideostats] 本地视频流统计信息回调。 ```dart final void Function(RtcConnection connection, LocalVideoStats stats)? onLocalVideoStats; ``` 该回调描述本地设备发送视频流的统计信息,每 2 秒触发一次。 ### 参数 [#参数-12] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 本地视频流统计信息。详见 [LocalVideoStats](/zh-CN/api-reference/rtc/flutter/class-localvideostats)。 ### 所属接口类 [#所属接口类-15] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onRemoteVideoStateChanged [#onremotevideostatechanged] 远端视频状态发生改变回调。 ```dart final void Function( RtcConnection connection, int remoteUid, RemoteVideoState state, RemoteVideoStateReason reason, int elapsed)? onRemoteVideoStateChanged; ``` :::note 注: 频道内的用户(通信场景)或主播(直播场景)人数超过 32 人时,该回调可能不准确。 ::: ### 参数 [#参数-13] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 发生视频状态改变的远端用户 ID。 远端视频流状态,详见 [RemoteVideoState](/zh-CN/api-reference/rtc/flutter/enum-remotevideostate)。 远端视频流状态改变的具体原因,详见 [RemoteVideoStateReason](/zh-CN/api-reference/rtc/flutter/enum-remotevideostatereason)。 从本地用户调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 方法到发生本事件经历的时间,单位为毫秒。 ### 所属接口类 [#所属接口类-16] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onRemoteVideoStats [#onremotevideostats] 通话中远端视频流的统计信息回调。 ```dart final void Function(RtcConnection connection, RemoteVideoStats stats)? onRemoteVideoStats; ``` 该回调描述远端用户在通话中端到端的视频流统计信息, 针对每个远端用户/主播每 2 秒触发一次。如果远端同时存在多个用户/主播, 该回调每 2 秒会被触发多次。 ### 参数 [#参数-14] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 远端视频统计数据。详见 [RemoteVideoStats](/zh-CN/api-reference/rtc/flutter/class-remotevideostats)。 ### 所属接口类 [#所属接口类-17] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onRemoteVideoTransportStats [#onremotevideotransportstats] 通话中远端视频流传输的统计信息回调。 ```dart final void Function(RtcConnection connection, int remoteUid, int delay, int lost, int rxKBitRate)? onRemoteVideoTransportStats; ``` :::error[废弃] 弃用: 该回调已被废弃,请改用 [onRemoteVideoStats](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onremotevideostats)。 ::: 该回调描述远端用户通话中端到端的网络统计信息,通过视频包计算,用客观的数据,如丢包、 网络延迟等,展示当前网络状态。 通话中,当用户收到远端用户/主播发送的视频数据包后,会每 2 秒触发一次该回调。 ### 参数 [#参数-15] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 用户 ID,指定是哪个用户/主播的视频包。 视频包从发送端到接收端的延时(毫秒)。 视频包从发送端到接收端的丢包率 (%)。 远端视频包的接收码率(Kbps)。 ### 所属接口类 [#所属接口类-18] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onUserEnableLocalVideo [#onuserenablelocalvideo] 远端用户开/关本地视频采集回调。 ```dart final void Function(RtcConnection connection, int remoteUid, bool enabled)? onUserEnableLocalVideo; ``` :::error[废弃] 弃用: 该回调已废弃,请改用 [onRemoteVideoStateChanged](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onremotevideostatechanged) 回调的如下枚举: - `remoteVideoStateStopped`(0) 和 `remoteVideoStateReasonRemoteMuted`(5)。 - `remoteVideoStateDecoding` (2) 和 `remoteVideoStateReasonRemoteUnmuted`(6)。 ::: 该回调是由远端用户调用 [enableLocalVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablelocalvideo) 方法开启或关闭视频采集触发的。 ### 参数 [#参数-16] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 用户 ID,提示是哪个用户的视频流。 远端用户是否启用视频采集: - true: 该用户已启用视频功能。启用后,其他用户可以接收到该用户的视频流。 - false: 该用户已关闭视频功能。关闭后,该用户仍然可以接收其他用户的视频流,但其他用户接收不到该用户的视频流。 ### 所属接口类 [#所属接口类-19] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onUserEnableVideo [#onuserenablevideo] 远端用户开/关视频模块回调。 ```dart final void Function(RtcConnection connection, int remoteUid, bool enabled)? onUserEnableVideo; ``` 关闭视频功能是指该用户只能进行语音通话,不能显示、发送自己的视频,也不能接收、显示别人的视频。 该回调是由远端用户调用 [enableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_enablevideo) 或 [disableVideo](/zh-CN/api-reference/rtc/flutter/video/video-basic#api_irtcengine_disablevideo) 方法开启或关闭视频模块触发的。 ### 参数 [#参数-17] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 用户 ID,提示是哪个用户的视频流。 - true: 该用户已启用视频功能。 - false: 该用户已关闭视频功能。 ### 所属接口类 [#所属接口类-20] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onUserMuteVideo [#onusermutevideo] 远端用户取消或恢复发布视频流回调。 ```dart final void Function(RtcConnection connection, int remoteUid, bool muted)? onUserMuteVideo; ``` 当远端用户调用 [muteLocalVideoStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalvideostream) 取消或恢复发布视频流时,SDK 会触发该回调向本地用户报告远端用户的发流状况。 :::note 注: 当频道内的用户(通信场景)或主播(直播场景)的人数超过 32 人时,该回调可能不准确。 ::: ### 参数 [#参数-18] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 远端用户 ID。 远端用户是否取消发布视频流: - true: 取消发布视频流。 - false: 发布视频流。 ### 所属接口类 [#所属接口类-21] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onVideoPublishStateChanged [#onvideopublishstatechanged] 视频发布状态改变回调。 ```dart final void Function( VideoSourceType source, String channel, StreamPublishState oldState, StreamPublishState newState, int elapseSinceLastState)? onVideoPublishStateChanged; ``` ### 参数 [#参数-19] 频道名。 视频源的类型。详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 之前的发布状态,详见 [StreamPublishState](/zh-CN/api-reference/rtc/flutter/enum-streampublishstate)。 当前的发布状态,详见 [StreamPublishState](/zh-CN/api-reference/rtc/flutter/enum-streampublishstate)。 两次状态变化时间间隔(毫秒)。 ### 所属接口类 [#所属接口类-22] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onVideoSizeChanged [#onvideosizechanged] 本地或远端视频大小和旋转信息发生改变回调。 ```dart final void Function(RtcConnection connection, VideoSourceType sourceType, int uid, int width, int height, int rotation)? onVideoSizeChanged; ``` ### 参数 [#参数-20] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。 视频源的类型。详见 [VideoSourceType](/zh-CN/api-reference/rtc/flutter/enum-videosourcetype)。 图像尺寸和旋转信息发生变化的用户 ID(本地用户的 `uid` 为 0。此时视频为本地用户的视频预览)。 视频流的宽度(像素)。 视频流的高度(像素)。 旋转信息,取值范围 [0,360)。 :::note 注: 在 iOS 平台上,该参数值始终为 0。 ::: ### 所属接口类 [#所属接口类-23] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler) ## onVideoStopped [#onvideostopped] 视频功能已停止回调。 ```dart final void Function()? onVideoStopped; ``` :::error[废弃] 弃用: 请改用 [onLocalVideoStateChanged](/zh-CN/api-reference/rtc/flutter/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调中的 `localVideoStreamStateStopped`(0)。 ::: App 如需在停止视频后对 `view` 做其他处理(比如显示其他画面),可以在这个回调中进行。 ### 所属接口类 [#所属接口类-24] - [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)