开通服务
在控制台开通本地录制、生成鉴权信息、准备 Linux 主机与依赖。
开通服务
本地服务端录制不依赖云侧开通,但仍需要项目级凭证与授权。
1. 项目凭证
| 凭证 | 用途 | 获取方式 |
|---|---|---|
appId | 录制进程标识,createAgoraRecordingEngine(appId, handler) 的第一个参数 | 控制台 → 项目 → App ID |
| 频道 Token | 录制端以虚拟用户加入频道时的鉴权 | 服务端用项目 Certificate 签发 |
录制端 Token 的
privilegeExpiredTs按业务设置;兼容版本提示录制端未开放renewToken(旧面),4.x 面提供IAgoraMediaRtcRecorder::renewToken。ni-meet 的实现会在renewToken时替换后续使用的 Token。
2. 授权(License)
声网本地录制按 License 计费,RecordingConfig/AgoraServiceConfiguration 都带 license 字段。ni-meet 的自托管版本不需要 License 文件,字段保留以维持公开面一致;校验缺失不是错误。
3. 项目配额(自托管)
| 配额 | 默认 | 说明 |
|---|---|---|
quotas.recordingConcurrent | 5 | 云端录制并发;本地录制进程不占用该配额 |
| 本地录制并发 | 1 会话 / 进程 | 一个 IRecordingEngine 实例同一时刻只有一个会话(重复 joinChannel 返回 -ERR_ALREADY_IN_USE) |
4. 服务开通状态
云端录制需要项目开启 recording 服务(否则 REST 返回 403 service_not_enabled)。本地录制由进程内 SDK 直接执行,不受该开关影响;但若 sink 使用 egress worker,则由 worker 侧的准入决定(429 recording_quota_exceeded)。