产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
RTC Room Engine SDK 实现主播 PK 功能。getLiveBattleManager 接口获取 TUILiveBattleManager插件。TUILiveBattleManager 插件的 requestBattle 接口实现该功能，传入三个参数：PK 配置信息、邀请 PK 的主播的用户Id和超时时长。duration 即可。import RTCRoomEnginelet battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager()let config = TUIBattleConfig()config.duration = 30 // 请将其替换为您的PK持续时间，单位为秒let userIds = ["100001"] // 请将其替换为您想与之PK的主播的用户Idlet timeout = 30 // 请将这里替换成您申请上麦的超时时间,单位秒，如果设置为 0，SDK 不会做超时检测，也不会触发超时回调battleManager.requestBattle(config: config,userIdList: userIds,timeout: TimeInterval(timeout)) { battleInfo, battleResults in// 发起 PK 请求成功, battleId:battleInfo.battleId} onError: { code, message in// 发起 PK 请求失败}
TUILiveBattleManager battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager();TUILiveBattleManager.BattleConfig config = new TUILiveBattleManager.BattleConfig();config.duration = 30; // 请将其替换为您的PK持续时间，单位为秒List<String> userIds = Collections.singletonList("100001"); // 请将其替换为您想与之PK的主播的用户Idint timeout = 30; // 请将这里替换成您申请上麦的超时时间,单位秒，如果设置为 0，SDK 不会做超时检测，也不会触发超时回调battleManager.requestBattle(config, userIds, timeout, new TUILiveBattleManager.BattleRequestCallback() {@Overridepublic void onSuccess(TUILiveBattleManager.BattleInfo battleInfo, Map<String, TUILiveBattleManager.BattleCode> resultMap) {// 发起 PK 请求成功, battleId:battleInfo.battleId}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 发起 PK 请求失败}});
addObserver 接口成为了 TUILiveBattleManager 插件的观察者，则当有人申请和您连线时，您会收到 onBattleRequestReceived 回调，您可通过 acceptBattle / rejectBattle 接口接受或拒绝该请求。func onBattleRequestReceived(battleInfo: TUIBattleInfo,inviter: TUIBattleUser,invitee: TUIBattleUser) {// 接受 PK 请求let battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager()battleManager.acceptBattle(battleId: battleInfo.battleId) {// 接受 PK 请求成功} onError: { code, message in// 接受 PK 请求失败}// 拒绝 PK 请求battleManager.rejectBattle(battleId: battleInfo.battleId) {// 拒绝 PK 请求成功} onError: { code, message in// 拒绝 PK 请求失败}}
public void onBattleRequestReceived(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleUser inviter, TUILiveBattleManager.BattleUser invitee) {// 接受 PK 请求TUILiveBattleManager battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager();battleManager.acceptBattle(battleInfo.battleId, new TUIRoomDefine.ActionCallback() {@Overridepublic void onSuccess() {// 接受 PK 请求成功}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 接受 PK 请求失败}});// 拒绝 PK 请求battleManager.rejectBattle(battleInfo.battleId, new TUIRoomDefine.ActionCallback() {@Overridepublic void onSuccess() {// 拒绝 PK 请求成功}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 拒绝 PK 请求失败}});}
getLiveBattleManager 接口获取 TUILiveBattleManager插件。TUILiveBattleManager 插件的 cancelBattleRequest 接口实现该功能，传入两个参数：发起 PK 请求成功后battleInfo的battleId 和 放弃 PK 邀请的主播用户 Id。let battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager()let battleId = "" // 请将其替换为您调用requestBattle请求PK成功后battleInfo中的battleId值let userIds = ["100001"] // 请将其替换为您邀请PK的主播的用户IdbattleManager.cancelBattleRequest(battleId: battleId, userIdList: userIds) {// 放弃 PK 请求成功} onError: { code, message in// 放弃 PK 请求失败}
TUILiveBattleManager battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager();String battleId = ""; // 请将其替换为您调用requestBattle请求PK成功后battleInfo中的battleId值List<String> userIds = Collections.singletonList("100001"); // 请将其替换为您邀请PK的主播的用户IdbattleManager.cancelBattleRequest(battleId, userIds, new TUIRoomDefine.ActionCallback() {@Overridepublic void onSuccess() {// 放弃 PK 请求成功}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 放弃 PK 请求失败}});
getLiveBattleManager 接口获取 TUILiveBattleManager插件。import RTCRoomEnginelet battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager()let battleId = "" // 请将其替换为您调用requestBattle请求PK成功后battleInfo中的battleId值battleManager.exitBattle(battleId: battleId) {// 退出 PK 成功} onError: { code, message in// 退出 PK 失败}
TUILiveBattleManager battleManager = TUIRoomEngine.sharedInstance().getLiveBattleManager();String battleId = ""; // 请将其替换为您调用requestBattle请求PK成功后battleInfo中的battleId值battleManager.exitBattle(battleId, new TUIRoomDefine.ActionCallback() {@Overridepublic void onSuccess() {// 退出 PK 成功}@Overridepublic void onError(TUICommonDefine.Error error, String message) {// 退出 PK 失败}});
addObserver 成为 TUILiveBattleManager 的观察者，监听 PK 相关的回调。AnchorBattleController 成为观察者为例：import RTCRoomEngineclass AnchorBattleController: NSObject, TUILiveBattleObserver {override init() {super.init()TUIRoomEngine.sharedInstance().getLiveBattleManager().addObserver(self)}deinit {TUIRoomEngine.sharedInstance().getLiveBattleManager().removeObserver(self)}// PK 开始时触发func onBattleStarted(battleInfo: TUIBattleInfo) {// PK 开始了, battleId:battleInfo.battleId}// PK 结束时触发func onBattleEnded(battleInfo: TUIBattleInfo, reason: TUIBattleStoppedReason) {// PK 结束了, battleId:battleInfo.battleId}// 有新主播加入 PK 时触发func onUserJoinBattle(battleId: String, battleUser: TUIBattleUser) {// battleUser.userName加入了 PK}// 正在 PK 的主播离开了 PK 时触发func onUserExitBattle(battleId: String, battleUser: TUIBattleUser) {// battleUser.userName离开了 PK}// PK 得分变化时触发func onBattleScoreChanged(battleId: String, battleUserList: [TUIBattleUser]) {// PK 得分改变了，第一个用户的比分为: battleUserList.first?.score}// 收到 PK 邀请时触发func onBattleRequestReceived(battleInfo: TUIBattleInfo, inviter: TUIBattleUser, invitee: TUIBattleUser) {// 收到了来自inviter.userName的 PK 邀请}// 收到 PK 邀请被取消时触发func onBattleRequestCancelled(battleInfo: TUIBattleInfo, inviter: TUIBattleUser, invitee: TUIBattleUser) {// 来自inviter.userName的 PK 邀请被取消了}// 收到 PK 邀请超时触发func onBattleRequestTimeout(battleInfo: TUIBattleInfo, inviter: TUIBattleUser, invitee: TUIBattleUser) {// 来自inviter.userName的 PK 邀请超时了}// 发出的 PK 邀请被接受时触发func onBattleRequestAccept(battleInfo: TUIBattleInfo, inviter: TUIBattleUser, invitee: TUIBattleUser) {// 对invitee.userName的 PK 邀请被接受了}// 发出的 PK 邀请被拒绝时触发func onBattleRequestReject(battleInfo: TUIBattleInfo, inviter: TUIBattleUser, invitee: TUIBattleUser) {// 对invitee.userName的 PK 邀请被拒绝了}}
addObserver 成为 TUILiveBattleManager 的观察者，监听 PK 相关的回调。AnchorBattleObserver 成为观察者为例：class AnchorBattleObserver extends TUILiveBattleManager.Observer {AnchorBattleObserver() {TUIRoomEngine.sharedInstance().getLiveBattleManager().addObserver(this);}// PK 开始时触发@Overridepublic void onBattleStarted(TUILiveBattleManager.BattleInfo battleInfo) {// PK 开始了, battleId:battleInfo.battleId}// PK 结束时触发@Overridepublic void onBattleEnded(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleStoppedReason reason) {// PK 结束了, battleId:battleInfo.battleId}// 有新主播加入 PK 时触发@Overridepublic void onUserJoinBattle(String battleId, TUILiveBattleManager.BattleUser battleUser) {// battleUser.userName加入了 PK}// 正在 PK 的主播离开了 PK 时触发@Overridepublic void onUserExitBattle(String battleId, TUILiveBattleManager.BattleUser battleUser) {// battleUser.userName离开了 PK}// PK 得分变化时触发@Overridepublic void onBattleScoreChanged(String battleId, List<TUILiveBattleManager.BattleUser> battleUserList) {// PK 得分改变了，第一个用户的比分为: battleUserList.first?.score}// 收到 PK 邀请时触发@Overridepublic void onBattleRequestReceived(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleUser inviter, TUILiveBattleManager.BattleUser invitee) {// 收到了来自inviter.userName的 PK 邀请}// 收到 PK 邀请被取消时触发@Overridepublic void onBattleRequestCancelled(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleUser inviter, TUILiveBattleManager.BattleUser invitee) {// 来自inviter.userName的 PK 邀请被取消了}// 收到 PK 邀请超时触发@Overridepublic void onBattleRequestTimeout(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleUser inviter, TUILiveBattleManager.BattleUser invitee) {// 来自inviter.userName的 PK 邀请超时了}// 发出的 PK 邀请被接受时触发@Overridepublic void onBattleRequestAccept(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleUser inviter, TUILiveBattleManager.BattleUser invitee) {// 对invitee.userName的 PK 邀请被接受了}// 发出的 PK 邀请被拒绝时触发@Overridepublic void onBattleRequestReject(TUILiveBattleManager.BattleInfo battleInfo, TUILiveBattleManager.BattleUser inviter, TUILiveBattleManager.BattleUser invitee) {// 对invitee.userName的 PK 邀请被拒绝了}}
文档反馈