Skip to main content
SDK 2.0.0。鉴权:授权与许可证。枚举取值:参数枚举

安装

创建引擎

Web 的 EngineConfig 只有下列字段,配置对象上没有 appId / appKey 鉴权三选一。Web 不支持离线 .lic
若要看到加载 / 鉴权日志,请在 init() 之前调用 setLogConfig。浏览器不支持文件日志(fileEnabled 会被忽略)。
仅本地调试:

皮肤美颜

强度范围 [0.0, 1.0]0 表示关闭。
setBeautySkinOnly(true) 后,磨皮 / 美白 / 锐化 / 红润只作用在检出的皮肤上,衣服和背景不受影响。
风格枚举见 参数枚举

美型

范围是 [-1.0, 1.0]0 为关闭。正负是相反方向(例如 FaceThin:瘦脸 / 丰颊)。完整列表:参数枚举

美妆

强度、形状、色号分开设置。强度 [0.0, 1.0]。预设见 参数枚举

滤镜与贴纸

.fbd 的 URL 或内存中的 Uint8Array 直接传给 setter。

虚拟背景与色度键

色度键只换遮罩。填充仍由 setVirtualBackgroundBlursetVirtualBackground 控制。虚化与背景图互斥。

回调

不需要关键点就不要传 onFaceLandmarks,否则每帧都会做人脸检测。

处理画面

优先用 processImage,同步返回 ImageData
input 可以是 ImageDataHTMLImageElementHTMLCanvasElementHTMLVideoElement,或 Uint8ClampedArray(此时必须传 width / height)。
  • FrameType.Video — 摄像头 / 直播(带时域平滑)
  • FrameType.Image — 静态图
processTexture(textureHandle, width, height, stride, frameType, mirrorMode) 用于自定义 GPU 纹理输入。该路径不应用镜像。 普通 Web 应用请用 processImage

性能统计

销毁

页面卸载或 React/Vue 组件销毁时必须调用。

相关文档