> ## Documentation Index
> Fetch the complete documentation index at: https://docs.facebetter.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 产品概述

> Facebetter 美颜特效 SDK 引擎产品概述

Facebetter 是一款面向开发者的实时美颜特效引擎，支持对图片与视频流进行高质量的 AI 美颜处理。引擎基于 GPU 渲染管线构建，具备低延迟、低 CPU 占用和高帧率的特性，可轻松集成到 Android、iOS、macOS、Web 等主流平台。

## 核心能力

### 美肤

对人脸肤质进行细腻优化，包含磨皮、美白、红润、锐化四项基础参数，各参数均支持 0–100 的强度调节，可精细控制最终效果。

### 美型

从面部轮廓到五官比例进行全方位调整：

* **脸型**：瘦脸、V脸、窄脸、短脸
* **轮廓**：瘦颧骨、瘦下颌、瘦下巴
* **五官**：瘦鼻梁、大眼、调整眼距

> 单帧画面最多支持 **5 人**同时进行美型处理。

### 美妆

提供真实感的彩妆叠加效果，包含口红（颜色与透明度可调）和腮红（多款预设色号），多个美妆项目可同时叠加。

> 单帧画面最多支持 **5 人**同时进行美妆处理。

### 滤镜与风格

内置 20+ 款基于 LUT（颜色查找表）的实时风格滤镜，涵盖人像、美食、风景、现代风等多种主题，支持强度调节与自定义 LUT 扩展。

### 虚拟背景

基于实时人像分割实现以下两种效果：

* **背景模糊**：保留前景人物，对背景应用高斯模糊
* **背景替换**：将背景替换为任意图片素材

### 贴纸特效

支持 2D 贴纸特效，包括：

* **屏幕贴纸**：固定叠加在画面指定位置
* **人脸跟随贴纸**：锁定人脸关键点，随头部动态跟随

贴纸资源以 `.fbpack` 包格式分发，支持热加载与动态切换。

### 高级能力

* **人脸关键点回调**：每帧返回 106 个人脸关键点坐标，可用于自定义特效开发与业务逻辑
* **绿幕抠图（Chroma Key）**：精准去除绿色背景，适用于直播、视频合成等场景

***

## 输入 / 输出格式

### 图像格式

| 类型     | 支持格式                                               |
| ------ | -------------------------------------------------- |
| 静态图片   | `JPEG`、`PNG`、`BMP`                                 |
| 视频帧    | `YUV I420`、`NV12`、`NV21`、`RGB`、`RGBA`、`BGR`、`BGRA` |
| GPU 纹理 | OpenGL / OpenGL ES `Texture`                       |

### 分辨率上限

| 场景     | 上限                               |
| ------ | -------------------------------- |
| 实时视频流  | `720P @ 60fps` / `1080P @ 30fps` |
| 静态图片处理 | 最高 `4K`                          |

所有格式之间均可通过统一接口进行无损转换。

***

## 性能指标

| 指标     | 数据                         |
| ------ | -------------------------- |
| 渲染延迟   | `1080P` 平均约 `10ms`（GPU 并行） |
| CPU 占用 | 实时渲染阶段 \< `5%`             |
| 内存占用   | 主要驻留于 GPU 显存，系统内存占用低       |

***

## 支持平台

| 平台类型  | 操作系统与版本                                        |
| ----- | ---------------------------------------------- |
| 移动端   | `iOS 10.0+`、`Android 5.0+`、`HarmonyOS 5.0+`    |
| 桌面端   | `macOS 10.13+`、`Windows 10+`、`Linux`           |
| Web 端 | 基于 WebAssembly，兼容 Chrome、Firefox、Safari 等现代浏览器 |

***

## 集成语言与接口

| 接口类型                | 适用场景                        |
| ------------------- | --------------------------- |
| Java / Kotlin       | Android 应用                  |
| Objective-C / Swift | iOS、macOS 应用                |
| C / C++             | 桌面端（Windows、Linux、macOS）跨平台 |
| JavaScript (WASM)   | Web 应用（浏览器与 Node.js）        |

***

## 快速开始

选择目标平台，按照对应的集成指南完成接入：

* [Android 快速开始](../android/quick-start)
* [iOS 快速开始](../ios/quick-start)
* [macOS 快速开始](../macos/quick-start)
* [Web 快速开始](../web/quick-start)