# Tencent RTC Beauty AR — iOS > Beauty AR documentation for iOS platform. ## Core SDK ### Integration - [SDK Download](https://pre.trtc.io/document/74071.md): Tencent RTC SDK download page offers multiple editions including Basic, Advanced, and X Series Atomic Capabilities for mobile and cross-platform applications. It supports iOS and Android platforms with detailed package options and integration guides, enabling developers to select and integrate the appropriate SDK version for beautification and algorithmic features. - [Install the SDK](https://pre.trtc.io/document/60193.md): Tencent Effect Core SDK for iOS is a software development kit designed for integrating beauty effects into iOS applications. It targets developers working with iOS 10.0 or later and devices from iPhone 5 onwards. This guide provides step-by-step instructions covering environment setup, SDK import via CocoaPods or Swift Package Manager, authentication, initialization, and usage. It also details necessary post-integration configurations such as permission settings and bundle identifier adjustments to enable smooth deployment. - [Use with TEBeautyKit](https://pre.trtc.io/document/60194.md): TEBeautyKit is a UI panel library for the Tencent Effect module on iOS, designed to facilitate quick and convenient management of beauty filter features. This quickstart guide walks developers through key steps including authentication, configuring panel resource paths, initializing the TEPanView, and exporting beauty parameters. It supports integration of various resource packages with JSON configurations to customize beauty effects for different plans. - [Use with TRTC SDK](https://pre.trtc.io/document/73773.md): This guide details the integration of the TEBeautyKit library into the TRTC SDK on iOS. It is designed for developers who want to add beauty filter capabilities to their real-time communication applications. The document covers essential steps including authentication, resource setup, panel view incorporation, adapter binding for beautification, parameter change notifications, and cleanup procedures, enabling seamless use of beauty features within TRTC SDK projects. - [Use with MLVB SDK](https://pre.trtc.io/document/73774.md): The TEBeautyKit library integration guide for the Mobile Live Video Broadcasting Streaming (MLVB) SDK on iOS details the essential steps to enable beauty filter features. This quickstart guide covers authentication, resource configuration, panel initialization, adapter binding, and parameter notifications to help developers incorporate advanced beauty effects into their live video streaming applications. - [Use with UGSV SDK](https://pre.trtc.io/document/73775.md): TEBeautyKit Beauty Filter SDK for iOS provides developers with tools to integrate advanced beauty effects into video applications. This quickstart guide walks through key steps including SDK integration via CocoaPods, authenticating the beauty filter, configuring panel resource paths, initializing the custom TEPanelView, and applying beauty filters to video data. It is designed for iOS developers aiming to enhance video experiences with customizable beauty effects. ### Advanced Features - [Gesture Recognition](https://pre.trtc.io/document/60199.md): The Gesture Recognition feature for iOS is part of the Beauty AR SDK, designed to process camera OpenGL textures and output real-time gesture detection data. This guide is intended for iOS developers aiming to integrate gesture recognition into their applications. It covers enabling the gesture detection feature, setting up data callbacks, and understanding the JSON data structure returned by the SDK, which includes detailed gesture types and 2D hand point coordinates. - [Face Detection](https://pre.trtc.io/document/60198.md): The Face Recognition SDK for iOS provides APIs to detect faces, recognize 256 facial keypoints, and handle multiple face scenarios. It is designed for iOS developers integrating advanced facial analysis capabilities into their applications. The SDK supports registering event listeners to receive AI, tip, and resource events, and delivers detailed facial data callbacks per video frame in JSON format, including visibility metrics and face identification. - [Virtual Background](https://pre.trtc.io/document/60197.md): The Virtual Background feature for iOS SDK enables real-time background removal and application of customizable virtual backgrounds. This integration guide provides step-by-step instructions for iOS developers to implement virtual background effects, including setting predefined effects and configuring custom backgrounds with images or videos. It covers key method usage and parameter settings to help developers enhance their audio and video communication experience. - [Body Tracking](https://pre.trtc.io/document/74185.md): The Body Keypoints capability is part of the Tencent Effect SDK, designed to process OpenGL camera textures and output 3D body data. It is intended for developers integrating advanced body tracking features into iOS applications, enabling them to drive 3D models in Unity or implement other functionalities. The integration requires enabling the BODY_3D_POINT feature and setting up SDK event listeners to receive detailed JSON data containing body keypoints, with API methods varying between SDK versions 2.6.0 and 3.0.0. ### Best Practices - [Asset Integration](https://pre.trtc.io/document/73781.md): The BeautyAR SDK for iOS provides a quickstart guide for using filters and animation stickers through two scenarios: utilizing the TEBeautyKit UI panel library or integrating the BeautyAR SDK directly. This guide explains how to add filter images and animation folders to your project, configure JSON files for resource management, and use local or remote resources effectively to enhance beauty features in your app. - [Asset Layering](https://pre.trtc.io/document/73783.md): The Material Overlay feature in Tencent RTC allows simultaneous activation of multiple simple animation materials such as makeup or motion effects. This guide helps developers configure overlay settings on Android and iOS platforms by using the mergeWithCurrentMotion parameter to manage effect compatibility and layering. It includes key steps for setting up overlays, managing complex and simple effects, and ensuring smooth transitions between effects. - [Recommended Beauty Parameters](https://pre.trtc.io/document/73784.md): This document presents the recommended parameter settings for implementing one-click beauty effects using the Tencent RTC beautification SDK. It provides detailed parameter values for both iOS and Android platforms across various beautification presets such as Natural, Goddess, Vitality, Classic Live Stream, and more. These configurations help developers quickly apply consistent and optimized beauty effects in their applications. - [Enhanced Mode](https://pre.trtc.io/document/73785.md): The Enhanced Mode User Guide for the Beauty SDK explains how to enable and use Enhanced Mode to achieve stronger beauty effects by adjusting parameter values beyond the normal range. It provides step-by-step instructions for Android, iOS, Flutter, and uniapp platforms, including usage with TEBeautyKit UI components and direct API calls. The guide also includes recommended enhancement multipliers for different beauty items to ensure optimal results without degrading effect quality. - [EffectMode (High Performance)](https://pre.trtc.io/document/73786.md): EffectMode is a key SDK configuration parameter introduced in Tencent RTC SDK version 3.9.0 that controls performance modes. This guide provides step-by-step instructions for developers on Android, iOS, Flutter, and uniapp platforms to set EffectMode_Normal or EffectMode_Pro when creating SDK instances. It also explains how to enable high performance mode in earlier SDK versions using appropriate API calls, ensuring optimal performance for real-time audio and video processing. - [Reduce SDK Size](https://pre.trtc.io/document/60205.md): The BeautyAR SDK for iOS provides a guide to reduce package size by dynamically downloading beauty model resources and filter/motion effect assets. This guide explains how to upload resource packages to the cloud, download and extract them locally, and configure the SDK with the downloaded resources. It also details how to download filters and motion effects on demand and set their paths in the SDK, ensuring efficient resource management for mobile applications. - [Green Screen Keying v2](https://pre.trtc.io/document/73789.md): Green Screen Keying V2 is a video processing SDK that enables users to fine-tune five key parameters—similarity, smoothness, edge elimination strength, grayscale ratio, and shadow removal—to improve green screen matting quality. This guide helps users understand how to adjust these parameters to solve common issues such as incomplete removal of green screen areas, incorrect foreground matting, edge detail loss, color spill, and jagged edges, providing practical steps to achieve cleaner and more natural compositing results. - [Effect Parameters](https://pre.trtc.io/document/60207.md): The Effect Parameters document for the Beautification SDK provides detailed reference information on effect names, intensity ranges, and resource paths used to configure beautification and body beautification features. It is intended for developers integrating Tencent RTC's beautification capabilities on Android and iOS platforms, enabling precise control over various cosmetic and filter effects through defined constants and parameters. ### Asset Authoring - [Beauty AR Studio (Desktop)](https://pre.trtc.io/document/60296.md): Beauty AR Studio is a material creation tool designed for customizing 2D and 3D stickers, enabling personalized material production for integration into SDKs. Available on Windows and Mac, it offers AI modular editing, 3D model design, rich process control, and dynamic effect preview. The tool supports creating various special effects including beauty enhancements and interactive 3D effects, catering to designers aiming to produce advanced AR materials. - [Gift AR Conversion Tool](https://pre.trtc.io/document/70541.md): The Gift AR Conversion Tool is a specialized SDK for Tencent Gift AR that enables users to convert various animation formats including PNG sequences, SVGA, WebP, PAG, and Lottie into mp4 or tcmp4 files compatible with the effect player. Designed for macOS 14 and above, this guide provides detailed steps for downloading, installing, authorizing, configuring, and using the tool to generate secure effect files with Tencent Cloud credentials. - [Gift AR Preview Tool](https://pre.trtc.io/document/70542.md): Tencent Gift AR Preview Tool is a MacOS application designed for previewing animation materials in Gift AR. It enables users to quickly preview animations by entering a license key and dragging animation files into the preview area. Key operations include starting, pausing animations, and viewing detailed animation information such as duration, frame rate, width, height, and frame count. This guide provides step-by-step instructions for downloading, installing, and using the tool effectively. ### API Reference - [API Reference](https://pre.trtc.io/document/60202.md): XMagic.h is the core interface class of the Tencent Effect SDK for iOS, providing APIs to initialize the SDK, configure beauty and animation effects, process images, and manage SDK events. This documentation details static and instance methods such as initWithRenderSize, setEffect, process, and event listener registration, enabling developers to integrate advanced beautification and animation features into their iOS applications. ### Release Notes - [Release Notes](https://pre.trtc.io/document/60204.md): Tencent RTC iOS SDK release notes document version updates, bug fixes, new features, and performance improvements. It serves developers integrating or maintaining the SDK on iOS, detailing enhancements such as beauty effects, virtual makeup, background segmentation, and facial landmark detection across multiple versions. ### FAQ - [FAQ](https://pre.trtc.io/document/60209.md): This FAQ page for the iOS SDK provides developers with solutions to common problems such as Xcode build errors, filter setting issues, dSYM generation failures, authorization errors, and build system conflicts. It helps iOS developers quickly identify and resolve typical integration and runtime issues encountered during app development with Tencent RTC.