setDummyCaptureImagePath abstract method

Future<int?> setDummyCaptureImagePath(
  1. String filePath
)

摄像头处于关闭状态时，使用静态图片填充本地推送的视频流。

可重复调用该接口来更新图片。若要停止发送图片，可传入空字符串或启用内部摄像头采集。

filePath：设置静态图片的路径。

  • 支持本地文件绝对路径，不支持网络链接，Android 端还支持 Asset 资源路径（/assets/xx.png），长度限制为 512 字节。
  • 静态图片支持类型为 JPEG/JPG、PNG、BMP。
  • 若图片宽高比与设置的编码宽高比不一致，图片会被等比缩放，黑边填充空白区域。推流帧率与码率与设置的编码参数一致。

返回值：方法调用结果

  • 0：成功
  • -1：失败

注意：

  • 本地预览无法看到静态图片。
  • 进入房间前后均可调用此方法。在多房间场景中，静态图片仅在发布的房间中生效。
  • 针对该静态图片，滤镜和镜像效果不生效，水印效果生效。
  • 只有主流能设置静态图片，屏幕流不支持设置。
  • 开启大小流后，静态图片对大小流均生效，且针对小流进行等比例缩小。

Implementation

Future<int?> setDummyCaptureImagePath(String filePath);