# LiveKit 多人会议测试指南

## 快速测试链接

生成 Token 后使用浏览器打开以下链接（不同标签页代表不同用户）：

```bash
# 生成3个用户 Token
~/s2s-env/bin/python gen_token.py multi-user-test 用户A
~/s2s-env/bin/python gen_token.py multi-user-test 用户B
~/s2s-env/bin/python gen_token.py multi-user-test 用户C
```

测试页面：`multi_user_test.html`

## 测试步骤

1. 打开3个浏览器标签页，分别粘贴Token链接
2. 点击"连接会议"按钮
3. 允许麦克风权限
4. 说话测试音频传输
5. 查看参与者列表确认多人在线

## 关键配置

- LiveKit Server: `localhost:7880` (HTTP) / `localhost:7881` (WebSocket)
- Docker 启动参数必须包含 `--node-ip=<Mac局域网IP>`
- UDP 端口映射: `7882-7892`

## 常见问题

| 问题 | 原因 | 解决 |
|------|------|------|
| ICE failed | Docker网络隔离 | 使用bridge+端口映射+CLI参数 |
| Token 401 | VideoGrants配置错误 | 使用 `.with_grants(VideoGrants(room_join=True, room="xxx"))` |
| 音频不传输 | Agent未启动 | 先启动 `agent_server.py` |

## 相关脚本

- `test_multi_user.py` - 批量生成Token
- `gen_token.py` - 单个Token生成
- `multi_user_test.html` - Web测试界面