GiftPlayer (iOS UIKit)

最近更新时间:2025-09-08 22:59:43

我的收藏
礼物播放组件 (GiftPlayer) 提供了两种礼物特效播放器:基础特效播放器(默认集成)高级特效播放器(需额外集成)。两种播放器都支持子弹动画、全屏动画和点赞动画的播放。
说明:
TUILiveKit 提供了两种礼物特效播放器:基础特效播放器高级特效播放器
基础特效播放器已默认集成在 TUILiveKit 中,无需额外配置,支持播放 SVGA 格式 的动画文件
若您对播放器有更高的性能要求,或期望支持更多的动画文件格式(例如 MP4 格式),我们还提供了 高级特效播放器 供您使用。

效果展示

子弹动画
全屏动画



组件接入

参见 准备工作 完成 TUILiveKit 组件接入。

组件使用

礼物播放器组件需要直播间信息,因此必须在观众成功进入直播间主播创建直播间后才能使用。

初始化组件

礼物展示组件 GiftPlayView 自身会接收并播放礼物消息。您只需要创建 GiftPlayView 实例并将其添加到您的视图层级中。
Swift
let giftPlayView = GiftPlayView(groupId: roomId)
// ...此处将giftPlayView添加到您的父视图上并调整布局

监听礼物收发消息

若需要获取接收礼物的回调信息,可实现 GiftPlayViewGiftPlayViewDelegate 中的 onReceiveGift 函数。
Swift
import TUIGift

func giftPlayView(_ giftPlayView: GiftPlayView, onReceiveGift gift: TUIGift, giftCount: Int, sender: TUIGiftUser, receiver: TUIGiftUser)
// 自定义处理
}

高级特效播放器

高级特效播放器基于腾讯特效播放器实现,支持多种格式(例如 MP4、VAP、SVGA、PAG、WebP、PAG、Lottie、PNG 等)的特效动画播放。
说明:
高级特效播放器需单独付费,详情请查看 价格总览
高级特效播放器是 TUILiveKit 的一款插件,因此您还需要集成 tceffectplayerkit 才可使用高级特效播放器。
目前高级特效播放器仅支持 AndroidiOS 两个平台。

步骤 1: 集成特效组件

1. 下载组件:把iOS/TCEffectPlayerKit 文件夹拷贝到自己的工程中,和 Podfile 同级目录。



2. 配置 podfile:添加下面的代码,执行 pod install
Swift
pod 'TCEffectPlayerKit',:podspec => './TCEffectPlayerKit/TCEffectPlayerKit.podspec'

步骤 2:鉴权

在您的应用初始化位置,调用 TCMediaXBase 的方法进行鉴权。
说明:
LicenseUrlLicenseKey 获取请查看 License 指引
Swift
//
// 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)")
}