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 的特效参数。按参数指南选择名称与范围。
阅读文档BeautyControls.m
// Values come from your validated effect configuration.
[self.xMagicApi setEffect:effectName
effectValue:effectValue
resourcePath:nil
extraInfo:nil];特效素材
将效果加载到相机中
许可证认证成功后,通过 iOS Beauty AR SDK 应用随包特效资源。
阅读文档EffectAssets.m
// Use a compatible asset included in your license.
[self.xMagicApi setEffect:effectName
effectValue:effectValue
resourcePath:assetPath
extraInfo:nil];开始使用
开始接入 iOS Beauty AR SDK
- 01
- 02
- 03
iOS Beauty AR SDK
Podfile
# Choose the pod that matches your licensed package.
pod 'TencentEffect_S1-04'
# Then run: pod installLicenseSetup.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 的界面?
将受支持特效连接到自有预览和选择器。素材、功能支持与许可证范围必须匹配目标平台。

