更新记录

1.1(2023-11-15)

美颜适配腾讯短视频、即构音视频、融云音视频、LivePusher直播推流(仅android端)多个平台。

1.0(2022-11-10)

新版发布


平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 14.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 17

原生插件通用使用流程:

  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、相芯美颜插件对象

//相芯美颜美颜插件对象
var FaceUnity = uni.requireNativePlugin("FaceUnity-Beauty")

2、初始化相芯美颜

//初始化相芯美颜,初始化调用一次即可
var authpack = "";//如果没有美颜证书,可以联系qq:16792999协助申请测试证书
var config = {
    type:"trtc"//美颜适配平台,trtc:腾讯音视频,txugc:腾讯短视频,livepusher:uniapp官方LivePusher(直播推流),zego:即构音视频,rongcloud:融云音视频
};//配置,默认适配腾讯音视频
FaceUnity.initFaceUnity(authpack, config);

3、开启或关闭美颜

//开启或关闭美颜
FaceUnity.setBeautyEnable(true);//true美颜开 false美颜关

4、切换前后摄像头

//切换前后摄像头
FaceUnity.switchCamera(true);//true:前置摄像头 false:后置摄像头

5、监听美颜配置菜单显示和隐藏

//监听美颜配置菜单显示和隐藏
FaceUnity.setBeautyCallback(function(res){
    console.log(res);
    if (res.type == "onShowBeautyMenuView") {
        //显示
    } else if (res.type == "onHideBeautyMenuView") {
        //隐藏
    }
});

6、显示美颜配置菜单

//显示美颜配置菜单
FaceUnity.showBeautyMenuView();

7、隐藏美颜配置菜单

//隐藏美颜配置菜单
FaceUnity.hideBeautyMenuView();

8、设置美颜配置参数

//设置美颜配置参数
FaceUnity.setBeauty({
    //设置美肤
    blurIntensity:4.2,//精细磨皮,范围[0-6]
    colorIntensity:0.3,//美白,范围 [0-2]
    redIntensity:0.3,//红润,范围 [0-2]
    sharpenIntensity:0.2,//锐化,范围 [0-1]
    faceThreeIntensity:0,//五官立体,范围 [0-1]
    eyeBrightIntensity:0,//亮眼,范围 [0-1]
    toothIntensity:0,//美牙,范围 [0-1]
    removePouchIntensity:0,//去黑眼圈,范围 [0-1]
    removeLawPatternIntensity:0,//去法令纹,范围 [0-1]
    //设置美型
    cheekThinningIntensity:0,//瘦脸,范围[0-1]
    cheekVIntensity:0.5,//V脸,范围 [0-1]
    cheekNarrowIntensity:0,//窄脸,范围 [0-1]
    cheekShortIntensity:0,//短脸,范围 [0-1]
    cheekSmallIntensity:0,//小脸,范围 [0-1]
    cheekBonesIntensity:0,// 瘦颧骨,范围 [0-1]
    lowerJawIntensity:0,//瘦下颌骨,范围 [0-1]
    eyeEnlargingIntensity:0.4,//大眼,范围 [0-1]
    eyeCircleIntensity:0,//圆眼,范围 [0-1],0.0 到 1.0 变强
    chinIntensity:0.3,//下巴,范围 [0-1],0-0.5是变小,0.5-1是变大
    forHeadIntensity:0.3,//额头,范围[0-1],0-0.5 是变小,0.5-1 是变大
    noseIntensity:0.5,//瘦鼻,范围 [0-1]
    mouthIntensity:0.4,//嘴型,范围 [0-1],0-0.5是变小,0.5-1是变大
    lipThickIntensity:0.5,//嘴巴厚度,范围 [0-1],默认0.5
    eyeHeightIntensity:0.5,//眼睛高度,范围 [0-1],默认0.5
    canthusIntensity:0,//开眼角,范围 [0-1],0.0 到 1.0 变强
    eyeLidIntensity:0,//眼睑, 范围 [0-1],0.0 到 1.0 变强
    eyeSpaceIntensity:0.5,//眼距,范围 [0-1],0.5-0.0 变长,0.5-1.0 变短 
    eyeRotateIntensity:0.5,//眼睛角度,范围 [0-1],0.5-0.0 逆时针旋转,0.5-1.0 顺时针旋转
    longNoseIntensity:0.5,//长鼻,范围 [0-1],0.5-0.0 变短,0.5-1.0 变长
    philtrumIntensity:0.5,//缩人中,范围 [0-1],0.5-1.0 变长,0.5-0.0 变短
    smileIntensity:0,//微笑嘴角,范围 [0-1],0.0 到 1.0 变强
    browHeightIntensity:0.5,//眉毛上下, 范围 [0-1],0.5 到 0.0 向上,0.5 到 1.0 向下, 默认0.5
    browSpaceIntensity:0.5,//眉毛间距, 范围 [0-1],0.5 到 0.0 变小,0.5 到 1.0 变大, 默认0.5
    browThickIntensity:0.5,//眉毛粗细, 范围 [0-1],默认0.5
    //设置滤镜
    filterName:"ziran1",//滤镜名称,origin=原图 ziran1=自然1 zhiganhui1=质感灰1 bailiang1=白亮1 fennen1=粉嫩1 lengsediao1=冷色调1
    filterIntensity:0.8//设置滤镜强度,0-1
});

9、获取美颜配置参数

//获取美颜配置参数
var beautyData = FaceUnity.getBeauty();
console.log(beautyData);

隐私、权限声明

1. 本插件需要申请的系统权限列表:

相机 麦克风

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件自身不采集任何数据,插件使用的SDK采集数据,详情参考:https://www.faceunity.com/

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问