跳转到主要内容
本文档对应 SDK 2.0.0。鉴权见 授权与许可。美妆 / 美型枚举见 参数枚举。

环境要求

  • 浏览器:Chrome 57+、Firefox 52+、Safari 11+、Edge 16+
  • 语言:JavaScript(ES6+)或 TypeScript
  • 运行环境:HTTPS 或 localhost(摄像头需要 HTTPS 或 localhost)

安装 SDK

获取示例源码

克隆 GitHub 仓库,进入 demo/web/react:
这是 Vite + React 示例。开发时通过 file: 依赖仓库内的 SDK。

绑定域名并获取凭证

  1. 在控制台绑定 Web 域名(例如 example.com)。见 订阅服务。
  2. 复制 appId / appKey。不要写进 EngineConfig。 Web 上密钥只应放在你的服务器。
Web 不支持离线 .lic。完整说明:授权与许可。

配置示例

Demo 不在前端放密钥。页面请求自家代理 /api/facebetter/auth(见 src/fetchLicenseToken.js),再把响应交给引擎。线上代理实现见 api/facebetter/auth.js;本地开发时 Vite 会把该路径转到已部署的 Demo 代理。
生产环境请在你们自己的服务器实现同样的代理。完整步骤与 Node 示例见 授权与许可。 SDK 会在 init() 时加载运行时文件。不必把 resource.fbd 拷进 public/。可选:init({ onProgress }) 报告下载百分比。3D 贴纸需要 resource_3d.fbd,美体需要 resource_body.fbd,见 可选资源包。

运行

浏览器打开 Vite 打印的地址(一般为 http://localhost:5175)。

验证

  1. 打开开发者工具(F12)查看控制台。
  2. 如需摄像头,允许权限。
  3. 拖动美颜滑条,预览应出现磨皮 / 美型效果。

生产环境最小初始化

服务器保管 app_id / app_key 并返回 token。服务端示例见 授权与许可。