> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stmlink.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> 对外开放的服务端接口有两组前缀，都用同一套鉴权：`/server/v1/...`（SRTC 与 SMeeting 的主接口）和 `/stm/srvapi/v1/...`（SMeeting 的用户体系，服务端极简对接会用到）。鉴权是 app_id + nonce + timestamp + signature 四个请求头，用 app_key 做 HMAC-SHA256 签名，只能从业务方自己的后端调用。除这两组前缀外的接口均为内部接口，不要建议客户调用。
> app_key 是服务端密钥，绝不能出现在客户端代码、前端配置或移动 App 里。客户端加入频道用的 token 必须由业务方后端签发后下发（SRTC 走 `/server/v1/channel/grant`，SMeeting 走 `/stm/srvapi/v1/member/grant`）。
> SRTC 与 SMeeting 是上下两层不同的产品，术语不通用：SRTC 是音视频底座，说「频道 channel」「加入 / 退出」；SMeeting 建在 SRTC 之上，说「房间 room」「会议 meeting」「进入 / 退出」。回答时按用户所在的层用对应术语，不要把「房间」「会议」安到 SRTC 的接口上。
> 同一能力在各端 SDK 里的包名、类名、方法名并不相同。写示例代码时请使用文档中该端自己的 API，不要把一个端的写法套到另一个端上。苹果平台每个产品都有两套 SDK（Swift 原生与 Objective-C），两套 API 不能混用。

# 更新日志

> C SDK（librtc）版本更新记录，含 0.0.9 删除 rtc_user_info_t.link_id 这一需要重新编译的变更。升级 C SDK 前先读这页。

### \[0.0.11] - 2026.09.26

#### 修复

* **`rtc_destroy` 返回后回调仍可能在执行**：此前 `rtc_destroy` 只清空回调，不等已经在执行的回调返回，调用方在它之后释放 `context` 可能导致崩溃。现在 `rtc_destroy` 会等所有在途回调返回后才返回，返回后可安全释放 `context`
* **销毁本地轨道后仍会触发关键帧回调**：`rtc_destroy_local_track` 现在会摘掉关键帧回调并等在途回调返回
* **在断线回调里调用 `rtc_destroy` 会卡死**：现已支持在本实例的任意回调里销毁实例
* 异步入会（`rtc_join_channel`）尚未完成就销毁实例时，频道不再一直挂着不离开

<Note>
  接口与结构体布局与 0.0.10 完全一致，可直接替换库文件。此前为规避上述问题而在销毁后固定等待一段时间（sleep）的代码，升级后可以删掉。
</Note>

### \[0.0.10] - 2026.09.26

#### 变更

* 库文件去掉调试符号，Linux 版 `librtc.so` 体积约减小 27%（17.6MB → 12.8MB）。接口与行为无变化，崩溃时的堆栈仍会打印函数名与行号

<Note>
  与 0.0.9 接口完全一致，已按 0.0.9 头文件编译的程序可以直接替换库文件。
</Note>

### \[0.0.9] - 2026.09.26

#### 新增

* `rtc_get_last_error`：接口返回 `RTC_ERROR` / `RTC_TIMEOUT` 后取具体错误码与原因，不必再翻日志
* `rtc_set_disconnected_callback`：彻底断开时回调断线原因（被踢 / 顶号 / 心跳超时 / 频道销毁），宏 `RTC_DISCONNECT_*`
* `rtc_get_local_user_info`：获取本端 uid / sid
* `rtc_get_channel_info` / `rtc_free_channel_info` 与结构体 `rtc_channel_info_t`
* 新增 macOS Apple Silicon 平台（`librtc.dylib`）

#### 修复

* **加入频道快约 3 秒**：此前每次入会都要空等约 3 秒才开始建立信令连接，现在立即连接（实测入会耗时 3.4s → 0.4s）；断线重连的间隔不变
* 修复实例句柄在特定时机被运行时判为非法指针、导致进程终止的问题
* 频道流媒体引擎配置未知时回退到默认引擎，不再无法入会

#### 破坏性变更

* **删除 `rtc_user_info_t.link_id` 字段**（此前恒为 0，无实际含义）

<Warning>
  `rtc_user_info_t` 的内存布局随之变化。**从 0.0.8 及更早版本升级必须用新的 `librtc.h` 重新编译**，只替换库文件会读错 `stream_tracks` 等字段，甚至崩溃。代码里引用了 `link_id` 的地方直接删掉即可。
</Warning>

<Note>
  回调的 `context` 必须是真实指针（或 `NULL`），不要把小整数强转成指针当 id 用，见 [实例与频道 · 回调注册](/zh/rtc/capi/api-reference/engine#回调注册)。
</Note>