帮你快速理解、总结文档立即下载

主播开播(iOS)

最近更新时间:2026-11-11 16:15:32
本文档已由 AI 辅助审校
我的收藏
TUILiveKit 的主播开播能力基于 PusherView,为直播场景提供开箱即用的全功能界面,涵盖开播前预览、视频推流、直播互动与下播结算,可快速集成到您的应用中。
集成提示:
本文档介绍基于 UI 组件 的开播方式(含完整交互 UI)。若您需通过 Core SDK 自行搭建主播端界面,请参考 主播开播 (Core SDK)。

功能概览

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






组件说明

PusherView 是主播开播的唯一入口,构造时传入 liveID,内部按:开播前预览 → 直播中 → 下播结算,三个阶段切换界面,并自行完成摄像头预览、创建直播间、推流、连麦、弹幕礼物与下播清理。

快速接入

步骤1:开通服务

参考 开通服务 文档开通体验版或大规模直播版套餐。

步骤2:代码集成

参考 准备工作 接入 TUILiveKit,完成 AtomicXCore 登录。
注意:
创建 PusherView 之前,请确保已完成登录,否则开播会失败。
宿主 App 需在 Info.plist 中声明 NSCameraUsageDescription、NSMicrophoneUsageDescription,并声明 audio 后台模式(UIBackgroundModes → audio,即 Target → Signing & Capabilities → Background Modes → Audio, AirPlay, and Picture in Picture)。组件会在运行时申请摄像头与麦克风权限。

步骤3:接入 PusherView 开播

在您的主播开播视图控制器中创建 PusherView 并作为根视图加载:

import TUILiveKit
import UIKit

final class PusherViewController: UIViewController {

private let pusherView: PusherView

init(liveID: String) {
// 1. 创建 PusherView,构造时传入直播间 ID
self.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] in
guard 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 = .fullScreen
present(pusherVC, animated: false)

组件 API 说明

PusherView

PusherView 继承自 UIView,是主播开播页的唯一对外组件。
方法 / 属性
说明
init(liveID: String)
构造方法,传入直播间 ID;init(coder:) 不可用。构造时即完成连麦 Store、视频视图与状态订阅的初始化。
onExit: (() -> Void)?
退出回调。用户在开播前预览页点击关闭,或在下播结算页点击退出时触发;组件会先完成会话清理。

开播流程与状态

组件内部按三个阶段切换界面,宿主无需也不应自行调用开播 / 下播方法:
阶段
说明
开播前预览
摄像头预览、标题与封面设置、美颜与音效调试;点击开播进入倒计时。
直播中
组件调用 AtomicPusher.startPush 开始推流,并展示弹幕、礼物、连麦、在线观众等互动 UI。
下播结算
下播后展示本场直播统计,用户点击退出时触发 onExit。

下一步

恭喜您,现在您已经成功集成了主播开播。接下来,您可以实现观众观看、直播列表、礼物系统等功能,可参考下表:
功能
描述
集成指引
观众观看
使用 `PlayerView` 观看单个直播间,包含拉流、进房与互动能力。
直播列表
以信息流形式展示多个直播间,支持上下滑动切换与分页加载。
礼物系统
实现自定义礼物素材配置、计费系统对接、PK 场景互动等功能。

常见问题

开播后无画面?

请前往手机设置 > App > 相机,检查摄像头权限是否开启,可参考下图:

若权限已开启,请确认已完成 AtomicXCore 登录,且 liveID 非空、UTF-8 编码后不超过 48 字节。

点击开播按钮提示「未登录」?

参考 登录指引,确认已完成登录功能接入,并在创建 PusherView 之前登录成功。

需要自己调用创建直播间或开播接口吗?

不需要。宿主只需在 init(liveID:) 中传入直播间 ID,组件会在用户点击开播后自行调用 AtomicPusher.startPush 并接管直播间;请勿重复创建 LiveInfo 或调用 startLive / createRoom。