即时通信 IM 礼物特效（TUILiveKit）

TUILiveKit 提供了两种礼物特效播放器：基础特效播放器和高级特效播放器。默认情况下，集成了基础特效播放器，若您对播放器有更高的性能要求，或期望支持更多的动画文件格式，我们还提供了高级特效播放器供您使用。
基础特效播放器
基础特效播放器基于 SVGA 实现，特效动画仅支持 SVGA 格式文件。
使用基础特效播放器时，有如下3个特效动画：
﻿
﻿
﻿
效果展示
跑车
猫咪
汽车
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
高级特效播放器
TUILiveKit高级特效播放器采用腾讯特效播放器，支持多种格式的特效动画（如：vap、Lottie、mp4、svga 等）。
说明：
高级特效播放器需单独付费，详情请查看腾讯特效播放器。
开始集成
步骤一：集成礼物特效组件
Android
iOS
1. 下载并解压 TUILiveKit，把Android/tceffectplayerkit 文件夹拷贝到自己的工程中，和 app 同级目录。
﻿
﻿
﻿
2. 编辑您自己工程的 settings.gradle 文件，添加下面的代码：
  include ':tceffectplayerkit'
3.  如果您只接入了高级特效播放器，没有接入高级美颜，那么请在 tceffectplayerkit/build.gradle 文件中注释一行代码：
dependencies {
    api("com.tencent.mediacloud:TCEffectPlayer:3.0.0.250") {
       // exclude group: "com.tencent.mediacloud", module: "TCXMagicAuth"
    }
    ...
}
4.  如果您的 App 开启了混淆，请在您的混淆配置里加上如下配置：
-keep class com.tcmediax.** { *; }
-keep class com.tencent.** { *; }
-keep class com.tencent.xmagic.** { *; }
-keep class androidx.exifinterface.** {*;}
1. 下载并解压 TUILiveKit，把iOS/TCEffectPlayerKit 文件夹拷贝到自己的工程中，和 Podfile 同级目录。
﻿
﻿
﻿
2. 编辑 podfile 文件，添加下面的代码：
若您未集成 高级美颜，参考如下：
  pod 'TCEffectPlayerKit', :path => '../TCEffectPlayerKit/TCEffectPlayerKit.podspec'
  pod 'TCMediaX', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.0.246/TCMediaX.podspec'
  pod 'TCEffectPlayer', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.0.246/TCEffectPlayer.podspec'
  pod 'YTCommonXMagic', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/YTCommonXMagic_1.1/YTCommonXMagic.podspec'
若您集成了 高级美颜，参考如下：
  pod 'TCEffectPlayerKit/Beauty', :path => '../TCEffectPlayerKit/TCEffectPlayerKit.podspec'
  pod 'TCMediaX', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.0.246/TCMediaX.podspec'
  pod 'TCEffectPlayer', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.0.246/TCEffectPlayer.podspec'
3. 终端执行 pod install 命令。
步骤二：鉴权
1. 申请授权，得到 LicenseUrl 和 LicenseKey。详情请发送邮件咨询： TRTC_helper@tencent.com。
2. 在您的业务初始化的地方，添加如下鉴权代码，并替换您申请的 LicenseUrl 和 LicenseKey：
如：
Android
iOS
  TCMediaXBase.getInstance().setLicense(context,
        "LicenseUrl", // 请替换 LicenseUrl     
        "LicenseKey", // 请替换 LicenseKey
        new ILicenseCallback() {
            @Override
            public void onResult(int error, String message) {
                Log.i("TCMediaXBase", "setLicense result: " + error + " " + message);
            }
        });
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)")
}
﻿
礼物特效（TUILiveKit）

本页目录：

基础特效播放器

效果展示

高级特效播放器

开始集成

步骤一：集成礼物特效组件

步骤二：鉴权
