#
UserInBatchReqData
| Parameter | Required | Type | Description |
|---|---|---|---|
| user_infos | No | UserInfo[] | List of player data |
| room_id | Yes | string | Room ID |
| mode | No | int32 | Mode (default: 1) |
| language | No | string | Language (default: zh-CN) |
- UserInfo
| Parameter | Required | Type | Description |
|---|---|---|---|
| uid | Yes | string | User ID, Maximum length 200 bytes |
| nick_name | Yes | string | User nickname |
| avatar_url | Yes | string | User avatar URL (recommended size: 128*128) |
| gender | Yes | string | Gender (female or male or empty string). For unknown gender, use empty string. |
| is_ai | No | int32 | 0: Regular user, 1: AI player (default: 0) |
| ai_level | No | int32 | AI level:0: Easy AI1: Easy AI2: Medium AI3: Advanced AI(default: 0) |
| seat_index | No | int32 | Game seat index (starting from 0). Use -1 for random assignment. Cannot exceed total seats. (default: 0) |
| is_seat_random | No | bool | Only effective when seat_index is provided.true: Randomly assign an available seat if occupied.false: Do not reassign (default: false) |
| team_id | No | int32 | For non-team games: Use 1.For team games: Use 1 or 2 (two teams). |
| is_ready | No | bool | Ready status:false: Not readytrue: Ready (default: false) |
Request Example
```json { "event": "user_in_batch", "mg_id": "xxx", "timestamp": "1657770493152", "data": { "user_infos": [ { "uid": "xxx", "nick_name": "xxx", "avatar_url": "xxx", "gender": "female", "is_ai": 0, "ai_level": 0, "seat_index": -1, "is_seat_random": false, "team_id": 1, "is_ready": false }, { "uid": "xxx", "nick_name": "xxx", "avatar_url": "xxx", "gender": "female", "is_ai": 0, "ai_level": 0, "seat_index": -1, "is_seat_random": false, "team_id": 1, "is_ready": false } ], "room_id": "xxx", "mode": 1, "language": "zh-CN" } }