setDummyCaptureImagePath method
@detail api
@hiddensdk(audiosdk)
@author liuyangyang
@brief 摄像头处于关闭状态时,使用静态图片填充本地推送的视频流。
调用 stopVideoCapture 接口时,会开始推静态图片。若要停止发送图片,可传入空字符串或启用内部摄像头采集。
可重复调用该接口来更新图片。
@param filePath 设置静态图片的路径。
支持本地文件绝对路径和 Asset 资源路径(/assets/xx.png),不支持网络链接,长度限制为 512 字节。
静态图片支持类型为 JPEG/JPG、PNG、BMP。
若图片宽高比与设置的编码宽高比不一致,图片会被等比缩放,黑边填充空白区域。推流帧率与码率与设置的编码参数一致。
@return
- 0: 成功。
- -2: 失败。确保传入的 filePath 为有效路径。
- -12: 本方法不支持在 Audio SDK 中使用。
@note
- 该接口只适用于 SDK 内部摄像头采集,不适用于自定义视频采集。
- 本地预览无法看到静态图片。
- 进入房间前后均可调用此方法。在多房间场景中,静态图片仅在发布的房间中生效。
- 针对该静态图片,滤镜和镜像效果不生效,水印效果生效。
- 只有主流能设置静态图片,屏幕流不支持设置。
- 开启大小流后,静态图片对大小流均生效,且针对小流进行等比例缩小。
Implementation
FutureOr<int> setDummyCaptureImagePath(String filePath) async {
return await nativeCall('setDummyCaptureImagePath', [filePath]);
}