接入文档

Mirage Vision 实时美颜 SDK 接入指南。从申请 License 到几行代码跑通美颜，覆盖 iOS / Android 与主流 RTC。

快速开始

申请 License

License 通过 客户门户 在线申请，账号由商务开通：

1. 登录门户，首次登录请先修改初始密码；
2. 在「提交新申请」填入应用 包名 / Bundle ID（每行一个，数量不超过套餐上限）；
3. 提交后等待审核（一般 1 个工作日内）；
4. 审核通过后，在「我的申请」复制或下载每个包名对应的 license。

Android 接入

1. 配置

• 将 SDK（.aar / .so）与模型资源加入工程；
• build.gradle 的 applicationId 必须等于申请 license 的包名；
• 最低支持 Android 5.0（minSdk 21）。

2. 初始化与渲染

// 初始化授权（离线 license）
val beauty = BeautyApi(context)
beauty.init("YOUR_LICENSE") { ok ->
    if (ok) beauty.initRender()
}

// 每帧：输入纹理，返回美颜后的纹理
val outTex = beauty.renderWithTexture(
    inputTex, width, height, true /*前置*/, rotation)

// 实时调节任意美颜项
beauty.beautyModule?.setValue(SKIN_SMOOTH, 0.5f)
beauty.beautyModule?.setValue(BIG_EYE, 0.3f)

iOS 接入

1. 配置

• 通过 CocoaPods 引入 SDK 本地 Pod，并拷贝模型资源（cv.bundle）；
• Target 的 Bundle Identifier 必须等于申请 license 的包名；
• 最低支持 iOS 11。

2. 初始化与渲染

// 初始化授权
[BeautyEngine initWithLicense:@"YOUR_LICENSE"];
[BeautyEngine setupModelPath:modelBundlePath];

// 注册渲染管线 + 美颜模块
CBRenderManager *render = [[CBRenderManager alloc] init];
[render registerBeauty];

// 每帧把采集纹理交给 render 处理
GLuint outTex = [render processTexture:inputTex width:w height:h];

与 RTC 集成

SDK 输入输出均为 GPU 纹理，与 RTC 的自定义视频处理（custom video process）链路零拷贝衔接：在 RTC 采集回调里拿到原始纹理 → 交给美颜引擎 → 把返回纹理回填给 RTC 推流。主流 RTC 厂商均提供对应的示例工程。

套餐与功能

功能按套餐分级开放，可按需选择：

常见问题