setDummyCaptureImagePath method

Future<void> setDummyCaptureImagePath(
  1. String filePath,
  2. ZegoPublishChannel channel
)

设置关闭摄像头时所推静态图片的路径

支持版本：2.9.0 及以上。 详情描述：设置关闭摄像头时所推静态图片的路径。开始正常推流后，调用 enableCamera(false) 时会开始推静态图片，调用 enableCamera(true) 时会结束推静态图片。 业务场景：开发者希望关闭摄像头时，显示静态图片。例如，主播退后台的时候，会主动关闭摄像头，此时观众侧需要展示主播暂时离开的图片。 调用时机：初始化引擎之后，关闭摄像头前调用本 API 进行参数配置，在关闭摄像头后，即可推静态图片。 使用限制：

  1. 图片支持类型为 JPEG/JPG、PNG、BMP、HEIF。
  2. 该接口只对 SDK 视频采集有效，对自定义视频采集不生效。
  3. 不支持图片路径是网络链接。 注意事项：
  4. 本地预览无法看到该静态图片。
  5. 外部滤镜、水印、镜像、截图都不会生效。
  6. 如果图片宽高比与设定的编码宽高比不一致，会按照编码宽高比进行裁剪。 平台差异：
  7. Windows：直接填写图片位置，如"D://dir//image.jpg"。
  8. iOS/macOS：如果是完整路径则添加 "file:" 前缀，如：@"file:/var/image.png"。资产则添加 "asset:" 前缀，如：@"asset:watermark"。
  9. Android：如果是完整路径则添加 "file:" 前缀，如："file:/sdcard/image.png"。“assets” 目录下的图片则添加 "asset:" 前缀，如："asset:watermark.png"。
  10. Flutter：如果是绝对路径则添加 "file:" 前缀，如："file:/sdcard/image.png"。“assets” 资源中的图片则添加 "flutter-asset://" 前缀，如："flutter-asset://assets/watermark.png"。
  • filePath 图片路径
  • channel 推流通道。

Implementation

Future<void> setDummyCaptureImagePath(
    String filePath, ZegoPublishChannel channel) async {
  return await ZegoExpressImpl.instance
      .setDummyCaptureImagePath(filePath, channel);
}