组件名称 | 类名 | 功能描述 |
礼物选择面板 | GiftSendWidget | 点击后自动弹出礼物列表面板,处理用户的点击选择和发送事件。 |
礼物播放组件 | GiftPlayWidget | 负责接收礼物消息,并在屏幕上渲染对应的动画特效(例如 SVGA 动画)。 |
礼物面板 | 弹幕礼物 | 全屏礼物 |
![]() | ![]() | ![]() |
GiftSendWidget 是一个图标按钮入口,点击后自动弹出礼物列表面板。import 'package:flutter/material.dart';import 'package:live_uikit_gift/live_uikit_gift.dart';class YourAnchorPage extends StatefulWidget {final String liveId;const YourAnchorPage({super.key, required this.liveId});@overrideState<YourAnchorPage> createState() => _YourAnchorPageState();}class _YourAnchorPageState extends State<YourAnchorPage> {// 1. 创建 GiftListController:roomId 传入直播间IDlate final GiftListController _giftListController = GiftListController(roomId: widget.liveId,language: 'zh', // 礼物名称语言:'zh' / 'en' 等);@overridevoid initState() {super.initState();// 2. 监听送礼成功回调(可选)_giftListController.onSendGiftCallback = (gift, count) {debugPrint('Sent gift: ${gift.name} x$count');};}@overrideWidget build(BuildContext context) {return Scaffold(body: SafeArea(child: Stack(children: [// ... 其他直播间元素 ...// 3. 接入 GiftSendWidget:点击图标会弹出礼物面板Positioned(bottom: 12,right: 16,child: GiftSendWidget(controller: _giftListController,),),],),),);}}
GiftPlayWidget 是一个透明的覆盖层,用于播放礼物动画。它通常覆盖在视频画面的上方,但位于交互按钮的下方。import 'package:flutter/material.dart';import 'package:live_uikit_gift/live_uikit_gift.dart';import 'package:tencent_live_uikit/common/index.dart';class YourAnchorPage extends StatefulWidget {final String liveId;const YourAnchorPage({super.key, required this.liveId});@overrideState<YourAnchorPage> createState() => _YourAnchorPageState();}class _YourAnchorPageState extends State<YourAnchorPage> {// 1. 创建 GiftPlayController:roomId 传入直播间IDlate final GiftPlayController _giftPlayController = GiftPlayController(roomId: widget.liveId,language: 'zh', // 礼物名称语言:'zh' / 'en' 等);@overrideWidget build(BuildContext context) {return Scaffold(body: SafeArea(child: Stack(children: [// ... 其他直播间元素 ...// 2. 接入 GiftPlayWidgetPositioned(width: 1.screenWidth,height: 1.screenHeight,child: GiftPlayWidget(giftPlayController: _giftPlayController,),),],),),);}}
文档反馈