主播开播
TUILiveKit 的主播开播能力基于 PusherView,为直播场景提供开箱即用的全功能界面,涵盖开播前预览、视频推流、直播互动与下播结算,可快速集成到您的 Flutter 应用中。功能概览
开播前预览:支持摄像头预览、直播标题与封面设置、美颜与音效调试、倒计时开播。
视频直播开播:组件内部完成创建直播间与推流,直播中可查看直播时长、在线观众、网络与设备状态。
直播互动与管理:支持弹幕、礼物、观众连麦等互动,并提供在线用户列表与直播间管理能力。
主播开播前预览 | 主播开播 | 主播和观众连麦 |
| | |
组件说明
PusherView 是一个 StatefulWidget,统一从 package:tencent_live_uikit/tencent_live_uikit.dart 导入,是主播开播的唯一入口。组件内部按:开播前预览 → 直播中 → 下播结算,三个阶段切换界面,并自行完成摄像头预览、创建直播间、推流、连麦、弹幕礼物与下播清理。快速接入
步骤 1:开通服务
步骤 2:代码集成
步骤 3:接入 PusherView 开播
在您的主播开播页中创建 PusherView:
import 'package:flutter/material.dart';import 'package:tencent_live_uikit/tencent_live_uikit.dart';class PusherPage extends StatelessWidget {const PusherPage({super.key, required this.liveID});final String liveID;@overrideWidget build(BuildContext context) {return Scaffold(backgroundColor: Colors.black,// 1. 评论输入条与底部安全区由组件自身处理,宿主不要压缩 bodyresizeToAvoidBottomInset: false,body: PusherView(// 2. 传入直播间 ID(必填)liveID: liveID,// 3. 设置退出回调:关闭预览页或退出下播结算页时触发onExit: () {final NavigatorState navigator = Navigator.of(context);if (navigator.canPop()) {navigator.pop();}},),);}}
说明:
liveID 需非空且 UTF-8 编码后不超过 48 字节;可由您的业务服务端生成,也可按自定义规则拼接(Demo 使用
live_$userID)。开播由组件在用户点击开始直播后自行调用
AtomicPusher.startPush 完成;下播时先进入结算页,用户点击退出后才回调 onExit。系统返回键由组件内的
PopScope 处理,只释放会话,不会回调 onExit;如需统一返回逻辑,请在 onExit 以及宿主路由层分别处理。组件会在退到后台时停止预览、回到前台后恢复,宿主无需手动管理采集生命周期。
步骤 4:跳转到主播开播页面
在您需要进入主播开播页时,可参考如下代码示例:
import 'package:flutter/material.dart';import 'pusher_page.dart';void enterPusherPage(BuildContext context, String liveID) {Navigator.of(context).push(MaterialPageRoute<void>(builder: (_) => PusherPage(liveID: liveID),fullscreenDialog: true,),);}
组件 API 说明
PusherView
PusherView 是一个 StatefulWidget,是主播开播页的唯一对外组件。属性 | 说明 |
liveID(必填) | 直播间 ID,非空且 UTF-8 编码后不超过 48 字节;组件据此创建连麦 Store 与视频视图。 |
onExit | VoidCallback?, 用户在开播前预览页点击关闭,或在下播结算页点击退出时触发;组件会先释放会话。 |
开播流程与状态
组件内部按三个阶段切换界面,宿主无需也不应自行调用开播 / 下播方法:
阶段 | 说明 |
开播前预览 | 摄像头预览、标题与封面设置、美颜与音效调试;点击开播进入倒计时。 |
直播中 | 组件调用 AtomicPusher.startPush 开始推流,并展示弹幕、礼物、连麦、在线观众等互动 UI。 |
下播结算 | 下播后展示本场直播统计,用户点击退出时触发 onExit。 |
说明:
PusherView 未暴露
controller、startLive、endLive、createRoom 等公开 API,也没有对外状态枚举;开播与下播全部由组件内部驱动。下一步
恭喜您,现在您已经成功集成了 主播开播 。接下来,您可以实现观众观看、直播列表等功能,可参考下表:
常见问题
开播后无画面?
请前往手机设置 > App > 相机,检查摄像头权限是否开启,可参考如下示例:
iOS | Android |
| |
开播提示“未登录”?
App 退后台无法进入应用外浮窗(画中画)模式?
如果是 Android 平台,在您打开画中画开关后,还会自动检测 App 的系统画中画模式开关状态,如果没有打开,App 会自动跳转到设置页面,请您允许进入画中画模式:
