Docs Overview/
iOS/

iOS

TUILiveKit provides two types of gift effect players: the basic effect player and the advanced effect player. By default, the basic effect player is integrated. If you have higher performance requirements for the player or expect support for more animation file formats, we also provide an advanced effect player for your use.

Basic Effect Player

The basic effect player is based on SVGA and supports only SVGA format files for special effect animations.
When using the basic effect player, it comes with the following three default special effect animations:





Effect Showcase

Sports car
Cat
Car










Advanced Effect Player

The TUILiveKit advanced effect player adopts the Tencent Effect Player and supports various formats of special effect animations. The advanced effect player supports various formats of effect animations, such as vap, Lottie, mp4, svga, and more.
When using the advanced effect player, it comes with the following eight default special effect animations:




Effect Showcase

Loving Rocket
Snowy Castle
Deer With You












Note：
The advanced special effects player requires a separate fee. For more details, please send an email to: TRTC_helper@tencent.com.

Integration Guide

Step 1: Integrating TCEffectPlayerKit

1. Download and extract TUILiveKit. Copy the iOS/TCEffectPlayerKit folder to your project, at the same level as the Podfile folder.



2. Please edit the Podfile and add the following code:
    pod 'TCEffectPlayerKit',:podspec => './TCEffectPlayerKit/TCEffectPlayerKit.podspec'
3. Save the changes and run pod install in the terminal to install the TCEffectPlayerKit dependency.

Step 2: Authorization

1. Apply for authorization and obtain LicenseURL and LicenseKEY, For more details, please send an email to: TRTC_helper@tencent.com.
2. Set the URL and KEY in the initialization code of the relevant business module, and configure the resources for the special effect player. For example, in iOS, you can set these in the didFinishLaunchingWithOptions method of the AppDelegate.
//
//  AppDelegate.swift
//

import TCMediaX

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { 
    TCMediaXBase.getInstance().setDelegate(self)
    TCMediaXBase.getInstance().setLicenceURL("LicenseURL", key: "LicenseKEY")
    return true
}

func onLicenseCheckCallback(_ errcode: Int32, withParam param: [AnyHashable : Any]) {
    debugPrint("[TCMediaXBase] setLicense result: errcode:\(errcode), param:\(param)")
}