Skip to content

跑通 Web 示例程序

环境要求

  • 浏览器: 支持 WebAssembly 的现代浏览器
    • Chrome 57+
    • Firefox 52+
    • Safari 11+
    • Edge 16+
  • 开发语言: JavaScript (ES6+)
  • 构建工具: 可选(Vite、Webpack、Parcel 等)

安装 SDK

通过 npm 安装:

bash
npm install facebetter

使用 ES Module(推荐):

javascript
import { 
  BeautyEffectEngine, 
  EngineConfig, 
  BeautyType, 
  BasicParam,
  ProcessMode 
} from 'facebetter';

使用 CommonJS:

javascript
const { BeautyEffectEngine, EngineConfig } = require('facebetter');

获取示例源码

克隆 github 仓库 到本地,进入 demo/web/vuedemo/web/react 目录

bash
# clone 
git clone https://github.com/pixpark/facebetter.git

# Vue 示例
cd demo/web/vue

# 或 React 示例
cd demo/web/react

配置 AppID 和 AppKey

按照 此页面 指引,获取 appIdappKey,打开 src/views/CameraPreview.vue(Vue)或 src/views/CameraPreview.jsx(React),修改配置:

javascript
const config = new EngineConfig({
  appId: 'your appId',     
  appKey: 'your appKey'
})

运行示例

安装依赖并启动开发服务器:

bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

然后在浏览器中访问显示的地址(通常是 http://localhost:5173

验证运行

  1. 打开浏览器开发者工具(F12)
  2. 查看控制台是否有错误信息
  3. 如果看到 "引擎初始化成功",说明运行正常
  4. 可以点击功能按钮测试美颜效果