发布说明
SDK、API、文档中心的版本号、变更内容、破坏性变更与兼容窗口。
版本 v1.1.0 · 更新于 2026-10-26 · 修订 1
这一页记录 ni-meet 各组件的版本、SDK 兼容版本，以及接口变更的兼容策略。
当前版本#
| 组件 | 版本 | 说明 |
|---|
| 文档中心（本站） | v1.1.0 | 与当前 SDK / 服务端版本对应 |
| REST API | 1.0.0 · 15 个产品分组 | 鉴权、频道、录制、推流、拉流、网关、转码、回调等 |
| 错误码 | 1.1.0 · 43 个错误码 | 含 HTTP 状态、SDK 错误号与重试建议 |
| 回调事件 | 1.0.0 · 13 个事件（101–112 / 201–203） | 事件信封、签名与重试策略 |
| 服务端 SDK | Node / Java / Go / Python / .NET / PHP | 签发 Token、调用 REST、校验回调签名 |
各端 SDK 版本与兼容声网版本#
| 平台 | 接口版本 | 兼容声网版本 |
|---|
| Web | 4.24.9 | agora-rtc-sdk-ng@4.24.9 |
| Electron | 4.6.2 | agora-electron-sdk@4.6.2 |
| Android | 4.7.0 | 声网 Android SDK 4.7.0 |
| iOS | 4.7.0 | AgoraRtcEngine_iOS 4.7.0 |
| macOS | 4.7.0 | AgoraRtcEngine_macOS 4.7.0 |
| Windows (C++) | 4.7.0 | 声网 Windows SDK 4.7.0 |
| Flutter | 6.6.4 | agora_rtc_engine@6.6.4 |
| React Native | 4.6.4 | react-native-agora@4.6.4 |
| Unity (C#) | 4.6.2 | 声网 Unity SDK 4.6.2 |
| Unreal（C++ / Blueprint） | 4.5.1 / 4.5.1 | 声网 Unreal SDK 4.5.1 |
| C#（.NET） | 以实际 SDK 包为准 | 声网 C# SDK |
| Cocos Creator | 以实际 SDK 包为准 | 声网 Cocos Creator SDK |
| HarmonyOS（ArkTS） | 4.6.3 | 声网 HarmonyOS SDK 4.6.3 |
变更类型与兼容窗口#
| 类型 | 例子 | 兼容承诺 |
|---|
| 补文档 | 新增页面、补充字段说明 | 随时 |
| 新增端点 / 方法 | 新分组、新接口 | 向后兼容，旧调用不受影响 |
| 字段新增（可选） | 响应多一个字段 | 向后兼容；客户端应忽略未知字段 |
| 字段语义变更 | 同一字段含义变了 | 破坏性，先发公告并保留旧行为 ≥ 30 天 |
| 删除端点 / 方法 | 下线旧接口 | 破坏性，先标记弃用 ≥ 90 天 |
| Token 格式变更 | nrt1 → nrt2 | 双写兼容期 ≥ 90 天，两侧同时可用 |
弃用中的接口#
| 接口 | 状态 | 替代 |
|---|
/v1/projects/{appid}/fls/entry_points/*（旧版旁路推流） | 兼容保留，不推荐新接入 | rtmp-converters（Media Push） |
/v1/projects/{appId}/cloud-player/{playerid}（PATCH 旧拼写） | 兼容保留 | /players/{id}（Media Pull） |
各端 setEncryptionConfig(非 none) | 接口保留，当前版本不支持 | 见 频道加密 |
版本策略#
- 同一大版本内优先做向后兼容的新增；破坏性变更按上表的窗口提前公告。
- SDK 与 REST API 的版本分别维护；升级 SDK 前请确认对应 REST 接口版本。
- 需要历史版本页面时，可从左侧导航底部的「历史版本」进入。