专为以下场景打造:IOS

iOS Beauty AR SDK

使用 iOS Beauty AR SDK 为原生相机体验添加自然修饰和人脸特效。采集流程和界面仍由你掌控。

开发者资源

iOS Beauty AR SDK 文档与示例

为创作者打造的相机

在预览、录制或独立直播接入前修饰相机帧。

专属感十足的试妆预览

基于授权妆容素材构建原生色号选择器。

IOS BEAUTY AR 功能

构建应用所需的相机体验

原生帧输入

  • 像素缓冲与纹理
  • 图像处理 API

外观控制

  • 可调节美颜特效
  • 授权妆容和贴纸

应用控制

  • 自行掌控相机界面
  • 管理资源与生命周期

探索 iOS Beauty AR SDK

将 API 接入你的相机、控制项和特效素材。

相机帧

处理原生相机帧

将受支持的帧数据传入 iOS Beauty AR SDK,并在应用中使用处理结果。

阅读文档
FrameProcessor.m
// pixelBuffer must use the supported RGBA format.
YTProcessInput *input = [[YTProcessInput alloc] init];
input.pixelData = [[YTImagePixelData alloc] init];
input.pixelData.data = pixelBuffer;
input.dataType = kYTImagePixelData;
YTProcessOutput *output = [self.xMagicApi process:input];

个性化定制

你的界面,你的风格。

让体验与你的应用保持一致。

按应用设计面板

将原生控制项连接到 iOS Beauty AR SDK,从紧凑滑块到完整特效面板都可自行设计。

阅读文档

开始使用

开始接入 iOS Beauty AR SDK

  1. 01

    准备许可证

    使许可证与 应用标识符 匹配。

    打开 Beauty AR 控制台
  2. 02

    添加 iOS Beauty AR SDK

    按照平台指南连接您的项目。

    按照集成指南操作
  3. 03

    处理第一帧画面

    为 iOS Beauty AR SDK 完成认证、加载特效资源,并处理受支持的相机帧。

    配置许可证
iOS Beauty AR SDK
Podfile
# Choose the pod that matches your licensed package.
pod 'TencentEffect_S1-04'
# Then run: pod install
LicenseSetup.m
// Authenticate before creating the effect instance.
[TELicenseCheck setTELicense:licenseURL
                        key:licenseKey
                 completion:^(NSInteger code, NSString *message) {
  if (code == TELicenseCheckOk) {
    // Initialize XMagic with your bundled effect resources.
  }
}];

iOS Beauty AR SDK 常见问题

如何安装 iOS Beauty AR SDK?

使用与许可证匹配的 CocoaPods 包,添加特效资源,并按当前指南配置链接器设置与相机权限说明。

iOS Beauty AR SDK 的许可证如何使用?

应用 bundle identifier 必须与许可证匹配。创建 XMagic 实例前,先完成 TELicenseCheck 认证。

iOS Beauty AR SDK 能否处理现有的采集输出?

可以。处理 API 支持规定格式的像素缓冲、纹理、原始数据和图片输入。接入采集流程前,需检查格式与方向。

是否包含图示中的相机界面?

图片展示的是可实现的应用设计。本页介绍 Core SDK 接入;相机控制项和特效界面需由你的应用自行提供。

何时应该释放 iOS Beauty AR SDK?

离开相机体验时按生命周期指南操作。清除监听器并释放特效实例,避免关闭相机视图后仍保留实例。

如何通过 Swift 或 Objective-C 接入 iOS Beauty AR SDK?

在 Xcode 项目中接入文档指定的包,并处理应用生命周期切换。用 iPhone 测试所选功能使用的权限和能力。

发布应用前如何测试 iOS Beauty AR SDK?

测试许可证授权范围内的输入与特效处理,包括使用相机时的权限和退出预览后的清理。

如何定制 iOS Beauty AR SDK 的界面?

将受支持特效连接到自有预览和选择器。素材、功能支持与许可证范围必须匹配目标平台。

iOS Beauty AR 集成支持

让相机体验开始运行

使用 iOS Beauty AR SDK 和适合应用的许可证开始构建。