tencent cloud

实时音视频

动态与公告
产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
产品简介
产品概述
基本概念
产品功能
产品优势
应用场景
性能数据
购买指南
计费概述
免费时长说明
月订阅
现收现付
TRTC 逾期与暂停政策
常见问题解答
退款说明
新手指引
Demo 体验
视频通话 SDK
组件介绍
开通服务
跑通 Demo
快速接入
离线唤醒
会话聊天
云端录制
AI 降噪
界面定制
Chat 集成通话能力
更多特性
无 UI 集成
服务端 API
客户端 API
解决方案
错误码表
发布日志
常见问题
视频会议 SDK
组件介绍（TUIRoomKit）
开通服务（TUIRoomKit）
跑通 Demo（TUIRoomKit）
快速接入（TUIRoomKit）
屏幕共享（TUIRoomKit）
预定会议（TUIRoomKit）
会中呼叫（TUIRoomKit）
界面定制（TUIRoomKit）
虚拟背景（TUIRoomKit）
会议控制（TUIRoomKit）
云端录制（TUIRoomKit）
AI 降噪（TUIRoomKit）
会中聊天（TUIRoomKit）
机器人推流（TUIRoomKit）
更多特性（TUIRoomKit）
客户端 API（TUIRoomKit）
服务端 API（TUIRoomKit）
常见问题（TUIRoomKit）
错误码 (TUIRoomKit)
SDK更新日志（TUIRoomKit）
直播与语聊 SDK
Live 视频直播计费说明
组件介绍
开通服务（TUILiveKit）
跑通 Demo
无 UI 集成
UI 自定义
直播监播
视频直播
语聊房
高级功能
客户端 API
服务端 API
错误码
发布日志
常见问题
RTC Engine
开通服务
SDK 下载
API-Example
接入指引
API-参考手册
高级功能
AI 集成
概述
MCP 配置
Skills 配置
集成指南
常见问题
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
控制台指南
应用管理
套餐包管理
用量统计
监控仪表盘
开发辅助
解决方案
实时合唱
常见问题
迁移指南
计费相关
功能相关
UserSig 相关
应对防火墙限制相关
缩减安装包体积相关
Andriod 与 iOS 相关
Web 端相关
Flutter 相关
Electron 相关
TRTCCalling Web 相关
音视频质量相关
其他问题
旧版文档
RTC RoomEngine SDK（旧）
集成 TUIRoom (Web)
集成 TUIRoom (Android)
集成 TUIRoom (iOS)
集成 TUIRoom (Flutter)
集成 TUIRoom (Electron)
TUIRoom API 查询
实现云端录制与回放（旧）
监控仪表盘计费（旧）
协议与策略
安全合规认证
安全白皮书
信息安全说明
服务等级协议
苹果隐私策略：PrivacyInfo.xcprivacy
TRTC 政策
隐私协议
数据处理和安全协议
词汇表
文档实时音视频旧版文档RTC RoomEngine SDK（旧）房间引擎（TRTC 与媒体管理）iOSTUILiveListManager

TUILiveListManager

PDF
聚焦模式
字号
最后更新时间： 2025-07-17 18:04:00
Copyright (c) 2024 Tencent. All rights reserved.
Module: TUILiveListManager @ TUIKitEngine
Function: 直播房间列表相关接口，此页面中的函数仅支持直播房间类型(TUIRoomTypeLive)。

TUILiveListManager

TUILiveListManagerObserver

函数列表
描述
直播信息改变回调

TUILiveListManager

函数列表
描述
设置事件回调
移除事件回调
主播开播
主播关播
进入直播间
离开直播间
修改直播信息
获取直播信息
获取直播列表
开始房间视频流预加载
停止房间视频流预加载

结构体类型

函数列表
描述
直播信息
直播统计信息

onLiveInfoChanged:modifyFlag:

onLiveInfoChanged:modifyFlag:
- (void)onLiveInfoChanged:
(TUILiveInfo *)liveInfo
modifyFlag:
(TUILiveModifyFlag)modifyFlag

直播信息改变回调

参数
描述
liveInfo
直播间信息
modifyFlag
改变类型

addObserver:

addObserver:
- (void)addObserver:
(id<TUILiveListManagerObserver>)observer

设置事件回调

您可以通过 TUILiveListManagerObserver 获得直播间事件通知
参数
描述
observer
监听的实例

removeObserver:

removeObserver:
- (void)removeObserver:
(id<TUILiveListManagerObserver>)observer

移除事件回调

参数
描述
observer
监听的实例。

startLive:onSuccess:onError:

startLive:onSuccess:onError:
- (void)startLive:
(TUILiveInfo *)liveInfo
onSuccess:
(TUILiveInfoBlock)onSuccess
onError:
(TUIErrorBlock)onError

主播开播

参数
描述
liveInfo
直播信息
onError
失败回调
onSuccess
成功回调

