跳转到主要内容
Expo 示例是一个 React Native 应用,用来快速看前置摄像头上的美肤效果。Android 和 iOS 共用同一套界面。它调用的是 Android 与 iOS SDK,不是 Web SDK。 正式接入请走 Android 或 iOS。本页只说明如何跑通示例。用 Expo 调用本 SDK 时,应用仍然必须走 prebuild。

Expo Go 和 prebuild

Expo 有两种启动方式。本 SDK 只能在 prebuild 里调用。 跑本 SDK 时,prebuild 更快。美颜计算留在原生库里。同样的工作放到 JavaScript 里会慢很多,而 Expo Go 根本调不到这个库。第一次 prebuild 比打开 Expo Go 久,因为它要编译原生应用。编译完成后,预览走的就是原生 SDK。 发布包同样是 prebuild 出来的应用,不是 Expo Go。只要 Expo 工程要调用美颜特效 SDK,就用 prebuild。

环境要求

  • Node.js:^22.13 或 ^24.3
  • Android:Android SDK,arm64 真机或模拟器,API 24 及以上
  • iOS:Mac 上的 Xcode。前置摄像头请用真机。

获取示例

克隆 GitHub 仓库,进入 demo/expo。

运行

每条命令都会先做 prebuild,生成对应平台的原生工程,再安装调试包。改了原生代码或 JavaScript 之后,再执行一次同一条命令。npx expo prebuild 只生成原生工程,之后可以用 Android Studio 或 Xcode 打开。
npx expo start 打开的是 Expo Go。这种模式加载不了本 SDK。

依赖

两个包都带 resource.fbd。示例不加载可选的 3D 和身体素材包。 示例里的凭证绑在上面的包名和 Bundle ID 上。换成自己的应用时,先在 控制台 绑定包名或 Bundle ID,再改 app.json。见 鉴权与许可证。

界面

预览是前置摄像头,竖屏、镜像。底部调节 Smooth、Tone、Rosy、Blemish、Clarity 和 Skin only。右上角是最近一帧的处理耗时。左上角是机型、相机画面尺寸、送进 SDK 的尺寸,以及屏幕上的视图尺寸。相机画面比视图小很多时,会被放大,看起来发虚。