更新记录

2.0.0（2024-07-18） 下载此版本

新增iOS支持

1.0.1（2024-06-24） 下载此版本

1. 接入即构RTC
2. 接入相芯美颜8.0
3. 更新采集数据说明

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

相芯美颜插件接口文档

1、相芯美颜插件对象

//相芯美颜美颜插件对象
const ZgUniFUBeauty = uni.requireNativePlugin('Zego-ZGUniFaceBeautifier_ZGUniFaceBeautifier');

2、初始化相芯美颜

初始化即构RTC自定义帧处理与相芯美颜，如下init与register两个函数：

/***
 * 先调用init
 */
static init() {
    console.log("初始化即构RTC自定义视频帧处理")
    return new Promise((resolve) => {
        ZgUniFUBeauty.init((code) => {
            resolve(code);
        });
    });

}
/**
 * 注册相信美颜
 * 需要拥有相芯颁发的鉴权证书才能正常使用SDK的功能
 * @param authPackage 相芯提供的鉴权数据，将 iOS 鉴权数据 {} 内的所有数据复制到 js 的数组中，然后传入
 * @returns
 */
static register(authPackage) {
    console.log("注册相芯美颜") 
    return new Promise((resolve) => {
        ZgUniFUBeauty.registerFU(authPackage, (code) => {
            resolve(code);
        });
    });
}

3、开启或关闭美颜

/**
 * 打开美颜
 */
static openBeauty() {
    return new Promise((resolve) => {
        ZgUniFUBeauty.openBeauty((code) => {
            resolve(code);
        });
    });

}

/**
 * 关闭美颜
 */
static closeBeauty() { 
    return new Promise((resolve) => {
        ZgUniFUBeauty.closeBeauty((code) => { 
            resolve(code);
        });
    });

}

4、美颜相关参数

设置美颜参数与获取美颜参数

/**
    * 重置美颜参数
    */
static reset() {
    ZgUniFUBeauty.reset();
}

/**
    * 设置美颜参数
    */
static updateParamIntensity(key, value) {

    return new Promise((resolve, reject) => {
        if (!key) {
            reject("invalid key")
        } else {
            ZgUniFUBeauty.updateParamIntensity(key, value, (code) => {
                resolve(code);
            });
        }
    });
}

/**
    * 获取美颜参数
    */
static getParamIntensity(key) {
    return new Promise((resolve, reject) => {
        if (!key) {
            reject("invalid key")
        } else {
            ZgUniFUBeauty.getParamIntensity(key, (code) => {
                resolve(code);
            });
        }
    });
}

5、 滤镜相关

设置滤镜与获取滤镜参数

/**
 * 更新滤镜参数
 */
static updateFilterIntensity(intensity) {
    return new Promise((resolve, reject) => {
        ZgUniFUBeauty.updateFilterIntensity(intensity, (code) => {
            resolve(code);
        });
    });
}

/**
 * 设置滤镜参数
 */
static setFilter(key, intensity) {
    return new Promise((resolve, reject) => {
        if (!key) {
            reject("invalid key")
        } else {
            ZgUniFUBeauty.setFilter(key, intensity, (code) => {
                resolve(code);
            });
        }
    });
}

6、注意

1. 在销毁即构RTC引擎时，需要调用closeBeauty()函数关闭美颜。否则可能会在下次重新启动即构RTC引擎时因绑定的引擎不一致导致美颜不生效。
2. 需要配合ZEGO 即构实时音视频 SDK（插件地址）一起使用。
3. 需要注册即构RTC引擎与相芯证书，本插件基于相芯8.0