- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 组件介绍（TUICallKit）
- 开通服务（TUICallKit）
- 跑通 Demo（TUICallKit）
- 快速接入（TUICallKit）
- Chat 集成通话能力（TUICallKit）
- 界面定制（TUICallKit）
- 离线唤醒（TUICallKit）
- AI 降噪（TUICallKit）
- 虚拟背景（TUICallKit）
- 会话聊天（TUICallKit）
- 云端录制（TUICallKit）
- 更多特性（TUICallKit）
- 解决方案（TUICallKit）
- 服务端 API（TUICallKit）
- 客户端 API（TUICallKit）
- 错误码表（TUICallkit）
- 发布日志（TUICallKit）
- 常见问题（TUICallKit）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 组件介绍（TUICallKit）
- 开通服务（TUICallKit）
- 跑通 Demo（TUICallKit）
- 快速接入（TUICallKit）
- Chat 集成通话能力（TUICallKit）
- 界面定制（TUICallKit）
- 离线唤醒（TUICallKit）
- AI 降噪（TUICallKit）
- 虚拟背景（TUICallKit）
- 会话聊天（TUICallKit）
- 云端录制（TUICallKit）
- 更多特性（TUICallKit）
- 解决方案（TUICallKit）
- 服务端 API（TUICallKit）
- 客户端 API（TUICallKit）
- 错误码表（TUICallkit）
- 发布日志（TUICallKit）
- 常见问题（TUICallKit）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
功能介绍
悬浮窗功能允许主播和观众在不退出直播间的情况下，进入到小窗口模式，小窗口悬浮在屏幕上，您可以自由拖拽到合适的位置，悬浮窗内可以显示直播画面。在悬浮窗模式下，App 可以切换到别的场景或者退后台，点击悬浮窗还可以恢复到正常全屏直播界面。
使用说明
原理简介
悬浮窗的原理是，在 rootWindow 上添加视频直播的视图作为悬浮窗的内容。
快速接入
悬浮窗功能核心代码：
// 文件位置：iOS/TUILiveKit/Sources/Component/FloatWindowFloatWindow // 悬浮窗核心功能的实现目录├── FloatWindow.swift // 悬浮窗功能对外接口└── FloatView.swift // 悬浮窗View
悬浮窗数据源：
展示悬浮窗的 ViewController 需要实现如下数据源，以便悬浮窗可以拿到正确的视图数据。
protocol FloatWindowDataSource: {func getRoomId() -> String // 当前直播间的Idfunc getCoreView() -> LiveCoreView() // 悬浮窗上展示的视频Viewfunc relayoutCoreView() // 当从悬浮窗状态恢复到视图原ViewController时会触发该函数，在此重新设置视频View的布局}
使用场景及示例：
展示悬浮窗：
class ExampleViewController: UIViewController {override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {// 展示悬浮窗，当前ViewController需要实现FloatWindowDataSource// 在展示悬浮窗时，会退出当前ViewControllerFloatWindow.shared.showFloatWindow(controller: self)}}
观众点击进入房间列表的某直播间:
if FloatWindow.shared.isShowingFloatWindow() {if FloatWindow.shared.getCurrentRoomId() == liveInfo.roomInfo.roomId {// 切回到悬浮窗所在的视频直播间FloatWindow.shared.resumeLive(atViewController: self.navigationController ?? self)return} else {// 切换到其他的视频直播间FloatWindow.shared.releaseFloatWindow()}}
主播开播：
主播暂不支持悬浮窗功能，因此在开播前需要关闭已存在的悬浮窗。
if FloatWindow.shared.isShowingFloatWindow() {FloatWindow.shared.releaseFloatWindow()}
模式切换
直播场景里，模式切换过程中，您需要使用同一个
LiveCoreView 对象，用于在两种模式下展示直播内容，这样不但可以共享视图，还可以共享直播数据和状态。
如上图所示，正常模式是
LiveViewController场景，悬浮窗模式是LiveFloatWindow场景，在模式切换过程中，可以使用同一个 LiveCoreView 对象，以保证直播过程正常进行。
是
否
本页内容是否解决了您的问题？