产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
属性名 | 类型 | 描述 |
coHostStatus | 跨房连线的实时状态。 | |
connected | 正在和当前直播间连线的主播列表。 | |
invitees | 向其他直播间发出请求的主播列表。 | |
applicant | 向当前直播间发起连线请求的主播。 | |
candidatesCursor | StateFlow<String> | 推荐用户列表游标。 |
candidates | 推荐用户列表。 |
函数名 | 描述 |
创建对象实例。 | |
连线事件回调。 | |
连线事件回调。 | |
发起连线请求。 | |
取消连线请求。 | |
接受连线请求。 | |
拒绝连线请求。 | |
退出连线。 | |
获取推荐主播列表。 |
abstract fun addCoHostListener(listener: CoHostListener?)
参数名 | 类型 | 是否必填 | 描述 |
listener | 必填 | 监听器。 |
abstract fun removeCoHostListener(listener: CoHostListener?)
参数名 | 类型 | 是否必填 | 描述 |
listener | 必填 | 监听器。 |
abstract fun requestHostConnection(targetHostLiveID: String?,layoutTemplate: CoHostLayoutTemplate,timeout: Int,extraInfo: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
targetHostLiveID | String? | 必填 | 目标主播的直播间ID。 |
layoutTemplate | 必填 | 连线布局模板。 | |
timeout | Int | 必填 | 请求超时时间(单位:秒)。 |
extraInfo | String? | 必填 | 扩展信息。 |
completion | 必填 | 发起请求成功的回调。 |
abstract fun cancelHostConnection(toHostLiveID: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
toHostLiveID | String? | 必填 | 目标主播的直播间ID。 |
completion | 必填 | 取消请求成功的回调。 |
abstract fun acceptHostConnection(fromHostLiveID: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
fromHostLiveID | String? | 必填 | 发起连线请求的主播直播间ID。 |
completion | 必填 | 接受成功的回调。 |
abstract fun rejectHostConnection(fromHostLiveID: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
fromHostLiveID | String? | 必填 | 发起连线请求的主播直播间ID。 |
completion | 必填 | 拒绝成功的回调。 |
abstract fun exitHostConnection(completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
completion | 必填 | 退出连线成功的回调。 |
abstract fun getCoHostCandidates(cursor: String,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
cursor | String | 必填 | 游标。 |
completion | 必填 | 完成回调。 |
枚举值 | 值 | 说明 |
CONNECTED | 0 | 和其他主播正在连线中。 |
DISCONNECTED | 1 | 没有和其他主播连线。 |
枚举值 | 值 | 说明 |
HOST_VOICE_CONNECTION | 2 | 语聊房连线布局。 |
HOST_DYNAMIC_GRID | 600 | 主播动态网格布局。 |
HOST_DYNAMIC_1V6 | 601 | 主播动态1对6布局。 |
方法名 | 说明 |
onCoHostRequestReceived | 当收到连线请求时触发此回调。 |
onCoHostRequestCancelled | 当连线请求被取消时触发此回调。 |
onCoHostRequestAccepted | 当连线请求被接受时触发此回调。 |
onCoHostRequestRejected | 当连线请求被拒绝时触发此回调。 |
onCoHostRequestTimeout | 当连线请求超时时触发此回调。 |
onCoHostUserJoined | 当用户加入连线时触发此回调。 |
onCoHostUserLeft | 当用户离开连线时触发此回调。 |
属性 | 类型 | 说明 |
coHostStatus | 跨房连线的实时状态。 | |
connected | 正在和当前直播间连线的主播列表。 | |
invitees | 向其他直播间发出请求的主播列表。 | |
applicant | 向当前直播间发起连线请求的主播。 | |
candidatesCursor | StateFlow<String> | 推荐用户列表游标。 |
candidates | 推荐用户列表。 |
// 创建 store 实例val store = CoHostStore.create("live_room_123")// 订阅状态变化lifecycleScope.launch {store.coHostState.coHostStatus.collect { status ->println("连线状态: $status")}}lifecycleScope.launch {store.coHostState.connected.collect { connected ->println("已连接主播: ${connected.size}")}}// 添加连线事件监听器store.addCoHostListener(object : CoHostListener() {override fun onCoHostRequestReceived(inviter: SeatUserInfo, extensionInfo: String) {println("收到来自 ${inviter.userName} 的连线请求")// 显示接受/拒绝的 UI}override fun onCoHostRequestAccepted(invitee: SeatUserInfo) {println("连线请求被 ${invitee.userName} 接受")}override fun onCoHostUserJoined(userInfo: SeatUserInfo) {println("主播 ${userInfo.userName} 加入连线")}})// 发起连线请求store.requestHostConnection(targetHostLiveID = "target_live_id",layoutTemplate = CoHostLayoutTemplate.HOST_DYNAMIC_GRID,timeout = 30,extraInfo = "",completion = { code, message ->if (code == 0) {println("连线请求发送成功")}})
文档反馈