TUILiveKit 的主播开播能力基于 PusherView,为直播场景提供开箱即用的全功能界面,涵盖开播前预览、视频推流、直播互动与下播结算,可快速集成到您的应用中。集成提示:
功能概览
开播前预览:支持摄像头预览、直播标题与封面设置、美颜与音效调试、倒计时开播。
视频直播开播:组件内部完成创建直播间与推流,直播中可查看直播时长、在线观众、网络与设备状态。
直播互动与管理:支持弹幕、礼物、观众连麦等互动,并提供在线用户列表与直播间管理能力。
主播开播前预览 | 主播开播 | 主播和观众连麦 |
![]() | ![]() | ![]() |
组件说明
PusherView 是主播开播的唯一入口,构造时传入 liveID,内部按:开播前预览 → 直播中 → 下播结算,三个阶段切换界面,并自行完成摄像头预览、创建直播间、推流、连麦、弹幕礼物与下播清理。快速接入
步骤1:开通服务
步骤2:代码集成
注意:
创建
PusherView 之前,请确保已完成登录,否则开播会失败。宿主 App 需在 Info.plist 中声明
NSCameraUsageDescription、NSMicrophoneUsageDescription,并声明 audio 后台模式(UIBackgroundModes → audio,即 Target → Signing & Capabilities → Background Modes → Audio, AirPlay, and Picture in Picture)。组件会在运行时申请摄像头与麦克风权限。步骤3:接入 PusherView 开播
在您的主播开播视图控制器中创建 PusherView 并作为根视图加载:
import TUILiveKitimport UIKitfinal class PusherViewController: UIViewController {private let pusherView: PusherViewinit(liveID: String) {// 1. 创建 PusherView,构造时传入直播间 IDself.pusherView = PusherView(liveID: liveID)super.init(nibName: nil, bundle: nil)}@available(*, unavailable)required init?(coder: NSCoder) {fatalError("init(coder:) has not been implemented")}override func loadView() {// 2. 将 PusherView 作为控制器的根视图view = pusherView}override func viewDidLoad() {super.viewDidLoad()// 3. 设置退出回调:关闭预览页或退出下播结算页时触发pusherView.onExit = { [weak self] inguard let self = self else { return }if let navigationController = self.navigationController,navigationController.viewControllers.count > 1 {navigationController.popViewController(animated: true)} else {self.dismiss(animated: true)}}}}
说明:
liveID 需非空且 UTF-8 编码后不超过 48 字节;可由您的业务服务端生成,也可按自定义规则拼接(Demo 使用 live_\\(userID))。
开播由组件在用户点击开始直播后自行调用
AtomicPusher.startPush 完成;下播时先进入结算页,用户点击退出后才回调 onExit。组件会在视图加入窗口时启动预览、离开窗口时清理会话,宿主无需手动调用开播 / 下播方法。
步骤4:跳转到主播开播页面
在您需要进入主播开播页时,可参考如下代码示例:
// 跳转到主播开播页let pusherVC = PusherViewController(liveID: "您的直播间 ID")pusherVC.modalPresentationStyle = .fullScreenpresent(pusherVC, animated: false)
组件 API 说明
PusherView
PusherView 继承自 UIView,是主播开播页的唯一对外组件。方法 / 属性 | 说明 |
init(liveID: String) | 构造方法,传入直播间 ID;init(coder:) 不可用。构造时即完成连麦 Store、视频视图与状态订阅的初始化。 |
onExit: (() -> Void)? | 退出回调。用户在开播前预览页点击关闭,或在下播结算页点击退出时触发;组件会先完成会话清理。 |
开播流程与状态
组件内部按三个阶段切换界面,宿主无需也不应自行调用开播 / 下播方法:
阶段 | 说明 |
开播前预览 | 摄像头预览、标题与封面设置、美颜与音效调试;点击开播进入倒计时。 |
直播中 | 组件调用 AtomicPusher.startPush 开始推流,并展示弹幕、礼物、连麦、在线观众等互动 UI。 |
下播结算 | 下播后展示本场直播统计,用户点击退出时触发 onExit。 |
下一步
恭喜您,现在您已经成功集成了主播开播。接下来,您可以实现观众观看、直播列表、礼物系统等功能,可参考下表:
常见问题
开播后无画面?
请前往手机设置 > App > 相机,检查摄像头权限是否开启,可参考下图:

若权限已开启,请确认已完成 AtomicXCore 登录,且 liveID 非空、UTF-8 编码后不超过 48 字节。
点击开播按钮提示「未登录」?
需要自己调用创建直播间或开播接口吗?
不需要。宿主只需在
init(liveID:) 中传入直播间 ID,组件会在用户点击开播后自行调用 AtomicPusher.startPush 并接管直播间;请勿重复创建 LiveInfo 或调用 startLive / createRoom。

