文档首页/ 华为云会议 Meeting/ 客户端SDK参考/ Android SDK/ 接口参考/ 基础配置/ 设置虚拟背景默认图片
更新时间：2025-10-13 GMT+08:00
查看PDF
分享

设置虚拟背景默认图片

setVirtualBackgroundDefaultImages

接口描述

该接口用于设置虚拟背景默认图片。

注意事项

1.该接口非必需调用，若不设置，则使用默认的虚拟背景图片。

2.该接口为异步接口，返回值只代表接口是否调用成功，实际业务处理结果在对应的回调函数中返回。

3.图片格式：jpg/jpeg。

4.图片尺寸：最大4096*4096，最小160*160。

5.具备读取默认图片权限。

方法定义

1
 
void setVirtualBackgroundDefaultImages(HwmVirtualBackgroundInfo hwmVirtualBackgroundInfo);

参数描述

表1 HwmVirtualBackgroundInfo说明

参数

是否必须

类型

描述

mode

是

HwmSettingVrbkDefaultImageMode

设置虚拟背景默认图片方式，默认HwmSettingVrbkDefaultImageModeAppend。

imageList

是

List<HwmVirtualBackgroundImageInfo>

自定义虚拟背景默认图片数组
表2 枚举HwmSettingVrbkDefaultImageMode说明

参数

描述

HwmSettingVrbkDefaultImageModeReplaceAll

全部替换, 覆盖原有默认图片，最多50张。

HwmSettingVrbkDefaultImageModeAppend

追加，原有的默认图片+新增的默认图片，最多追加45张。
表3 HwmVirtualBackgroundImageInfo说明

参数

是否必须

类型

描述

imagePath

是

String

图片路径

返回值

无

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
 
        String path = FileUtil.getFileDirPath(Utils.getApp()) + File.separator + CUSTOM_VIRTUAL_BACKGROUND;
        List<HwmVirtualBackgroundImageInfo> infoList = new ArrayList<>();
        File customVirtualBackground = FileUtil.getFileByPath(path);
        if (customVirtualBackground != null && FileUtil.isFileExist(path)) {
            File[] virtualBackgroundList = customVirtualBackground.listFiles();
            if (virtualBackgroundList == null) {
                return;
            }
            for (File file : virtualBackgroundList) {
                if (file == null || !file.exists()) {
                    continue;
                }
                infoList.add(new HwmVirtualBackgroundImageInfo().setImagePath(file.getPath()));
            }
            HwmVirtualBackgroundInfo hwmVirtualBackgroundInfo = new HwmVirtualBackgroundInfo();
            hwmVirtualBackgroundInfo.setMode(replaceButton.isChecked() ? HwmSettingVrbkDefaultImageMode.HwmSettingVrbkDefaultImageModeReplaceAll
                    : HwmSettingVrbkDefaultImageMode.HwmSettingVrbkDefaultImageModeAppend);
            hwmVirtualBackgroundInfo.setImageList(infoList);
            HWMBizSdk.getBizOpenApi().setVirtualBackgroundDefaultImages(hwmVirtualBackgroundInfo);
父主题： 基础配置

相关文档