PreOptionCustomVideo,用于 RTCEngine.getLocalCustomVideoTrack 获取的 LocalCustomVideoTrack(向已发布轨道推送外部原始 YUV 帧)。预设通用结构(采集配置 + 推送配置)与发布阶段的 PublishCustomOptions 见 摄像头预设。
PreOptionCustomVideo
作用说明:自定义视频轨道预设,组合自定义采集参数与视频推送参数。结构定义
PreOptionCustomVideo(capture: CustomVideoCaptureOptions, publish: VideoPublishOptions)
采集配置 CustomVideoCaptureOptions
作用说明:声明外部帧源的规格,供 SDK 建立发布轨道时参考。SDK 本身不采集自定义视频,实际帧由业务侧通过LocalCustomVideoTrack.inputData 送入。
推送配置 VideoPublishOptions
作用说明:同视频发布参数结构(字段见 摄像头预设)。- 默认自定义视频预设使用
desc = TRACK_CUSTOM("custom") - 屏幕场景预设使用
desc = TRACK_SHARE("screen") - 自定义视频不使用联播,
simulcasts固定为null
内置预设
作用说明:SDK 提供两种自定义视频预设PreOptionCustomVideo.def、PreOptionCustomVideo.screen。
使用建议
- 送帧分辨率与
publish.width/publish.height保持一致,避免额外缩放开销;帧率不要超过maxFps。 - 需要以“共享”身份出现在远端时用
PreOptionCustomVideo.screen,或在publishLocalVideo时通过PublishCustomOptions(desc = TrackDesc.TRACK_SHARE.value)覆盖desc。 - 轨道实例在 SDK 内按单例缓存,重复获取会用新的
preOpt覆盖旧值,切换预设后需重新发布。 - 完整推流流程见 自定义推流。