stopLive:onError:

stopLive:onError:
- (void)stopLive:
(TUIStopLiveBlock)onSuccess
onError:
(TUIErrorBlock)onError

主播关播

参数
描述
onError
失败回调
onSuccess
成功回调

joinLive:onSuccess:onError:

joinLive:onSuccess:onError:
- (void)joinLive:
(NSString *)roomId
onSuccess:
(TUILiveInfoBlock)onSuccess
onError:
(TUIErrorBlock)onError

进入直播间

参数
描述
onError
失败回调
onSuccess
成功回调
roomId
房间 ID

leaveLive:onError:

leaveLive:onError:
- (void)leaveLive:
(TUISuccessBlock)onSuccess
onError:
(TUIErrorBlock)onError

离开直播间

参数
描述
onError
失败回调
onSuccess
成功回调

setLiveInfo:modifyFlag:onSuccess:onError:

setLiveInfo:modifyFlag:onSuccess:onError:
- (void)setLiveInfo:
(TUILiveInfo *)liveInfo
modifyFlag:
(TUILiveModifyFlag)modifyFlag
onSuccess:
(TUISuccessBlock)onSuccess
onError:
(TUIErrorBlock)onError

修改直播信息

参数
描述
liveInfo
直播信息
modifyFlag
修改标记
onError
失败回调
onSuccess
成功回调

getLiveInfo:onSuccess:onError:

getLiveInfo:onSuccess:onError:
- (void)getLiveInfo:
(NSString *)roomId
onSuccess:
(TUILiveInfoBlock)onSuccess
onError:
(TUIErrorBlock)onError

获取直播信息

参数
描述
onError
失败回调
onSuccess
成功回调
roomId
房间ID

fetchLiveList:count:onSuccess:onError:

fetchLiveList:count:onSuccess:onError:
- (void)fetchLiveList:
(NSString *)cursor
count:
(NSInteger)count
onSuccess:
(TUILiveInfoListBlock)onSuccess
onError:
(TUIErrorBlock)onError

获取直播列表

参数
描述
count
每次拉取个数
cursor
列表下标
onError
失败回调
onSuccess
成功回调
注意
获取直播间列表，单次拉取最大支持返回 50 个。

startPreloadVideoStream:isMuteAudio:view:onPlaying:onLoading:onError:

startPreloadVideoStream:isMuteAudio:view:onPlaying:onLoading:onError:
- (void)startPreloadVideoStream:
(NSString*)roomId
isMuteAudio:
(BOOL)isMuteAudio
view:
(TUIVideoView *__nullable)view
onPlaying:
(TUIPlayOnPlayingBlock)onPlaying
onLoading:
(TUIPlayOnLoadingBlock)onLoading
onError:
(TUIPlayOnErrorBlock)onError

开始房间视频流预加载

参数
描述
isMuteAudio
是否静音播放。
onError
错误回调。
onLoading
加载回调。
onPlaying
播放回调。
roomId
房间ID。
view
视频渲染视图。

stopPreloadVideoStream:

stopPreloadVideoStream:
- (void)stopPreloadVideoStream:
(NSString*)roomId

停止房间视频流预加载

参数
描述
roomId
房间ID。

TUILiveInfo

TUILiveInfo

直播信息

枚举类型
描述
activityStatus
直播间活跃状态: 用户自定义标记
backgroundUrl
直播间背景，最大支持 200 个字节
categoryList
直播间分类标签，单个房间最大支持3个标记
coverUrl
直播间封面，最大支持 200 个字节
createTime
房间创建时间（只读）。
isMessageDisableForAllUser
是否禁止发送消息（创建房间可选参数），默认值：NO。
isPublicVisible
直播间是否公开
isSeatEnabled
是否开启麦位控制。
keepOwnerOnSeat
房主开播后自动上麦
maxSeatCount
最大麦位数。
name
房间名称（创建房间可选参数，默认房间ID，最大支持100个字节）。
notice
房间公告（创建房间可选参数，最大支持100个字节）。
ownerAvatarUrl
房主头像URL: 默认为房间创建者头像URL（只读）。
ownerId
房主ID: 默认为房间创建者ID（只读）。
ownerName
房主昵称: 默认为房间创建者昵称（只读）。
roomId
房间ID (创建房间必填参数，最大支持48个字节)。
roomInfo
房间信息(废弃)
seatMode
上麦模式(只有开启麦位控制后生效)。
viewCount
累计观看次数

TUILiveStatisticsData

TUILiveStatisticsData

直播统计信息

枚举类型
描述
totalGiftCoins
送礼总金额
totalGiftsSent
送礼总个数
totalLikesReceived
点赞总数
totalUniqueGiftSenders
送礼人数
totalViewers
累计观看次数
上一篇: TUIRoomDeviceManager下一篇: TUILiveConnectionManager

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