产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
属性名 | 类型 | 描述 |
currentBattleInfo | 当前 PK 信息。 | |
battleUsers | PK 用户列表。 | |
battleScore | StateFlow<Map<String, Int>> | PK 分数的映射。 |
函数名 | 描述 |
创建 BattleStore 实例。 | |
新增 PK 事件回调。 | |
移除 PK 事件回调。 | |
发起 PK 请求。 | |
取消 PK 请求。 | |
接受 PK 请求。 | |
拒绝 PK 请求。 | |
退出 PK。 |
abstract fun addBattleListener(listener: BattleListener?)
参数名 | 类型 | 是否必填 | 描述 |
listener | 必填 | 监听器。 |
abstract fun removeBattleListener(listener: BattleListener?)
参数名 | 类型 | 是否必填 | 描述 |
listener | 必填 | 监听器。 |
abstract fun requestBattle(config: BattleConfig,userIDList: List<String>,timeout: Int,completion: BattleRequestCallback?)
参数名 | 类型 | 是否必填 | 描述 |
config | 必填 | PK 配置。 | |
userIDList | List<String> | 必填 | 需要进入PK的用户 ID 列表。 |
timeout | Int | 必填 | 请求超时时间。 |
completion | 必填 | 发起请求成功的回调。 |
abstract fun cancelBattleRequest(battleID: String?,userIDList: List<String>,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
battleID | String? | 必填 | PK ID。 |
userIDList | List<String> | 必填 | 用户ID列表。 |
completion | 必填 | 取消请求成功的回调。 |
abstract fun acceptBattle(battleID: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
battleID | String? | 必填 | PK ID。 |
completion | 必填 | 接受成功的回调。 |
abstract fun rejectBattle(battleID: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
battleID | String? | 必填 | PK ID。 |
completion | 必填 | 拒绝成功的回调。 |
abstract fun exitBattle(battleID: String?,completion: CompletionHandler?)
参数名 | 类型 | 是否必填 | 描述 |
battleID | String? | 必填 | PK ID。 |
completion | 必填 | 退出 PK 成功的回调。 |
枚举值 | 值 | 说明 |
TIME_OVER | 0 | PK 倒计时结束。 |
ALL_MEMBER_EXIT | 1 | 所有 PK 成员退出。 |
方法名 | 说明 |
onBattleStarted | 当 PK 正式开始时触发此回调,通知所有参与者 PK 已经开始。 |
onBattleEnded | 当 PK 结束时触发此回调。 |
onUserJoinBattle | 当有用户加入 PK 时触发此回调。 |
onUserExitBattle | 当有用户退出 PK 时触发此回调。 |
onBattleRequestReceived | 当收到 PK 请求时触发此回调。 |
onBattleRequestCancelled | 当 PK 请求被取消时触发此回调。 |
onBattleRequestTimeout | 当 PK 请求超时时触发此回调。 |
onBattleRequestAccept | 当 PK 请求被接受时触发此回调。 |
onBattleRequestReject | 当 PK 请求被拒绝时触发此回调。 |
属性 | 类型 | 说明 |
duration | Int | PK 持续时间(单位:秒)。 |
needResponse | Boolean | 被邀请用户是否需要回复同意/拒绝。 |
extensionInfo | String | 扩展信息。 |
属性 | 类型 | 说明 |
battleID | String | PK ID。 |
config | 发送 PK 请求时,设置的 PK 配置信息。 | |
startTime | Long | PK 开始标记时间戳(单位:秒)。 |
endTime | Long | PK 结束标记时间戳(单位:秒)。 |
属性 | 类型 | 说明 |
currentBattleInfo | 当前 PK 信息。 | |
battleUsers | PK 用户列表。 | |
battleScore | StateFlow<Map<String, Int>> | PK 分数的映射。 |
fun onSuccess(battleInfo: BattleInfo, resultMap: Map<String, Int>)
参数名 | 类型 | 说明 |
battleInfo | PK 信息,包含 PK 的详细配置和状态。 | |
resultMap | Map<String, Int> | PK 请求的响应结果回调。 |
fun onError(code: Int, desc: String)
参数名 | 类型 | 说明 |
code | Int | 错误码。 |
desc | String | 错误描述。 |
// 创建 store 实例val store = BattleStore.create("live_room_123")// 订阅状态变化lifecycleScope.launch {store.battleState.currentBattleInfo.collect { battleInfo ->battleInfo?.let {println("当前 PK ID: ${it.battleID}")}}}// 添加 PK 事件监听器store.addBattleListener(object : BattleListener() {override fun onBattleStarted(battleInfo: BattleInfo, inviter: SeatUserInfo, invitees: List<SeatUserInfo>) {println("PK 开始,发起者: ${inviter.userName}")}override fun onBattleEnded(battleInfo: BattleInfo, reason: BattleEndedReason?) {println("PK 结束,原因: $reason")}})// 发起 PK 请求val config = BattleConfig(duration = 300, needResponse = true)store.requestBattle(config, listOf("user_456"), 30, object : BattleRequestCallback {override fun onSuccess(battleInfo: BattleInfo, resultMap: Map<String, Int>) {println("PK 请求成功: ${battleInfo.battleID}")}override fun onError(code: Int, desc: String) {println("PK 请求失败: $desc")}})
文档反馈