BUILT FOR IOS
Beauty AR SDK for iOS
Bring natural retouching and face effects to native camera experiences with the Beauty AR SDK for iOS. Keep control of your capture pipeline and interface.
DEVELOPER RESOURCES
Beauty AR SDK for iOS Docs & Examples
Integration Guides
Install the Beauty AR SDK for iOS in your camera pipeline.
Examples & Source
See the product in action and explore its implementation.
A camera built for creators
Retouch camera frames before preview, recording, or a separate streaming integration.
Makeup previews that feel personal
Build a native shade picker around licensed makeup assets.
IOS BEAUTY AR CAPABILITIES
Build the camera experience your app needs
Native frame input
- Pixel buffers and textures
- Image processing APIs
Appearance controls
- Adjustable beauty effects
- Licensed makeup and stickers
Application control
- Own your camera interface
- Manage resources and lifecycle
Explore the Beauty AR SDK for iOS
Connect the APIs to your camera, controls, and effect assets.
Process your native camera frames
Pass supported frame data through the Beauty AR SDK for iOS and use the processed output in your app.
Read the Documentation// 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];Adjust effects from your own controls
Map your sliders to effect parameters in the Beauty AR SDK for iOS. Choose names and ranges from the parameter guide.
Read the Documentation// Values come from your validated effect configuration.
[self.xMagicApi setEffect:effectName
effectValue:effectValue
resourcePath:nil
extraInfo:nil];Load a look into the camera
Apply bundled effect resources through the Beauty AR SDK for iOS after license authentication succeeds.
Read the Documentation// Use a compatible asset included in your license.
[self.xMagicApi setEffect:effectName
effectValue:effectValue
resourcePath:assetPath
extraInfo:nil];CUSTOMIZATION
Your interface. Your look.
Keep the experience consistent with your application.
Design the panel around your app
Connect your native controls to the Beauty AR SDK for iOS, from a compact slider to a full effects tray.
Read the DocumentationCreate a setting that fits the moment
Add licensed background effects with the Beauty AR SDK for iOS and keep your own selection experience.
Read the DocumentationGET STARTED
Get started with the Beauty AR SDK for iOS
- 01
- 02
Add the Beauty AR SDK for iOS
Follow the platform guide to connect your project.
Follow the Integration Guide - 03
Process your first frame
Authenticate the Beauty AR SDK for iOS, load the effect resources, and process a supported camera frame.
Configure the License
# Choose the pod that matches your licensed package.
pod 'TencentEffect_S1-04'
# Then run: pod install// 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.
}
}];Beauty AR SDK for iOS FAQs
How do I install the Beauty AR SDK for iOS?
Use the CocoaPods package that matches your license, add the effect resources, and follow the current guide for linker settings and camera permission descriptions.
How does licensing work for the Beauty AR SDK for iOS?
Match the application bundle identifier to your license. Complete TELicenseCheck authentication before creating an XMagic instance.
Can the Beauty AR SDK for iOS process my existing capture output?
Yes. The processing APIs accept supported pixel-buffer, texture, raw-data, and image inputs. Check formats and orientation before connecting your capture pipeline.
Is the illustrated camera interface included?
The images show possible application designs. This page covers Core SDK integration; your application supplies its own camera controls and effects interface.
When should I release the Beauty AR SDK for iOS?
Follow the lifecycle guide when leaving the camera experience. Clear listeners and release the effect instance rather than retaining it after the camera view is closed.
How do I integrate beauty AR SDK for iOS with Swift or Objective-C?
Integrate the documented package in your Xcode project and handle app lifecycle transitions. Test on an iPhone with the permissions and capabilities used by your chosen features.
How do I test beauty AR SDK for iOS before releasing my app?
Test your licensed input and effect processing, including camera permission when used and cleanup after preview exit.
How do I customize the interface for beauty AR SDK for iOS?
Connect supported effects to your own preview and selectors. Assets, feature support and license scope must match the target platform.
iOS Beauty AR Integration Support
Talk about your application
Discuss your product, expected usage, and integration needs.
Contact SalesPut your camera experience in motion
Start building with the Beauty AR SDK for iOS and a license matched to your application.

