Docs Overview/
iOS/

iOS

TUILiveKit 提供了两种礼物特效播放器：基础特效播放器和高级特效播放器。默认情况下，集成了基础特效播放器，若您对播放器有更高的性能要求，或期望支持更多的动画文件格式，我们还提供了高级特效播放器供您使用。

基础特效播放器

基础特效播放器基于 SVGA 实现，特效动画仅支持 SVGA 格式文件。
使用基础特效播放器时，默认自带如下3个特效动画：


效果展示

跑车
猫咪
汽车










高级特效播放器

TUILiveKit高级特效播放器采用腾讯特效播放器，支持多种格式的特效动画（如：vap、Lottie、mp4、svga 等）。
使用高级特效播放器时，默认自带如下8个特效动画：




效果展示

爱心火箭
冰雪城堡
一鹿有你









说明：
高级特效播放器需单独付费，详情请发送邮件咨询：TRTC_helper@tencent.com。

开始集成

步骤一：集成 TCEffectPlayerKit

1. 下载并解压 TUILiveKit，把iOS/TCEffectPlayerKit 文件夹拷贝到自己的工程中，和 Podfile 同级目录。



2. 编辑 podfile 文件，添加下面的代码：
    pod 'TCEffectPlayerKit',:podspec => './TCEffectPlayerKit/TCEffectPlayerKit.podspec'
3. 终端执行 pod install 命令。

步骤二：鉴权

1. 申请授权，得到 LicenseURL 和 LicenseKEY。详情请发送邮件咨询：TRTC_helper@tencent.com。
2. 在相关业务模块的初始化代码中设置 URL 和 KEY。如 iOS 可在 AppDelegate 的 didFinishLaunchingWithOptions 方法中设置相关内容。
//
//  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)")
}