# 联机对战错误码

## JS SDK

|返回码|值|说明|
|:--------------------------------------------|:-----|:----------------------------------------------------------------------------------------------------------------------------------|
|**通用**|||
|COMMON_OK|0|处理成功。|
|COMMON_ERR|-1|联机对战服务器处理失败，请联系华为技术支持。|
|CLIENT_COMMON_ERR|-2|联机对战SDK处理失败，请联系华为技术支持。|
|NETWORK_ERR|-3|网络错误，请检查上线平台的域名白名单是否配置正确。|
|COMMON_REQUEST_PARAM_ERR|1001|请求参数错误，请检查接口请求参数。|
|TOKEN_INVALID|100105|Token过期，需重新初始化SDK。|
|PLAYER_NOT_IN_ROOM|102005|玩家不在房间中，请先加入房间。|
|ROOM_NOT_EXIST|102008|房间不存在，请先创建房间。|
|CLIENT_TRAFFIC_CONTROL|103003|客户端的消息流控，请至少暂停1s后发送消息。|
|**Client.init**|||
|AUTHENTICATION_FAILED|2|初始化请求鉴权失败，请检查Client对象中设置的相关参数是否准确。 * appId和clientId的对应关系是否准确。 * accessToken的有效性。 * 检查联机对战服务是否开通。 * 如果开启了安全加固特性，检查签名信息有效性。|
|GET_ACCESS_TOKEN_ERR|95001|初始化请求获取Token失败，请检查Client对象中设置的clientId和clientSecret是否正确。|
|**Client.createRoom**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|MAX_PLAYERS_TOO_LARGE_OR_NEGATIVE|101113|最大玩家数超过限制或者为负数，请检查maxPlayers参数设置是否准确。|
|TOO_MANY_MATCHING_PARAMETERS|101123|自定义匹配参数matchParams包含的匹配规则超过最大长度，请设置合理的matchParams参数。|
|ONLINE_USERS_EXCEED_MAX|101135|当前游戏同一时刻在线的玩家超过上限。|
|**Client.onInitResult**|||
|LOGIN_BUSY|103001|建链请求超过流控值，请重新加入房间。|
|CONNECTIONS_EXCEED_MAX|103006|超过最大连接数，请联系华为技术支持。|
|**Client.joinRoom**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|PLAYER_ALREADY_IN_ANOTHER_ROOM|101106|玩家已在其他房间中。|
|PLAYERS_EXCEED_ROOM_MAX|101107|房间中玩家数超上限。|
|INVALID_JOIN_ROOM|101117|加入的房间无效，房间不存在，请检查房间ID是否准确。|
|INVALID_ROOM_STATUS|101120|房间在游戏状态，不允许加入，请稍后重试。|
|ROOM_IS_LOCK|101142|房间已被锁定。|
|**Client.matchRoom**|||
|ROOM_MATCH_FAILED|104101|玩家匹配房间失败，请重新发起匹配。如仍然匹配失败，请检查玩家是否已加入其他房间。|
|ROOM_MATCH_TIMEOUT|104103|玩家匹配超时，请稍后重试。如仍未解决，请联系华为技术支持。|
|**Client.onMatch**|||
|PLAYER_MATCH_FAILED|104201|在线匹配失败，请重新发起匹配。|
|PLAYER_MATCH_TIMEOUT|104203|在线匹配超时，请稍后重试。如问题仍未解决，请联系华为技术支持。|
|PLAYER_MATCH_CANCELED|104205|匹配已取消。|
|PLAYER_MATCH_INVALID_TEAM|104209|玩家想要加入的队伍不存在。|
|PLAYER_NOT_IN_MATCH|104211|查询匹配结果时，玩家已不在匹配中，请重新发起匹配。|
|**Client.cancelMatch**|||
|SDK_MATCHING|90008|玩家正在匹配中，请稍后查询匹配结果。|
|PLAYER_MATCH_CANCEL_NO_PERMISSION|104204|组队匹配时非队长玩家无权限取消匹配，请检查玩家权限。|
|ONLINE_MATCH_PLAYER_MATCH_CANCEL_WHEN_SUCCESS|104206|玩家取消匹配时已经匹配成功。|
|**Client.createGroup**|||
|MAX_PLAYERS_TOO_LARGE_OR_NEGATIVE|101113|最大玩家数超过限制或者为负数，请检查maxPlayers参数设置是否准确。|
|**Client.joinGroup**|||
|GROUP_NOT_EXIST|101202|队伍不存在。|
|GROUP_IS_LOCK|101205|队伍匹配中或人为锁定，无法加入队伍，请稍后再试或修改队伍属性isLock的值。|
|GROUP_IS_FULL|101206|队伍人数已满，请检查当前队伍人数是否已超过100。|
|**Group.** **query**|||
|PLAYER_NOT_IN_CURRENT_GROUP|101201|玩家不在队伍内。|
|GROUP_NOT_EXIST|101202|队伍不存在。|
|**Group.updateGroup**|||
|PLAYER_NOT_IN_CURRENT_GROUP|101201|玩家不在队伍内。|
|GROUP_NOT_EXIST|101202|队伍不存在。|
|OWNER_NOT_MATCH_GROUP|101204|非队长玩家无权限更新队伍信息，请检查玩家权限。|
|NEW_PLAYER_NOT_IN_GROUP|101208|玩家修改队伍信息时，指定的新队长不在当前队伍。|
|**Group.** **reconnect**|||
|GROUP_IS_LOCK|101205|当前小队被锁定。|
|GROUP_IS_FULL|101206|小队已达到人数上限。|
|GROUP_NOT_EXIST|101202|小队不存在。|
|**Group.removePlayer**|||
|OWNER_NOT_MATCH_GROUP|101204|非队长玩家无权限移除玩家，请检查玩家权限。|
|**Client.leaveGroup**|||
|GROUP_IS_LOCK|101205|队伍匹配中或人为锁定，无法离开队伍，请稍后再试或修改队伍属性isLock的值。|
|**Client.dismissGroup**|||
|OWNER_NOT_MATCH_GROUP|101204|非队长玩家无权限解散队伍，请检查玩家权限。|
|GROUP_IS_LOCK|101205|队伍匹配中或人为锁定，无法解散队伍，请稍后再试或修改队伍属性isLock的值。|
|**Client.matchGroup**|||
|SDK_GROUP_MEMBERS_ERR|90011|发起匹配时，玩家数和后端配置的玩家数不一致。|
|**Room.updateRoomProperties**|||
|ROOM_INFO_IS_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|ROOM_OWNER_AND_PLAYER_MISMATCH|101109|当前玩家不是房主，无权限更新房间信息。|
|TARGET_OWNER_NOT_IN_ROOM|101132|被转移的新房主不在当前房间。|
|**Room.update**|||
|ROOM_PLAYER_NOT_IN_ROOM|101101|玩家不在房间中。|
|ROOM_INFO_IS_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|PLAYER_NOT_IN_CURRENT_ROOM|101105|玩家不在当前房间中，无法获取房间信息。|
|**Room.removePlayer**|||
|ROOM_INFO_IS_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|OWNER_NOT_MATCH_ROOM|101109|当前玩家非房主，无权限移除玩家。|
|REMOVE_SELF|101121|不能移除自己，请传入正确的玩家ID。|
|**Client.dismissRoom**|||
|OWNER_NOT_MATCH_ROOM|101109|当前玩家非房主，无权限解散房间。|
|**Room.startFrameSync**|||
|PLAYER_NOT_IN_CURRENT_ROOM|101105|玩家不在当前房间中，请重新加入房间。|
|ROOM_STARTED_FRAME_SYNC|101114|房间已经开始帧同步，请勿重复调用接口。|
|**Room.** **onSendToClientFailed**|||
|INVALID_MESSAGE|102016|不合法的即时消息，请检查Room.SendToClient接口的消息入参。|
|NO_VALID_TARGET_PLAYER|102017|没有已连接的目的玩家（玩家均已掉线）。|
|INVALID_MESSAGE_LENGTH|102018|消息长度不合法，请校验消息长度。|
|**Room.stopFrameSync**|||
|PLAYER_NOT_IN_CURRENT_ROOM|101105|玩家不在当前房间中，请重新加入房间。|
|ROOM_STOPPED_FRAME_SYNC|101115|房间已经停止帧同步，请勿重复调用接口。|
|**Room.onRequestFrameError**|||
|SDK_AUTO_REQUEST_FRAME_FAILED|10002|自动补帧失败，请尝试重置帧ID后重试，具体可参考[补帧解决方案](https://developer.huawei.com/consumer/cn/forum/topic/0203938839802960035?fid=0101271690375130218)。|
|ROOM_NOT_START_FRAME_SYNC|102003|房间未开始帧同步，请先开始帧同步。|
|REQUEST_FRAME_NUMBER_OVERRUN|102014|请求帧数量超限，请减小请求的帧数量。|
|**Room.requestFrame**|||
|SDK_REQUESTING|90010|已在补帧中。|
|**Room.** **onSendToServerFailed**|||
|INVALID_MESSAGE_LENGTH|102018|消息长度不合法，请校验Room.sendToServer接口中的消息长度。|
|INVOKE_WISE_FUNCTION_FAILED|105004|调用实时服务器失败，请检查实时服务器日志。|
|**Room.** **resetRoomFrameId**|||
|SDK_FRAME_ID_RANGE_ERR|10003|帧ID范围错误，请检查frameId参数有效性。|
|**Room.reconnect**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|SDK_NOT_IN_ROOM|90002|玩家不在房间中。|

## C# SDK

|返回码|值|说明|
|:--------------------------------------------|:-----|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**通用**|||
|COMMON_OK|0|处理成功。|
|COMMON_ERR|-1|联机对战服务器处理失败，请联系华为技术支持。|
|CLIENT_COMMON_ERR|-2|联机对战SDK处理失败，请联系华为技术支持。|
|NETWORK_ERR|-3|网络错误，请检查上线平台的域名白名单是否配置正确。|
|COMMON_REQUEST_PARAM_ERR|1001|请求参数错误，请检查接口请求参数。|
|SDK_NOT_INIT|90001|联机对战SDK未初始化，请先调用Client.init方法进行初始化。|
|TOKEN_INVALID|100105|Token过期，需重新初始化SDK。|
|PLAYER_NOT_IN_ROOM|102005|玩家不在房间中，请先加入房间。|
|ROOM_NOT_EXIST|102008|房间不存在，请先创建房间。|
|CLIENT_TRAFFIC_CONTROL|103003|客户端的消息流控，请至少暂停1s后发送消息。|
|**Client.Init**|||
|GET_ACCESS_TOKEN_ERR|95001|初始化请求获取Token失败，请检查Client对象中设置的clientId和clientSecret是否正确。|
|AUTHENTICATION_FAILED|2|初始化请求鉴权失败，请检查Client对象中设置的相关参数是否准确。 * appId和clientId的对应关系是否准确。 * accessToken的有效性。 * 检查联机对战服务是否开通。 * 如果开启了安全加固特性，检查签名信息有效性。|
|**Client.CreateRoom**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|MAX_PLAYERS_TOO_LARGE_OR_NEGATIVE|101113|最大玩家数超过限制或者为负数，请检查maxPlayers参数设置是否准确。|
|TOO_MANY_MATCHING_PARAMETERS|101123|自定义匹配参数matchParams包含的匹配规则超过最大长度，请设置合理的matchParams参数。|
|ONLINE_USERS_EXCEED_MAX|101135|当前游戏同一时刻在线的玩家超过上限。|
|**Client.OnInitResult**|||
|LOGIN_BUSY|103001|建链请求超过流控值，请重新加入房间。|
|CONNECTIONS_EXCEED_MAX|103006|超过最大连接数，请联系华为技术支持。|
|**Client.JoinRoom**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|PLAYER_ALREADY_IN_ANOTHER_ROOM|101106|玩家已在其他房间中。|
|PLAYERS_EXCEED_ROOM_MAX|101107|房间中玩家数超上限。|
|INVALID_JOIN_ROOM|101117|加入的房间无效，房间不存在，请检查房间ID是否准确。|
|INVALID_ROOM_STATUS|101120|房间在游戏状态，不允许加入，请稍后重试。|
|ROOM_IS_LOCK|101142|房间已被锁定。|
|**Client.MatchRoom**|||
|ROOM_MATCH_FAILED|104101|玩家匹配房间失败，请重新发起匹配。如仍然匹配失败，请检查玩家是否已加入其他房间。|
|ROOM_MATCH_TIMEOUT|104103|玩家匹配超时，请稍后重试。如仍未解决，请联系华为技术支持。|
|**Client.OnMatch**|||
|PLAYER_MATCH_FAILED|104201|在线匹配失败，请重新发起匹配。|
|PLAYER_MATCH_TIMEOUT|104203|在线匹配超时，请稍后重试。如问题仍未解决，请联系华为技术支持。|
|PLAYER_MATCH_CANCELED|104205|匹配已取消成功。|
|PLAYER_MATCH_INVALID_TEAM|104209|玩家想要加入的队伍不存在。|
|PLAYER_NOT_IN_MATCH|104211|查询匹配结果时，玩家已不在匹配中，请重新发起匹配。|
|**Client.CancelMatch**|||
|SDK_MATCHING|90008|玩家正在匹配中，请稍后查询匹配结果。|
|PLAYER_MATCH_CANCEL_NO_PERMISSION|104204|组队匹配时非队长玩家无权限取消匹配，请检查玩家权限。|
|ONLINE_MATCH_PLAYER_MATCH_CANCEL_WHEN_SUCCESS|104206|玩家取消匹配时已经匹配成功。|
|**Client.CreateGroup**|||
|MAX_PLAYERS_TOO_LARGE_OR_NEGATIVE|101113|最大玩家数超过限制或者为负数，请检查maxPlayers参数设置是否准确。|
|**Client.JoinGroup**|||
|GROUP_NOT_EXIST|101202|队伍不存在。|
|GROUP_IS_LOCK|101205|队伍匹配中或人为锁定，无法加入队伍，请稍后再试或修改队伍属性IsLock的值。|
|GROUP_IS_FULL|101206|队伍人数已满，请检查当前队伍人数是否已超过100。|
|**Group.GetGroupDetail**|||
|PLAYER_NOT_IN_CURRENT_GROUP|101201|玩家不在队伍内。|
|GROUP_NOT_EXIST|101202|队伍不存在。|
|**Group.ModifyGroup**|||
|PLAYER_NOT_IN_CURRENT_GROUP|101201|玩家不在队伍内。|
|GROUP_NOT_EXIST|101202|队伍不存在。|
|OWNER_NOT_MATCH_GROUP|101204|非队长玩家无权限更新队伍信息，请检查玩家权限。|
|NEW_PLAYER_NOT_IN_GROUP|101208|玩家修改队伍信息时，指定的新队长不在当前队伍。|
|**Group.** **Reconnect**|||
|GROUP_IS_LOCK|101205|当前小队被锁定。|
|GROUP_IS_FULL|101206|小队已达到人数上限。|
|GROUP_NOT_EXIST|101202|小队不存在。|
|**Group.RemovePlayer**|||
|OWNER_NOT_MATCH_GROUP|101204|非队长玩家无权限移除玩家，请检查玩家权限。|
|**Client.LeaveGroup**|||
|GROUP_IS_LOCK|101205|队伍匹配中或人为锁定，无法离开队伍，请稍后再试或修改队伍属性IsLock的值。|
|**Client.DismissGroup**|||
|OWNER_NOT_MATCH_GROUP|101204|非队长玩家无权限解散队伍，请检查玩家权限。|
|GROUP_IS_LOCK|101205|队伍匹配中或人为锁定，无法解散队伍，请稍后再试或修改队伍属性IsLock的值。|
|**Client.MatchGroup**|||
|SDK_GROUP_MEMBERS_ERR|90011|发起匹配时，玩家数和后端配置的玩家数不一致。|
|**Room.UpdateRoomProperties**|||
|ROOM_INFO_IS_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|ROOM_OWNER_AND_PLAYER_MISMATCH|101109|当前玩家不是房主，无权限更新房间信息。|
|TARGET_OWNER_NOT_IN_ROOM|101132|被转移的新房主不在当前房间。|
|**Room.Update**|||
|ROOM_PLAYER_NOT_IN_ROOM|101101|玩家不在房间中。|
|ROOM_INFO_IS_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|PLAYER_NOT_IN_CURRENT_ROOM|101105|玩家不在当前房间中，无法获取房间信息。|
|**Client.RemovePlayer**|||
|ROOM_INFO_IS_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|OWNER_NOT_MATCH_ROOM|101109|当前玩家非房主，无权限移除玩家。|
|REMOVE_SELF|101121|不能移除自己，请传入正确的玩家ID。|
|**Client.DismissRoom**|||
|OWNER_NOT_MATCH_ROOM|101109|当前玩家非房主，无权限解散房间。|
|**Room.StartFrameSync**|||
|PLAYER_NOT_IN_CURRENT_ROOM|101105|玩家不在当前房间中，请重新加入房间。|
|ROOM_STARTED_FRAME_SYNC|101114|房间已经开始帧同步，请勿重复调用接口。|
|**Room.** **OnSendToClientFailed**|||
|INVALID_MESSAGE|102016|不合法的即时消息，请检查Room.SendToClient接口的消息入参。|
|NO_VALID_TARGET_PLAYER|102017|没有已连接的目的玩家（玩家均已掉线）。|
|INVALID_MESSAGE_LENGTH|102018|消息长度不合法，请校验消息长度。|
|**Room.StopFrameSync**|||
|PLAYER_NOT_IN_CURRENT_ROOM|101105|玩家不在当前房间中，请重新加入房间。|
|ROOM_STOPPED_FRAME_SYNC|101115|房间已经停止帧同步，请勿重复调用接口。|
|**Room.OnRequestFrameError**|||
|SDK_AUTO_REQUEST_FRAME_FAILED|10002|自动补帧失败，请尝试重置帧ID后重试，具体可参考[补帧解决方案](https://developer.huawei.com/consumer/cn/forum/topic/0203938839802960035?fid=0101271690375130218)。|
|ROOM_NOT_START_FRAME_SYNC|102003|房间未开始帧同步，请先开始帧同步。|
|REQUEST_FRAME_NUMBER_OVERRUN|102014|请求帧数量超限，请减小请求的帧数量。|
|**Room.SendRequestFrame**|||
|SDK_REQUESTING|90010|已在补帧中。|
|**Room.** **OnSendToServerFailed**|||
|INVALID_MESSAGE_LENGTH|102018|消息长度不合法，请校验[Room.SendToServer](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-References/gameobe-room-csharp-0000001278515821#section65851047802)接口中的消息长度。|
|INVOKE_WISE_FUNCTION_FAILED|105004|调用实时服务器失败，请检查实时服务器日志。|
|**Room.** **ResetRoomFrameId**|||
|SDK_FRAME_ID_RANGE_ERR|10003|帧ID范围错误，请检查frameId参数有效性。|
|**Room.Reconnect**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|SDK_NOT_IN_ROOM|90002|玩家不在房间中。|

## 服务端SDK

|返回码|值|说明|
|:-----------------------------|:-----|:------------------------------------------------------------------------------------------------------------------------|
|**通用**|||
|COMMON_OK|0|处理成功。|
|COMMON_ERR|-1|联机对战服务器处理失败，请联系华为技术支持。|
|CLIENT_COMMON_ERR|-2|联机对战SDK处理失败，请联系华为技术支持。|
|COMMON_REQUEST_PARAM_ERR|1001|请求参数错误，请检查接口请求参数。|
|TOKEN_INVALID|100105|Token过期，需重新初始化SDK。|
|PLAYER_NOT_IN_ROOM|102005|玩家不在房间中，请先加入房间。|
|ROOM_NOT_EXIST|102008|房间不存在，请先创建房间。|
|**LocalServerMethodRoute.init**|||
|AUTHENTICATION_FAILED|2|初始化请求鉴权失败，请检查Client对象中设置的相关参数是否准确。 * appId和clientId的对应关系是否准确。 * accessToken的有效性。 * 检查联机对战服务是否开通。 * 如果开启了安全加固特性，检查签名信息有效性。|
|GET_ACCESS_TOKEN_ERR|95001|初始化请求获取Token失败，请检查Client对象中设置的clientId和clientSecret是否正确。|
|**LocalServerMethodRoute.joinRoom**|||
|JOIN_OR_CREATE_ROOM_FAILED|91001|网络异常，请稍后重试。|
|PLAYER_ALREADY_IN_ANOTHER_ROOM|101106|玩家已在其他房间中。|
|PLAYERS_EXCEED_ROOM_MAX|101107|房间中玩家数超上限。|
|INVALID_JOIN_ROOM|101117|加入的房间无效，房间不存在，请检查房间ID是否准确。|
|INVALID_ROOM_STATUS|101120|房间在游戏状态，不允许加入，请稍后重试。|
|ROOM_IS_LOCK|101142|房间已被锁定。|
|**GameServer.** **onRoomPropertiesChangeFailed**|||
|ROOM_INFO_NOT_EXIST|101103|房间信息不存在，建议重新初始化。|
|ROOM_OWNER_AND_PLAYER_MISMATCH|101109|当前玩家不是房主，无权限更新房间信息。|
|TARGET_OWNER_NOT_IN_ROOM|101132|被转移的新房主不在当前房间。|
|**GameServer.** **onInstantMessageFailed**|||
|PARSE_MSG_FAILED|102009|解析消息失败。|
|INVALID_MESSAGE|102016|不合法的即时消息。|
|NO_VALID_TARGET_PLAYER|102017|没有已连接的目的玩家（玩家均已掉线）。|
|INVALID_MESSAGE_LENGTH|102018|消息长度不合法，请校验消息长度。|