> ## 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 不能混用。

# IM 通道

> 会议 IM 的四类事件、base + content 结构、呼叫与会议提醒、连接状态

IM 是会议 SDK 里独立于会议内聊天的一条通道，用于**会议之外**的通知：
被呼叫入会、会议提醒、等候室与子会议的通知。

<Note>
  不需要手动开启 —— 登录后 SDK 自动维护 IM 连接。会议**内**的聊天走
  `sendRoomChatMessage` / `onChatMessage`，见
  [聊天与自定义消息](/zh/meeting/harmony/advanced/messaging)。
</Note>

***

### 统一的两段结构

所有 IM 业务事件都是「`base` + `content`」：

```typescript theme={null}
onImCallCalling: (m, data) => {
  // data.base    谁发的
  // data.content 业务内容，类型按事件不同
}
```

`ImBaseEventData`：

| 字段        | 类型       | 说明    |
| --------- | -------- | ----- |
| `sid`     | `string` | 会话 ID |
| `uid`     | `string` | 发送者   |
| `name`    | `string` | 发送者昵称 |
| `avatar?` | `string` | 头像    |

***

### 被呼叫入会

主持人调 `adminCallUsers([uid])` 时，对方收到：

```typescript theme={null}
onImCallCalling: (m, data) => {
  // data.content: ImCallContent
  //   roomNo / meetingId / title
  this.showIncomingCall(data.base.name, data.content.title, async () => {
    await m.enterRoom({
      nickname: myNickname,
      meetingId: data.content.meetingId
    });
  });
}
```

`content` 里直接给了 `meetingId` 和 `roomNo`，接受呼叫就是拿它去 `enterRoom`。

<Note>
  这是**会议外**的事件 —— 用户此时不在任何会议里，所以要在 App 全局
  （而不是会议页）监听它。通常在登录后就注册一个全局 delegate。
</Note>

***

### 会议提醒

主持人调 `adminMeetRemind(uids)` 时：

```typescript theme={null}
onImMeetingRemind: (m, data) => {
  // data.content: ImMeetingRemindContent
  //   roomNo / meetingId / title / creatorName / planTime / planDur
  this.showReminder(
    data.content.title,
    data.content.creatorName,
    data.content.planTime,
    data.content.planDur
  );
}
```

比呼叫多了创建者与预约时间，适合做"会议即将开始"的通知。

***

### 等候室与子会议通知

这两个共用 `ImSubMeetingContent`（`parent` / `meetingId` / `title`）：

```typescript theme={null}
// 被移出等候室（也就是被放行或被拒）
onImAdminMoveOutWaitingRoom: (m, data) => {
  // data.content.meetingId / title
}

// 子会议里有成员求助（主持人收到）
onImUserHelpSubMeeting: (m, data) => {
  // data.base.name 谁在求助
  // data.content.parent 主会议 ID，meetingId 子会议 ID
  this.showHelpRequest(data.base.name, data.content.title);
}
```

***

### 连接状态

```typescript theme={null}
onImReconnecting: (m) => { /* 无参数 */ },
onImReconnected: (m) => { /* 无参数 */ },
onImDisconnected: (m, data) => {
  // data.reason?: string
}
```

<Note>
  IM 断开**不影响会议本身** —— 会议的媒体和信令走另一条通道。
  所以 `onImDisconnected` 只该影响"能不能收到会外通知"这类 UI，
  不要据此提示"会议已断开"。
</Note>

***

### 注册在哪里

IM 事件和会议事件在**同一个** `SMeetingDelegate` 接口上，但生效范围不同：

```typescript theme={null}
// App 级：登录后就注册，用于接呼叫和提醒
class GlobalMeetingObserver implements SMeetingDelegate {
  onImCallCalling = (m, data) => { /* 全局弹窗 */ };
  onImMeetingRemind = (m, data) => { /* 通知栏 */ };
}

// 会议页级：进会时注册，出会时摘除
const roomDelegate: SMeetingDelegate = {
  onUserEnter: (m, u) => { /* ... */ },
  onImUserHelpSubMeeting: (m, data) => { /* 只在会中有意义 */ }
};
```

<Warning>
  两份 delegate 都要**成对 `add` / `remove`**。App 级那份的生命周期跟着登录状态走：
  `logout()` 之后就该摘掉，否则下次登录会有重复回调。
</Warning>

***

### 相关阅读

* [事件参考](/zh/meeting/harmony/events)
* [子会议](/zh/meeting/harmony/advanced/sub-meetings)
* [等候室](/zh/meeting/harmony/advanced/waiting-room)