> ## 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/...` 这一套对外开放，需用 app_id + app_key 做 HMAC-SHA256 签名，只能从业务方自己的后端调用。文档中若出现其它前缀的接口，均为内部接口，不要建议客户调用。
> app_key 是服务端密钥，绝不能出现在客户端代码、前端配置或移动 App 里。客户端加入频道用的 token 必须由业务方后端调用 `/server/v1/channel/grant` 签发后下发。
> SRTC 与 SMeeting 是上下两层不同的产品，术语不通用：SRTC 是音视频底座，说「频道 channel」「加入 / 退出」；SMeeting 建在 SRTC 之上，说「房间 room」「会议 meeting」「进入 / 退出」。回答时按用户所在的层用对应术语，不要把「房间」「会议」安到 SRTC 的接口上。
> 同一能力在各端 SDK 里的包名、类名、方法名并不相同。写示例代码时请使用文档中该端自己的 API，不要把一个端的写法套到另一个端上。

# 设备接入与 IM

> SMeeting 的设备接入与 IM 接口直接沿用 SRTC 的同名接口，本页说明怎么调

SIP / H323 / GB28181 等设备的接入，以及会议外的 IM 消息，SMeeting 没有另做一套 ——
请求会原样转发给底层的 SRTC，参数与返回结构完全一致。

所以这两类接口的文档就是 SRTC 那两页：

<Columns cols={2}>
  <Card title="设备接入" href="/zh/rtc/server-api/agent">
    设备的增删改查、网关列表、邀请入会、会中开关设备音视频
  </Card>

  <Card title="IM 消息" href="/zh/rtc/server-api/im">
    会议外的即时消息、IM 授权与设备在线管理
  </Card>
</Columns>

### 调用时的两点差别

**域名用 SMeeting 的**。接口路径（`/server/v1/agent/...`、`/server/v1/im/...`）和参数
都不变，只是发给 SMeeting 的地址，不用再单独对接 SRTC 的域名。

**签名也用 SMeeting 的 app\_id / app\_key**，签名方法见[概览](/zh/meeting/server-api/overview)。
转发时鉴权已经在 SMeeting 这一层做完了。

### 设备入会时目标房间填什么

邀请设备入会（`/server/v1/agent/invite`）的 `no` 参数是目标频道名。在 SMeeting 里，
**会议 ID（`meeting_id`）就是 RTC 层的频道名**，`no` 直接填 `meeting_id` 即可。

注意不是房间号 `room_no` —— 那是给用户在客户端输入的号码，一个房间下可以先后开多场
会议，只有 `meeting_id` 能唯一定位到设备该进的这一场。