enableCustomVideoRender method
- bool enable,
- ZegoCustomVideoRenderConfig config
开始或停止自定义视频渲染。
支持版本:1.9.0 及以上。
详情描述:enable 为 "true" 时开启视频自定义渲染,为 "false" 时关闭视频自定义渲染。
业务场景:使用美颜功能或 App 使用了跨平台界面框架(例如 Qt 需要有复杂层级关系的界面以实现高体验的交互)或游戏引擎(例如 Unity, Unreal Engine, Cocos)等。
默认值: 没有调用该函数时,默认关闭自定义视频渲染。
调用时机:createEngine之后,调用 startPreview
、startPublishingStream
、startPlayingStream
、createRealTimeSequentialDataManager
之前设置,且调用 logoutRoom
之后才能修改配置。
注意事项:自定义视频渲染功能可以与自定义视频采集功能同时使用,但当两者同时开启时,自定义视频渲染的本地采集帧回调将不会再被触发,开发者应该直接在自定义视频采集源里直接获取采集视频帧。
相关回调:调用 setCustomVideoRenderHandler
可设置回调用于获取视频帧数据。onCapturedVideoFrameRawData
本地预览视频帧数据回调,onRemoteVideoFrameRawData
远端拉流视频帧数据回调。
注意:此函数仅在 ZegoExpressVideo SDK 中有效!
enable
是否开启config
自定义渲染配置
Implementation
Future<void> enableCustomVideoRender(
bool enable, ZegoCustomVideoRenderConfig config) async {
return await ZegoExpressImpl.instance
.enableCustomVideoRender(enable, config);
}