tencent cloud

文档反馈

礼物特效(TUILiveKit)

最后更新时间:2024-12-19 17:08:57
    TUILiveKit 提供了两种礼物特效播放器:基础特效播放器和高级特效播放器。默认情况下,集成了基础特效播放器,若您对播放器有更高的性能要求,或期望支持更多的动画文件格式,我们还提供了高级特效播放器供您使用。

    基础特效播放器

    基础特效播放器基于 SVGA 实现,特效动画仅支持 SVGA 格式文件。
    使用基础特效播放器时,有如下3个特效动画:
    
    
    

    效果展示

    跑车
    猫咪
    汽车
    
    
    
    
    
    
    
    
    

    高级特效播放器

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

    效果展示

    爱心火箭
    冰雪城堡
    一鹿有你
    
    
    
    
    
    
    
    
    
    说明:
    高级特效播放器需单独付费,详情请发送邮件咨询: TRTC_helper@tencent.com。

    开始集成

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

    Android
    iOS
    1. 下载并解压 TUILiveKit,把Android/tceffectplayerkit 文件夹拷贝到自己的工程中,和 app 同级目录。
    
    
    
    2. 编辑您自己工程的 settings.gradle 文件,添加下面的代码:
    include ':tceffectplayerkit'
    1. 下载并解压 TUILiveKit,把iOS/TCEffectPlayerKit 文件夹拷贝到自己的工程中,和 Podfile 同级目录。
    
    
    
    2. 编辑 podfile 文件,添加下面的代码:
    pod 'TCEffectPlayerKit',:podspec => './TCEffectPlayerKit/TCEffectPlayerKit.podspec'
    3. 终端执行 pod install 命令。

    步骤二:鉴权

    1. 申请授权,得到 LicenseUrlLicenseKey。详情请发送邮件咨询: TRTC_helper@tencent.com。
    2. 在您的业务初始化的地方(默认可在 登录 的 相同位置),添加如下鉴权代码,并替换您申请的 LicenseUrlLicenseKey
    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 可在 AppDelegatedidFinishLaunchingWithOptions 方法中设置相关内容。
    //
    // 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)")
    }
    
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持