更新记录

1.0.0（2026-08-26）

首发（UTS 插件）

正式发布百技速推美颜引擎 UTS 插件（插件 ID：sutuyun-BeautyEngin）。

本版本能力

1. 官方 UTS 格式：可正常上架付费（不再使用已停收的 App 原生语言插件通道）。
2. 基础美颜：磨皮、美白、红润，支持 0~100 精细调节。
3. 塑形调节：瘦脸、大眼等参数（Android 完整端侧；iOS API 对齐）。
4. 滤镜：支持滤镜 key 与强度。
5. 批量参数：setBeautyParams 一次下发多参数。
6. 生命周期：initEngine / warmupBeautyEngines / getBeautyBackend / releaseEngine / ping。
7. 调用方式：import { ... } from '@/uni_modules/sutuyun-BeautyEngin'。

适用场景

直播开播、短视频拍摄、社交视频通话、人像形象设置。 插件可搭配后台来使用也可以不搭配后台使用的。因各种手机版本兼容问题，使用过程中有问题联系客服处理！

详细接入见 readme.md。

平台兼容性

uni-app(3.8.2)

百技速推美颜引擎（UTS 插件）

面向 uni-app / uni-app x 的 端侧实时美颜 UTS 插件，适合直播、短视频拍摄、社交视频通话、人像预览等场景。
采用 DCloud 官方推荐的 UTS 插件 格式上架（可付费、可加密、更新免审），内嵌 Android 端侧美颜引擎；购买后绑定 DCloud AppID + 应用包名，通过 云端打包 使用。无需向买家交付后台源码，也不要求买家单独开通 uniCloud。

• 插件 ID：sutuyun-BeautyEngin
• 类型：UTS 插件（不是已停收的「App 原生语言插件」）
• 调用方式：

import {
  initEngine,
  setBeautyParams,
  setFilterKey,
  getBeautyBackend,
  warmupBeautyEngines,
  releaseEngine
} from '@/uni_modules/sutuyun-BeautyEngin'

• 授权形态：普通授权版（市场加密保护算法与关键实现；不提供完整算法源码）
• 价格与包名绑定：以插件市场购买页为准

一、产品能解决什么问题

很多 App 需要「打开相机就好看」：磨皮不过度、肤色自然、五官可微调、还能叠滤镜。纯前端滤镜效果弱；整包商业美颜 SDK 又贵又重。

本插件把美颜能力沉到 App 原生层，业务侧用统一 UTS/JS API 调参，适合：

1. 直播开播页：主播预览实时美颜
2. 短视频拍摄页：拍摄过程美颜
3. 社交视频通话：调节美颜档位（与具体 RTC 的纹理衔接由宿主对接）
4. 人像预览 / 形象设置

二、功能详解

1. 基础美颜

也可用 setBeautyLevel({ beautyLevel }) 做一键档位。

2. 塑形

thinFace / bigEye 等跟脸塑形参数。
Android 为完整端侧能力；iOS API 对齐，效果持续增强。

3. 滤镜

setFilterKey({ filterKey, filterStrength })，filterKey: 'none' 关闭滤镜。

4. 批量参数（推荐）

setBeautyParams({
  smooth: 40,
  whiten: 30,
  ruddy: 10,
  thinFace: 18,
  bigEye: 12,
  filterKey: 'natural',
  filterStrength: 55
}, (res) => {
  console.log(res)
})

滑杆建议业务层节流 80~150ms。

5. 生命周期

• initEngine / warmupBeautyEngines / getBeautyBackend / releaseEngine / ping

三、平台兼容

四、接入步骤（买家）

1. 插件市场购买并绑定 AppID、Android 包名、iOS Bundle Id
2. HBuilderX 安装本插件到工程 uni_modules/sutuyun-BeautyEngin
3. 业务代码按上方 import 调用
4. 云端打包自定义基座 真机调试
5. 正式包再次云打包发布（不要直接分发自定义基座）

验收

import { initEngine, ping } from '@/uni_modules/sutuyun-BeautyEngin'

console.log(ping())
initEngine({}, (res) => {
  console.log(JSON.stringify(res))
})

五、完整示例

import {
  initEngine,
  setBeautyParams,
  warmupBeautyEngines,
  releaseEngine
} from '@/uni_modules/sutuyun-BeautyEngin'

export async function setupBeauty() {
  return new Promise((resolve) => {
    initEngine({}, (res) => {
      if (res && res.ok) {
        warmupBeautyEngines({}, () => resolve(res))
      } else {
        resolve(res || { ok: false })
      }
    })
  })
}

export function applyPreset(name) {
  const presets = {
    natural: { smooth: 35, whiten: 25, ruddy: 8, thinFace: 10, bigEye: 8, filterKey: 'none', filterStrength: 0 },
    sweet: { smooth: 45, whiten: 35, ruddy: 12, thinFace: 18, bigEye: 14, filterKey: 'natural', filterStrength: 50 },
    strong: { smooth: 60, whiten: 45, ruddy: 15, thinFace: 28, bigEye: 20, filterKey: 'natural', filterStrength: 65 }
  }
  setBeautyParams(presets[name] || presets.natural, () => {})
}

export function teardownBeauty() {
  releaseEngine({}, () => {})
}

六、权限 / 隐私 / 广告

• 权限：相机、麦克风、相册（宿主按需申请并披露）
• 数据：端侧处理，不向作者服务器上传人脸；Android 可能使用 MediaPipe 端侧推理
• 广告：无

七、授权

普通授权绑定 AppID/包名；禁止破解转售；详见 license.md。

八、FAQ

Q：和「App 原生语言插件」有什么区别？
A：原生语言插件新品已停收。本插件为 UTS 插件，可正常上架付费。

Q：为什么必须云打包？
A：付费 UTS 普通授权版由 DCloud 加密与包名校验，需云打包生效。

Q：只支持 arm64 吗？
A：是，覆盖主流真机。

Q：小程序能用吗？
A：不能。

九、版本

文档对应 1.0.0。售后以市场页与作者 QQ 为准。