准备工作
1. 在 微信公众平台 注册并登录小程序。
3. 符合接入要求，申请插件并申请试用视立方 WEBAR，详见 腾讯云视立方控制台。
接入配置
1. 使用组件前需在 uniapp 工程的
manifest.json中声明插件：{"mp-weixin": {"plugins": {"webarPlugin": {"version": "1.0.1","provider": "wx04445cff065100ed"}}}}
2. 在 uniapp 项目根目录安装 npm 包: tencentcloud-webar-wx
npm install tencentcloud-webar-wx
使用 WebArPusher 组件接入美颜
设置美颜、滤镜、美妆、贴纸
1. 在引入组件的页面的
.vue文件中使用组件。<template><view><WebArPusherenableVideoCustomRenderautopush:url="pushUrl":licenseKey="licenseKey":appId="appId":authFunc="authFunc":plugin3d="plugin3d"@created="onArCreated"my-style="width: 100vw; height: 100vh"class="webar"/></view></template><script>import WebArPusher from "tencentcloud-webar-wx/WebArPusher/WebArPusher.vue";export default {components: {WebArPusher,// 此处A需大写},methods: {// 此事件会返回 webarContext 实例，通过该实例调用 webar sdk的美颜方法。onArCreated(sdk) {const webarContext = sdk.detail || sdk; // uniapp 下事件有可能有detail也有可能没有// 设置美颜webarContext.setBeautify({whiten: 0.5,dermabrasion: 0.6,});// 设置滤镜webarContext.setFilter(id, 1);// 设置美妆、特效、贴纸webarContext.setEffect([{ id, intensity: 1 }]);},},};</script>
设置虚拟背景
1. 在引入组件的页面的
.vue文件中使用组件。<template><view><WebArPushercustom-effectautopush:url="pushUrl":licenseKey="licenseKey":appId="appId":authFunc="authFunc":plugin3d="plugin3d":background="backgroundUrl"@created="onArCreated"my-style="width: 100vw; height: 100vh"class="webar"/></view></template>
注意1. WebArPusher 分为 美颜特效 和 虚拟背景，开启 enableVideoCustomRender 即为 美颜特效 模式，开启 custom-effect 即为 虚拟背景，两者不可同时使用。2. WebArPusher 美颜特效模式仅支持 云直播接入，trtc 暂不支持。
组件美颜特效属性说明
属性 | 类型 | 默认值 | 必填 | 说明 |
licenseKey | string | "" | 是 | 腾讯云视立方 licenseKey |
appId | string | "" | 是 | 腾讯云 appid |
authFunc | async function | null | 是 | |
plugin3d | function | null | 否 | 3d 特效插件，开启 3d 贴纸时需传入 |
beautify | Object | null | 否 | 初始美颜参数，取值范围：0 - 1，可用： whiten、dermabrasion、lift、shave、eye、chin |
my-style | string | '' | 否 | 样式属性，同 style，vue3 项目需使用 |
background | string | '' | 否 | 虚拟背景图片 url，域名需加入小程序白名单 |
created | event | null | 否 | 腾讯特效 SDK 初始化完成事件 |
ready | event | null | 否 | 腾讯特效 SDK 加载完成事件 |
error | event | null | 否 | 腾讯特效 SDK 错误事件 |
webarContext 实例方法
鉴权方法 authFunc 生成方式
const config = {appid: '您的腾讯云APPID',token: '您的Token',}const authFunc = async function() {const timestamp = Math.round(new Date().getTime() / 1000);const signature = sha256(timestamp + config.token + config.appid + timestamp).toUpperCase();return { signature, timestamp };
