跳转到主要内容
SDK 2.0.0。鉴权:授权与许可。枚举取值:参数枚举。

安装

创建引擎

Web 的 EngineConfig 只有下列字段,配置对象上没有 appId / appKey。 引擎运行时文件在 init() 时由 SDK 加载,不必在站点根路径放 resource.fbd。可选下载进度:init({ onProgress })。引擎不会去换 token。Web 不支持离线 .lic。
若要看到加载 / 鉴权日志,请在 init() 之前调用 setLogConfig。浏览器不支持文件日志(fileEnabled 会被忽略)。

皮肤美颜

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

美型

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

美体

范围是 [0.0, 1.0]。0 关闭。先在 init() 之后拉取 resource_body.fbd 并 addResourcePack。完整列表:参数枚举。资源包:可选资源包。

美妆

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

滤镜与贴纸

把 .fbd 的 URL 或内存中的 Uint8Array 直接传给 setter。
3D 贴纸需要可选包 resource_3d.fbd(不在 Web SDK 内)。见 可选资源包。init() 之后用字节登记:

虚拟背景与色度键

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

回调

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

处理画面

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

性能统计

销毁

页面卸载或 React/Vue 组件销毁时必须调用。 接入 TRTC / 声网 / LiveKit:见 第三方对接。

相关文档