礼物播放组件 (GiftPlayer) 提供了两种礼物特效播放器：基础特效播放器（内置）和高级特效播放器（需额外集成）。两种播放器都支持子弹动画、全屏动画和点赞动画的播放。
说明：
TUILiveKit 提供了两种礼物特效播放器：基础特效播放器和高级特效播放器。
基础特效播放器已默认集成在 TUILiveKit 中，无需额外配置，支持播放 SVGA 格式 的动画文件
若您对播放器有更高的性能要求，或期望支持更多的动画文件格式（例如 MP4 格式），我们还提供了 高级特效播放器 供您使用。
效果展示
子弹动画 | 全屏动画 |
 |  |
组件接入
组件使用
礼物播放器组件需要直播间信息，因此必须在观众成功进入直播间或主播创建直播间后才能使用。
初始化组件
礼物展示组件
GiftPlayView 自身会接收并播放礼物消息。您只需要创建 GiftPlayView 实例并将其添加到您的视图层级中。GiftPlayView giftPlayView = new GiftPlayView(getContext());giftPlayView.init("roomId");
监听礼物收发消息
若需要获取接收礼物的回调信息，可实现
GiftPlayView 的 TUIGiftPlayViewListener 中的 onReceiveGift 函数。giftPlayView.setListener(new GiftPlayView.TUIGiftPlayViewListener() {@Overridepublic void onReceiveGift(Gift gift, int giftCount, GiftUser sender, GiftUser receiver) {}@Overridepublic void onPlayGiftAnimation(GiftPlayView view, Gift gift) {}});
高级特效播放器
高级特效播放器基于腾讯特效播放器实现，支持多种格式（例如 MP4、VAP、SVGA、PAG、WebP、PAG、Lottie、PNG 等）的特效动画播放。
说明：
高级特效播放器需单独付费，详情请查看价格总览。
高级特效播放器是 TUILiveKit 的一款插件，因此您还需要集成
tceffectplayerkit 才可使用高级特效播放器。目前高级特效播放器仅支持
Android 和 iOS 两个平台。步骤 1： 集成特效组件
1. 下载组件：下载
Android/tceffectplayerkit 文件夹到您的工程根目录。
2. 配置 Gradle：在 settings.gradle.kts（或 settings.gradle）中添加
include ':tceffectplayerkit'。include ':tceffectplayerkit'
include ':tceffectplayerkit'
步骤 2：鉴权
在您的应用初始化位置，调用
TCMediaXBase 的方法进行鉴权。说明：
TCMediaXBase.getInstance().setLicense(context,"LicenseUrl", // 请替换 LicenseUrl"LicenseKey", // 请替换 LicenseKeynew ILicenseCallback() {@Overridepublic void onResult(int error, String message) {Log.i("TCMediaXBase", "setLicense result: " + error + " " + message);}});
