# GameServerManager.onMatch(function listener)

> 基础库 2.14.4 开始支持，低版本需做[兼容处理](1003706)。

## 功能描述

监听游戏匹配成功的事件

## 参数

### function listener

游戏匹配成功的事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "res",
    "类型": "Object",
    "说明": "",
    "子项": [
      {
        "结构属性": "matchId",
        "类型": "string",
        "说明": "与 startMatch 一致的 matchId"
      },
      {
        "结构属性": "openId",
        "类型": "string",
        "说明": "自己的 openId"
      },
      {
        "结构属性": "roomServiceAccessInfo",
        "类型": "string",
        "说明": "房间服务的accessinfo，如果matchid中指定需要匹配完成时创建房间服务，则会携带下来，后续调用房间服务相关接口加入房间即可"
      },
      {
        "结构属性": "raceId",
        "类型": "string",
        "说明": "唯一的本次对局id"
      },
      {
        "结构属性": "groupInfoList",
        "类型": "Array.<Object>",
        "说明": "匹配到的队伍信息",
        "子项": [
          {
            "结构属性": "groupIndex",
            "类型": "number",
            "说明": "队伍的序号"
          },
          {
            "结构属性": "memberInfoList",
            "类型": "Array.<Object>",
            "说明": "队伍中成员信息",
            "子项": [
              {
                "结构属性": "memberIndex",
                "类型": "number",
                "说明": "成员的序号"
              },
              {
                "结构属性": "openId",
                "类型": "string",
                "说明": "队伍中成员的openid"
              },
              {
                "结构属性": "nickName",
                "类型": "string",
                "说明": "队伍中成员的昵称"
              },
              {
                "结构属性": "avatarUrl",
                "类型": "string",
                "说明": "队伍中成员的头像"
              }
            ]
          }
        ]
      }
    ]
  }
]
```