Feedback

主播开播

TUILiveKit 的主播开播能力基于 PusherView,为直播场景提供开箱即用的全功能界面,涵盖开播前预览、视频推流、直播互动与下播结算,可快速集成到您的 Flutter 应用中。

功能概览

开播前预览:支持摄像头预览、直播标题与封面设置、美颜与音效调试、倒计时开播。
视频直播开播:组件内部完成创建直播间与推流,直播中可查看直播时长、在线观众、网络与设备状态。
直播互动与管理:支持弹幕、礼物、观众连麦等互动,并提供在线用户列表与直播间管理能力。
主播开播前预览
主播开播
主播和观众连麦






组件说明

PusherView 是一个 StatefulWidget,统一从 package:tencent_live_uikit/tencent_live_uikit.dart 导入,是主播开播的唯一入口。组件内部按:开播前预览 → 直播中 → 下播结算,三个阶段切换界面,并自行完成摄像头预览、创建直播间、推流、连麦、弹幕礼物与下播清理。

快速接入

步骤 1:开通服务

参考 开通服务 文档领取 TUILiveKit 体验版或开通专业版套餐。

步骤 2:代码集成

参考 准备工作 接入 TUILiveKit。

步骤 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;

@override
Widget build(BuildContext context) {
return Scaffold(
backgroundColor: Colors.black,
// 1. 评论输入条与底部安全区由组件自身处理,宿主不要压缩 body
resizeToAvoidBottomInset: 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 会自动跳转到设置页面,请您允许进入画中画模式: