环境要求
- 浏览器:Chrome 57+、Firefox 52+、Safari 11+、Edge 16+
- 语言:JavaScript(ES6+)或 TypeScript
- 运行环境:HTTPS 或
localhost(摄像头需要 HTTPS 或 localhost)
安装 SDK
获取示例源码
克隆 GitHub 仓库,进入demo/web/react:
file: 依赖仓库内的 SDK。
绑定域名并获取凭证
- 在控制台绑定 Web 域名(例如
example.com)。见 订阅服务。 - 复制
appId/appKey。不要写进EngineConfig。 Web 上密钥只应放在你的服务器。
.lic。完整说明:授权与许可。
配置示例
Demo 不在前端放密钥。页面请求自家代理/api/facebetter/auth(见 src/fetchLicenseToken.js),再把响应交给引擎。线上代理实现见 api/facebetter/auth.js;本地开发时 Vite 会把该路径转到已部署的 Demo 代理。
init() 时加载运行时文件。不必把 resource.fbd 拷进 public/。可选:init({ onProgress }) 报告下载百分比。3D 贴纸需要 resource_3d.fbd,美体需要 resource_body.fbd,见 可选资源包。
运行
http://localhost:5175)。
验证
- 打开开发者工具(F12)查看控制台。
- 如需摄像头,允许权限。
- 拖动美颜滑条,预览应出现磨皮 / 美型效果。
生产环境最小初始化
app_id / app_key 并返回 token。服务端示例见 授权与许可。
