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"。
  11. UniApp:仅支持绝对路径,需要添加 "file:" 前缀,如:"file:/sdcard/image.png"。
  • filePath 图片路径
  • channel 推流通道。

Implementation

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