feat: add agora rtc token join endpoint

This commit is contained in:
richjohnrambo
2026-09-02 01:05:15 +08:00
parent 318ce04f7d
commit dc5e09f2ae
9 changed files with 624 additions and 11 deletions
@@ -33,10 +33,10 @@
| 配置项 | 示例 | 说明 |
| --- | --- | --- |
| `agora_enabled` | `true` | 是否启用声网音视频。 |
| `agora_auth_mode` | `app_id` | 调试模式,客户端入会不需要 Token。 |
| `agora_auth_mode` | `token` | 正式模式,服务端生成 RTC Token。 |
| `agora_app_id` | `xxxxxxxx` | 声网项目 App ID,允许返回给客户端。 |
| `agora_channel_prefix` | `call_` | 服务端生成声网频道名前缀。 |
| `agora_uid_mode` | `int` | 首期建议使用数字 UID。 |
| `agora_uid_mode` | `string` | 建议使用 `usr...` 作为声网 user account,避免 BIGINT 用户 ID 超过声网数字 UID 范围。 |
### 3.2 正式模式
@@ -306,13 +306,12 @@ Content-Type: application/json
## 10. 联调顺序建议
1. 后台配置 `agora_enabled=true`、`agora_auth_mode=app_id`、`agora_app_id`。
2. 客户端集成声网 RTC SDK,并支持后端返回的空 Token 入会。
1. 后台配置 `agora_enabled=true`、`agora_auth_mode=token`、`agora_app_id`、`agora_app_certificate`。
2. 客户端集成声网 RTC SDK,并使用后端返回的 RTC Token 入会。
3. A 发起语音通话,确认 B 能收到 IM 来电信令。
4. A、B 分别调用 `/v1/im/calls/rtc-join`,确认返回同一个 `channel_name`。
5. A、B 使用各自 `uid` 加入声网频道,确认音频可通。
6. 切换视频通话,确认视频流可通。
7. 测试取消、拒接、挂断、超时、网络断开。
8. 正式环境启用 App 证书,切换 `agora_auth_mode=token`。
9. 验证 Token 入会和 Token 续期。
10. 后续再接入声网控制台 REST API 的项目管理能力。
8. 验证 Token 入会和 Token 续期。
9. 后续再接入声网控制台 REST API 的项目管理能力。