setDummyCaptureImagePath method
- String filePath,
- ZegoPublishChannel channel
设置关闭摄像头时所推静态图片的路径
支持版本:2.9.0 及以上。 详情描述:设置关闭摄像头时所推静态图片的路径。开始正常推流后,调用 enableCamera(false) 时会开始推静态图片,调用 enableCamera(true) 时会结束推静态图片。 业务场景:开发者希望关闭摄像头时,显示静态图片。例如,主播退后台的时候,会主动关闭摄像头,此时观众侧需要展示主播暂时离开的图片。 调用时机:初始化引擎之后,关闭摄像头前调用本 API 进行参数配置,在关闭摄像头后,即可推静态图片。 使用限制:
- 图片支持类型为 JPEG/JPG、PNG、BMP、HEIF。
- 该接口只对 SDK 视频采集有效,对自定义视频采集不生效。
- 不支持图片路径是网络链接。 注意事项:
- 本地预览无法看到该静态图片。
- 外部滤镜、水印、镜像、截图都不会生效。
- 如果图片宽高比与设定的编码宽高比不一致,会按照编码宽高比进行裁剪。 平台差异:
- Windows:直接填写图片位置,如"D://dir//image.jpg"。
- iOS/macOS:如果是完整路径则添加 "file:" 前缀,如:@"file:/var/image.png"。资产则添加 "asset:" 前缀,如:@"asset:watermark"。
- Android:如果是完整路径则添加 "file:" 前缀,如:"file:/sdcard/image.png"。“assets” 目录下的图片则添加 "asset:" 前缀,如:"asset:watermark.png"。
- Flutter:如果是绝对路径则添加 "file:" 前缀,如:"file:/sdcard/image.png"。“assets” 资源中的图片则添加 "flutter-asset://" 前缀,如:"flutter-asset://assets/watermark.png"。
- UniApp:仅支持绝对路径,需要添加 "file:" 前缀,如:"file:/sdcard/image.png"。
filePath
图片路径channel
推流通道。
Implementation
Future<void> setDummyCaptureImagePath(
String filePath, ZegoPublishChannel channel) async {
return await ZegoExpressImpl.instance
.setDummyCaptureImagePath(filePath, channel);
}