解散房间

最近更新时间:2020-12-22 08:00:51

我的收藏

1. 接口描述

接口请求域名: mgobe.tencentcloudapi.com 。

通过game_id、room_id解散房间

默认接口请求频率限制:200次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DismissRoom。
Version String 公共参数,本接口取值:2020-10-14。
Region String 公共参数,详见产品支持的 地域列表
GameId String 表示游戏资源唯一 ID, 由后台自动分配, 无法修改。
RoomId String 表示游戏房间唯一ID。

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 解散房间

通过game_id、room_id解散房间

输入示例

https://mgobe.tencentcloudapi.com/?Action=DismissRoom
&GameId="obg-hvhvbs"
&RoomId="Sfsfdf"
&<公共请求参数>

输出示例

{
  "Response": {
    "RequestId": "f481b4a1-1efd-48fd-a35a-5d544c40b5b2"
  }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
AuthFailure CAM签名/鉴权错误。
DryRunOperation DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。
FailedOperation 操作失败。
FailedOperation.AccessAccessInfoEmpty 连接信息为空。
FailedOperation.AccessAddCommConnErr 添加COMM连接信息失败。
FailedOperation.AccessAddHeartConnErr 添加心跳连接信息失败。
FailedOperation.AccessAddRelayConnErr 添加Relay连接信息失败。
FailedOperation.AccessCmdGetTokenErr 获取Token失败。
FailedOperation.AccessCmdInvalidErr 命令字无效错误。
FailedOperation.AccessCmdInvalidToken Token无效或过期。
FailedOperation.AccessCmdTokenPreExpire Token即将过期。
FailedOperation.AccessConnErr 查找连接信息出错。
FailedOperation.AccessGetCommConnectErr 获取COMM连接信息失效。
FailedOperation.AccessGetRelayConnectErr 获取RELAY连接信息失效。
FailedOperation.AccessGetRsIpErr 获取Relay的RS_IP或RS_PORT出错。
FailedOperation.AccessHeartBodyParseErr 心跳包解析出错。
FailedOperation.AccessLoginBodyParseErr 登录用户中心回包解析出错。
FailedOperation.AccessNoeRelayOrStateSvr 转发SVR名字错误,不是relay_svr或state_svr。
FailedOperation.AccessPlayerDuplicateLogin 用户已经登录,不能重复登录。
FailedOperation.AccessPushSerializeErr PUSH序列化包失败。
FailedOperation.BillingError 计费类型相关错误。
FailedOperation.CmdInvalid 非法命令字。
FailedOperation.DismissRoomFailed 解散房间失败。
FailedOperation.GroupChatFrequencyLimit 发送消息频率达到限制。
FailedOperation.GroupModifyOwnerNoPermission 无权限修改队组队长。
FailedOperation.GroupNotExist 队组不存在。
FailedOperation.GroupOperationFailed 队组操作失败。
FailedOperation.GroupPlayerNumLimitExceed 对组中人数超过限制。
FailedOperation.GroupRemovePlayerNoPermission 没有权限移除玩家。
FailedOperation.InnerError 服务器内部错误。
FailedOperation.InvalidChangeOption 无效的修改选项。
FailedOperation.InvalidChangeRoomOption 参数错误change_room_option_list。
FailedOperation.InvalidParams 业务参数错误。
FailedOperation.InvalidParamsCreateRoomType 参数错误create_room_type。
FailedOperation.InvalidParamsDeviceId 参数错误device_id。
FailedOperation.InvalidParamsGameId 参数错误game_id。
FailedOperation.InvalidParamsGroupCustomProperties 队组自定义属性参数错误。
FailedOperation.InvalidParamsGroupId 队组id参数错误。
FailedOperation.InvalidParamsGroupName 队组名称参数错误。
FailedOperation.InvalidParamsGroupOwner 队组owner参数错误。
FailedOperation.InvalidParamsGroupPlayerCustomProperties 队组玩家自定义属性参数错误。
FailedOperation.InvalidParamsGroupPlayerCustomStatus 队组玩家自定义状态参数错误。
FailedOperation.InvalidParamsGroupPlayerName 队组玩家名称参数错误。
FailedOperation.InvalidParamsGroupRecvType 队组接收消息类型参数错误。
FailedOperation.InvalidParamsGroupType 队组类型参数错误。
FailedOperation.InvalidParamsMatchCode 参数错误match_code。
FailedOperation.InvalidParamsMatchType 参数错误match_type。
FailedOperation.InvalidParamsMaxPlayer 最大玩家数量参数错误。
FailedOperation.InvalidParamsMaxPlayers 参数错误max_players。
FailedOperation.InvalidParamsMessage 参数错误message。
FailedOperation.InvalidParamsMessageLength 消息长度超过限制。
FailedOperation.InvalidParamsMsgqDecode 消息队列消息decode参数错误。
FailedOperation.InvalidParamsMsgqEncode 消息队列消息encode参数错误。
FailedOperation.InvalidParamsNetworkState 参数错误network_state。
FailedOperation.InvalidParamsNonce 参数错误nonce。
FailedOperation.InvalidParamsOpenId 参数错误open_id。
FailedOperation.InvalidParamsOwner 参数错误owner。
FailedOperation.InvalidParamsOwnerOpenId 参数错误owner_open_id。
FailedOperation.InvalidParamsPageNo 参数错误page_no。
FailedOperation.InvalidParamsPageSize 参数错误page_size。
FailedOperation.InvalidParamsPlatform 参数错误platform。
FailedOperation.InvalidParamsPlayModeExpression 玩法协议规则表达式错误。
FailedOperation.InvalidParamsPlayModeRuletype 玩法协议规则类型错误。
FailedOperation.InvalidParamsPlayModeTeam 玩法协议规则团队表达式错误。
FailedOperation.InvalidParamsPlayModeVersion 玩法协议版本号错误。
FailedOperation.InvalidParamsPlayerId 参数错误player_id。
FailedOperation.InvalidParamsPlayerInfo 参数错误player_info。
FailedOperation.InvalidParamsPlayerList 参数错误playerlist。
FailedOperation.InvalidParamsPlayerNotInGroup 玩家不在队组中不允许操作。
FailedOperation.InvalidParamsRecvPlayerId 队组接收消息的玩家中存在不在队组中的玩家。
FailedOperation.InvalidParamsRegion 参数错误region。
FailedOperation.InvalidParamsRoomCreateType 参数错误create_type。
FailedOperation.InvalidParamsRoomName 参数错误room_name。
FailedOperation.InvalidParamsRoomType 参数错误room_type。
FailedOperation.InvalidParamsSign 参数错误sign。
FailedOperation.InvalidParamsTimestamp 参数错误timestamp。
FailedOperation.InvalidParamsToken 参数错误token。
FailedOperation.MatchCanNotFound [rm]当前大区找不到合适的匹配,内部接口用。
FailedOperation.MatchCancelFailed 取消匹配失败。
FailedOperation.MatchCreateRoomErr 匹配创建房间失败。
FailedOperation.MatchCreateRoomPlayerAlreadyInRoom 匹配创房有玩家已经在房间中。
FailedOperation.MatchErr 匹配失败。
FailedOperation.MatchGameInfoNotExist 游戏信息不存在。
FailedOperation.MatchGetMatchInfoErr 获取匹配信息失败。
FailedOperation.MatchGetPlayerAttrFail 匹配获取玩家属性失败。
FailedOperation.MatchGetPlayerListInfoErr 查询匹配队列信息失败。
FailedOperation.MatchGetTeamAttrFail 匹配获取队伍属性失败。
FailedOperation.MatchGroupNumExceedLimit 匹配小组人数超过队伍上限。
FailedOperation.MatchInvalidParams 匹配无效参数。
FailedOperation.MatchJoinRoomErr 匹配加入房间失败。
FailedOperation.MatchLogicErr 匹配逻辑错误。
FailedOperation.MatchNoRoom 匹配失败,无任何房间。
FailedOperation.MatchNoneTeamTypeFit 玩家属性无法决定队伍类别。
FailedOperation.MatchPlayAttrNotFound 匹配参数不完整。
FailedOperation.MatchPlayRuleAttrSegmentNotFound 匹配规则获取属性匹配区间失败。
FailedOperation.MatchPlayRuleFuncErr 匹配规则算法错误。
FailedOperation.MatchPlayRuleNotFound 匹配规则不存在。
FailedOperation.MatchPlayRuleNotRunning 匹配规则不可用。
FailedOperation.MatchPlayerAttrNotFound 玩家属性不存在。
FailedOperation.MatchPlayerIdIsRepeated 匹配小组中玩家ID重复。
FailedOperation.MatchPlayerInfoNotExist 用户信息不存在。
FailedOperation.MatchPlayerIsInMatch 用户已经在匹配中。
FailedOperation.MatchPlayerNotInMatch 用户不在匹配状态。
FailedOperation.MatchQueryGameErr 查询游戏信息失败。
FailedOperation.MatchQueryPlayerErr 查询用户信息失败。
FailedOperation.MatchQueryRegionErr 查询大区信息失败。
FailedOperation.MatchRegionInfoNotExist 无大区信息。
FailedOperation.MatchRequestCanceled 匹配已经取消。
FailedOperation.MatchRequestIdIsExist 匹配请求ID已经存在。
FailedOperation.MatchRequestIdNotExist 匹配请求ID不存在。
FailedOperation.MatchRobotGroupNotRight 匹配机器人Group不正确。
FailedOperation.MatchRobotTeamNotRight 匹配机器人Team不正确。
FailedOperation.MatchTeamFail 团队匹配失败。
FailedOperation.MatchTeamMatchFail 队伍匹配失败。
FailedOperation.MatchTeamTypeInvalid 玩家伍类别非法。
FailedOperation.MatchTimeout 匹配超时。
FailedOperation.MatchUpdateMatchInfoErr 更新匹配信息失败。
FailedOperation.NoGroupOperationPermission 没有队组操作权限。
FailedOperation.NoRight 没有权限请求。
FailedOperation.OperationFailedGroupForbidJoin 队组禁止玩家加入。
FailedOperation.ParamsInvalid 参数错误。
FailedOperation.PersistenceGroupNumExceedTheLimit 持久化队组数量超过限制。
FailedOperation.PlayerAddPlayerFail 新增用户信息失败。
FailedOperation.PlayerClearTokenFail 清除token缓存失败。
FailedOperation.PlayerDuplicateReq 重复请求。
FailedOperation.PlayerGameNotExist game不存在。
FailedOperation.PlayerGameOutOfService 游戏已停止服务。
FailedOperation.PlayerGetTokenFail 查询token失败。
FailedOperation.PlayerGroupNumLimitExceed 玩家加入的对组个数超过限制。
FailedOperation.PlayerIsExistGroup 玩家已经在队组中。
FailedOperation.PlayerIsNotExistGroup 玩家不在该队组中。
FailedOperation.PlayerLockFail 获取分布式锁失败。
FailedOperation.PlayerQueryGameFail 查询game信息失败。
FailedOperation.PlayerQueryPlayerFail 查询用户信息失败。
FailedOperation.PlayerRecordNumErr 用户记录数不正确。
FailedOperation.PlayerSaveTokenFail 保存token缓存失败。
FailedOperation.PlayerSecretKeyFail 查询secret_key失败。
FailedOperation.PlayerSignErr sign校验失败。
FailedOperation.PlayerTimestampInvalid timestamp非法。
FailedOperation.PlayerTokenInvalid token非法。
FailedOperation.PlayerTokenNotExist token不存在。
FailedOperation.PlayerUnlockFail 释放分布式锁失败。
FailedOperation.RelayAlreadyExists 重复创建。
FailedOperation.RelayCleanRelayRoomFail 清理房间对局数据失败。
FailedOperation.RelayDataExceedLimited data长度超限制。
FailedOperation.RelayForwardToClientFail 转发到client-sdk失败。
FailedOperation.RelayForwardToGamesvrFail 转发到自定义逻辑svr失败。
FailedOperation.RelayGamesvrNotFoundRoomFail gamesvr查不到房间信息报错。
FailedOperation.RelayGamesvrServiceNotOpen 自定义扩展服务(gamesvr)未开通。
FailedOperation.RelayGetFrameCacheFail 查询帧缓存失败。
FailedOperation.RelayHkvCacheError 共享内存缓存错误。
FailedOperation.RelayInvalidFrameRate 帧率非法。
FailedOperation.RelayMemberAlreadyExists 成员已存在。
FailedOperation.RelayMemberNotExists 成员不存在。
FailedOperation.RelayNoAvailablePod 无可用的pod。
FailedOperation.RelayNoMembers 没任何成员。
FailedOperation.RelayNoPermission 没权限,401开头是权限相关错误。
FailedOperation.RelayNotExists 服务不存在。
FailedOperation.RelayNotifyGamesvrFail 通知自定义服务gamesvr失败,402开头,是自定义gamesvr相关的错误。
FailedOperation.RelayNotifyRelayworkerFail 通知relayworker失败。
FailedOperation.RelayRedisCacheError redis缓存错误。
FailedOperation.RelayReqFrameGameNotStarted 补帧的时候游戏没有开始。
FailedOperation.RelayReqPodFail 请求分配pod失败。
FailedOperation.RelayResetRelayRoomFail 重置房间对局失败。
FailedOperation.RelaySetFrameRateForbidden 开局状态下,G不允许修改帧率。
FailedOperation.RelayStateInvalid 状态异常。
FailedOperation.RemovePlayerIdIsEmpty 被移除的玩家Id为空。
FailedOperation.ReqBadPkg 请求包格式错误。
FailedOperation.RoomAllocateRelaysvrIpPortErr ctrlsvr分配relaysvr失败。
FailedOperation.RoomCheckLoginSessionErr 检查登录失败。
FailedOperation.RoomCreateFail 创建房间失败。
FailedOperation.RoomCreateNoPermission 创建房间无权限。
FailedOperation.RoomDestoryNoPermission 销毁房间无权限。
FailedOperation.RoomDissmissNoPermission 无解散房间权限。
FailedOperation.RoomGameInfoNotExist 游戏信息不存在。
FailedOperation.RoomGetPlayerInfoErr 查询用户信息失败。
FailedOperation.RoomGetRoomInfoErr 获取房间信息失败。
FailedOperation.RoomInfoUnexist 房间信息不存在。
FailedOperation.RoomInvalidParamsTeamId 房间teamId无效。
FailedOperation.RoomJoinNoPermission 无权限加入房间。
FailedOperation.RoomJoinNotAllow 房间不允许加入用户。
FailedOperation.RoomMaxPlayersInvalid 最大用户数值设置非法。
FailedOperation.RoomMaxRoomNumberExceedLimit 房间数量超过限制。
FailedOperation.RoomModifyOwnerErr 修改房主失败。
FailedOperation.RoomModifyPlayerBusy 玩家信息操作繁忙,请重试。
FailedOperation.RoomModifyPropertiesNoPemission 无修改房间属性权限。
FailedOperation.RoomParamPageInvalid 页号、页数大小参数不合法,可能实际大小没这么大。
FailedOperation.RoomPlayerAlreadyInRoom 用户已经在房间内,不能操作创建房间、加房等操作。
FailedOperation.RoomPlayerInfoNotExist 用户信息不存在。
FailedOperation.RoomPlayerNotInRoom 用户目前不在房间内,不能操作更改房间属性、踢人等操作。
FailedOperation.RoomPlayerOffline 用户在房间中掉线,不能开始游戏等操作。
FailedOperation.RoomPlayersExceedLimit 房间内用户数已经达到最大人数不能再加入了。
FailedOperation.RoomQueryGameErr 游戏信息失败。
FailedOperation.RoomQueryPlayerErr 查询用户信息失败。
FailedOperation.RoomQueryRegionErr 查询地域信息失败。
FailedOperation.RoomRegionInfoNotExist 查询不到accessRegion信息。
FailedOperation.RoomRemovePlayerNoPermission 无踢人权限。
FailedOperation.RoomRemovePlayerNotInRoom 被踢玩家不在房间中。
FailedOperation.RoomRemoveSelfNoPermission 无踢出自己权限。
FailedOperation.RoomTeamMemberLimitExceed 房间团队人员已满。
FailedOperation.SdkEncodeParamFail 编码失败。
FailedOperation.SdkInvalidParams 参数错误。
FailedOperation.SdkNoCheckLogin 帧同步鉴权错误。
FailedOperation.SdkNoLogin 登录态错误。
FailedOperation.SdkNoRoom 无房间。
FailedOperation.SdkResTimeout 消息响应超时。
FailedOperation.SdkSendFail 消息发送失败。
FailedOperation.SdkSocketClose Socket断开。
FailedOperation.SdkSocketError 网络错误。
FailedOperation.SdkUninit SDK未初始化。
FailedOperation.ServerBusy 服务器繁忙。
FailedOperation.TagAddFailed 标签添加失败。
FailedOperation.TagCallerFailed 标签接口调用失败,请稍后再试。若无法解决,请提交工单。
FailedOperation.TimeOut 后端超时错误。
InternalError 内部错误。
InternalError.ConfRoomIdBucketErr 配置房间id管理模块错误。
InternalError.DataFormatErr 数据格式转化失败。
InternalError.HashidDecodeErr hashcode解码失败。
InternalError.HashidEncodeErr hashcode编码失败。
InternalError.HashidErr hashcode生成失败。
InternalError.InvalidParamsRecoreId 参数错误recordId。
InternalError.JsonFormatErr JSON数据格式转化失败。
InternalError.JsonPlayModeFormatErr 玩法数据格式转化失败。
InternalError.JsonPlayModePariseErr 玩法数据格式转化失败。
InternalError.MatchInnerLogicErr 匹配内部逻辑错误。
InternalError.MatchInnerParamsErr 匹配内部参数错误。
InternalError.MatchResultTypeNotGse 匹配不是GSE类型查询匹配结果失败。
InternalError.MatchRoomInnerAddNodeErr 匹配房间添加节点失败。
InternalError.MatchRoomInnerDelNodeErr 匹配房间删除节点失败。
InternalError.MysppSystemErr myspp框架返回-1000。
InternalError.MysqlDeleteFail 删除失败。
InternalError.MysqlInsertFail 插入失败。
InternalError.MysqlMultiRowFound 查询为空。
InternalError.MysqlNoRowFound 查询为空。
InternalError.MysqlQuerysFail 查询失败。
InternalError.MysqlUpdateFail 更新失败。
InternalError.PbParseFromStrErr 反序列化失败。
InternalError.PbSerializeToStrErr 序列化失败。
InternalError.RedisDelOpErr redisdel类操作失败。
InternalError.RedisExpireOpErr redis操作异常。
InternalError.RedisGetOpErr redisget类操作失败。
InternalError.RedisKeyNotExist redisKEY不存在。
InternalError.RedisListOpErr redislist操作失败。
InternalError.RedisListPopEmpty redislistpop空结果。
InternalError.RedisLockAlreadyExist redis加锁冲突类操作失败。
InternalError.RedisLockOpErr redis加锁类操作失败。
InternalError.RedisOpInvalidParams redis操作参数不合法。
InternalError.RedisPoolGetInstanceFail redis实例池获取实例失败。
InternalError.RedisSetIsEmpty redisset内为空。
InternalError.RedisSetOpErr redisset类操作失败。
InternalError.RoomAllocateServiceFail 申请service失败。
InternalError.RoomHistoryInfoInsertErr mysql数据库插入历史房间信息失败。
InternalError.RoomRedisCheckLockErr 检查锁失败,一般是过期。
InternalError.RoomRedisDelLockErr 删除锁失败。
InternalError.RoomRedisGetLockErr 获取锁失败。
InternalError.RoomRedisUpdateErr 数据库更新失败。
InternalError.RoomRemoveRedisPlayerRoomMatchErr 删除用户房间映射表信息失败。
InternalError.RoomRemoveRedisRoomInfoErr 删除房间信息表信息失败。
InvalidParameter 参数错误。
InvalidParameter.DuplicatePlayerIdInPlayers 玩家ID在玩家列表中重复。
InvalidParameter.GameDescLength 无效的游戏描述长度。
InvalidParameter.GameNameLength 无效的游戏名称长度。
InvalidParameter.GamePlatform 无效的游戏平台。
InvalidParameter.GameType 无效的游戏类型。
InvalidParameter.InvalidCustomProperties 无效的自定义房间属性。
InvalidParameter.InvalidMaxPlayers 无效的最大玩家数量。
InvalidParameter.InvalidMinPlayers 无效的最小玩家数量。
InvalidParameter.InvalidOpenIdLength 无效的OpenId长度。
InvalidParameter.InvalidPlayerCustomProfileLength 无效的自定义玩家属性长度。
InvalidParameter.InvalidPlayerCustomProfileStatus 无效的自定义玩家状态。
InvalidParameter.InvalidPlayerNameLength 无效的玩家昵称长度。
InvalidParameter.InvalidPlayersSize 无效的玩家数量。
InvalidParameter.InvalidRobotMatchModelParam 错误的机器人匹配模式参数。
InvalidParameter.InvalidRoomName 无效的房间名称。
InvalidParameter.InvalidRoomTypeLength 无效的房间类型长度。
InvalidParameter.InvalidTeamIdLength 无效的队伍Id长度。
InvalidParameter.InvalidTeamNameLength 无效的队伍昵称长度。
InvalidParameter.InvalidTeamsSize 无效的队伍大小。
InvalidParameter.OpenOnlineService 无效的开通联网对战服务选项。
InvalidParameter.OwnerNotInPlayers 房主信息不在玩家列表中。
InvalidParameter.PlayerNumNotInTeamRange 玩家数量不在队伍可容纳范围。
InvalidParameter.PlayerOpenIdInPlayersDuplicate 玩家ID在玩家列表中重复。
InvalidParameter.PlayerSizeNotEnough 创建满员房间但是玩家数量不足。
InvalidParameter.PlayerTeamIdNotInTeams 玩家队伍ID不在队伍列表中。
InvalidParameter.Tags 无效的标签列表。
InvalidParameterValue 参数取值错误。
LimitExceeded 超过配额限制。
LimitExceeded.CLSLogsetExceed 日志集数量超出限制。
LimitExceeded.CLSTopicExceed 日志主题数量超出限制。
LimitExceeded.GameResourceLimit 游戏数超过限额。
MissingParameter 缺少参数错误。
OperationDenied 操作被拒绝。
RequestLimitExceeded 请求的次数超过了频率限制。
RequestLimitExceeded.FrequencyLimit 操作过于频繁,请稍等几秒后重试。
ResourceInUse 资源被占用。
ResourceInsufficient 资源不足。
ResourceNotFound 资源不存在。
ResourceNotFound.RoomNotExist 房间不存在。
ResourceNotFound.TagNotFound 标签资源未找到。
ResourceUnavailable 资源不可用。
ResourceUnavailable.CLSNotAllowed 日志服务(CLS)不可用,请确保您已在日志服务控制台开通服务。若无法解决,请提交工单。
ResourcesSoldOut 资源售罄。
UnauthorizedOperation 未授权操作。
UnauthorizedOperation.CAMUnauthorizedOperation 需要授权CAM权限操作。
UnauthorizedOperation.GseCAMUnauthorizedOperation 需要授权GSE的CAM权限操作。
UnauthorizedOperation.NotActionPermission 无操作权限。
UnauthorizedOperation.NotProjectPermission 无项目权限。
UnknownParameter 未知参数错误。
UnsupportedOperation 操作不支持。
UnsupportedOperation.TagKeyDuplicate 标签键不允许重复。
目录