礼物播放组件 (GiftPlayer) 提供了两种礼物特效播放器:基础特效播放器(默认集成)和 高级特效播放器(需额外集成)。两种播放器都支持子弹动画、全屏动画和点赞动画的播放。
说明:
TUILiveKit 提供了两种礼物特效播放器:基础特效播放器和高级特效播放器。
基础特效播放器已默认集成在 TUILiveKit 中,无需额外配置,支持播放 SVGA 格式 的动画文件
若您对播放器有更高的性能要求,或期望支持更多的动画文件格式(例如 MP4 格式),我们还提供了 高级特效播放器 供您使用。
效果展示
子弹动画 | 全屏动画 |
![]() | ![]() |
组件接入
组件使用
礼物播放器组件需要直播间信息,因此必须在观众成功进入直播间或主播创建直播间后才能使用。
初始化组件
礼物展示组件
GiftPlayView
自身会接收并播放礼物消息。您只需要创建 GiftPlayView
实例并将其添加到您的视图层级中。let giftPlayView = GiftPlayView(groupId: roomId)// ...此处将giftPlayView添加到您的父视图上并调整布局
监听礼物收发消息
若需要获取接收礼物的回调信息,可实现
GiftPlayView
的 GiftPlayViewDelegate
中的 onReceiveGift
函数。import TUIGiftfunc giftPlayView(_ giftPlayView: GiftPlayView, onReceiveGift gift: TUIGift, giftCount: Int, sender: TUIGiftUser, receiver: TUIGiftUser)// 自定义处理}
高级特效播放器
高级特效播放器基于腾讯特效播放器实现,支持多种格式(例如 MP4、VAP、SVGA、PAG、WebP、PAG、Lottie、PNG 等)的特效动画播放。
说明:
高级特效播放器需单独付费,详情请查看 价格总览。
高级特效播放器是 TUILiveKit 的一款插件,因此您还需要集成
tceffectplayerkit
才可使用高级特效播放器。目前高级特效播放器仅支持
Android
和 iOS
两个平台。步骤 1: 集成特效组件
1. 下载组件:把
iOS/TCEffectPlayerKit
文件夹拷贝到自己的工程中,和 Podfile
同级目录。

2. 配置
podfile
:添加下面的代码,执行 pod install
。pod 'TCEffectPlayerKit',:podspec => './TCEffectPlayerKit/TCEffectPlayerKit.podspec'
步骤 2:鉴权
在您的应用初始化位置,调用
TCMediaXBase
的方法进行鉴权。说明:
//// AppDelegate.swift//import TCMediaXfunc 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)")}