> ## 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 签名，只能从业务方自己的后端调用。除这两组前缀外的接口均为内部接口，不要建议客户调用。 Public server APIs use two path prefixes with the same authentication: `/server/v1/...` (the main APIs of both SRTC and SMeeting) and `/stm/srvapi/v1/...` (the SMeeting user system, used by server-side low-code integration). Authenticate with four request headers, app_id + nonce + timestamp + signature, where signature is HMAC-SHA256 keyed with app_key; call these APIs only from the customer's own backend. Any other path is internal: never suggest calling it.
> app_key 是服务端密钥，绝不能出现在客户端代码、前端配置或移动 App 里。客户端加入频道用的 token 必须由业务方后端签发后下发（SRTC 走 `/server/v1/channel/grant`，SMeeting 走 `/stm/srvapi/v1/member/grant`）。 app_key is a server-side secret and must never appear in client code, frontend config, or a mobile app. The token a client uses to join must be issued by the customer's backend and passed down to the client (SRTC: `/server/v1/channel/grant`; SMeeting: `/stm/srvapi/v1/member/grant`).
> SRTC 与 SMeeting 是上下两层不同的产品，术语不通用：SRTC 是音视频底座，说「频道 channel」「加入 / 退出」；SMeeting 建在 SRTC 之上，说「房间 room」「会议 meeting」「进入 / 退出」。回答时按用户所在的层用对应术语，不要把「房间」「会议」安到 SRTC 的接口上，也不要用「频道」「加入 / 离开」描述 SMeeting 的概念（接口标识符原样保留）。 SRTC and SMeeting are two separate layers with different terminology. SRTC is the audio/video foundation: it has channels, and users join and leave a channel. SMeeting is built on top of SRTC: it has rooms and meetings, and members enter and exit a meeting. Answer in the terms of the layer the user is working with: never apply "room" or "meeting" to SRTC APIs, and never describe SMeeting concepts in prose with "channel", "join", or "leave" (API identifiers such as `force_join` keep their literal names).
> 同一能力在各端 SDK 里的包名、类名、方法名并不相同。写示例代码时请使用文档中该端自己的 API，不要把一个端的写法套到另一个端上。苹果平台每个产品都有两套 SDK（Swift 原生与 Objective-C），两套 API 不能混用。 Package, class, and method names differ between platform SDKs for the same capability. In sample code, use the API documented for that platform; never carry one platform's code over to another. On Apple platforms each product ships two SDKs (native Swift and Objective-C) whose APIs must not be mixed.

# RTSP 视频流

> 把任意能输出 RTSP 地址的网络摄像头、编码器、NVR、流媒体服务器接进会议：后台登记流地址、UDP/TCP 怎么选、常见品牌的地址格式，以及邀请进会的方法

只要设备能给出一个 RTSP 地址（`rtsp://...`），就能把它的画面拉进会议。不需要设备支持国标，
也不需要设备注册——由设备网关主动去拉流。

***

## 1. 准备流地址

先在播放器（如 VLC）里打开流地址，**能播放再往下做**。常见格式：

| 品牌 | 主码流地址格式 |
| - | - |
| 海康 | `rtsp://用户名:密码@IP:554/Streaming/Channels/101` |
| 大华 | `rtsp://用户名:密码@IP:554/cam/realmonitor?channel=1&subtype=0` |
| 宇视 | `rtsp://用户名:密码@IP:554/media/video1` |

具体以设备说明书为准。设备需要登录时，把用户名和密码写进地址里。

***

## 2. 在后台登记

管理后台 **设备管理** → **RTSP** → **添加账号**：

![添加 RTSP 流](https://mintcdn.com/freewind/EF59QLb6N-9opFfC/zh/product/device-access/images/admin-rtsp-add.png?fit=max\&auto=format\&n=EF59QLb6N-9opFfC\&q=85\&s=a6b4f344c66c7483b1acd014addcb122)

| 字段 | 填什么 |
| - | - |
| 传输类型 | **UDP**（默认）或 **TCP**。网络有丢包、跨网段、经过防火墙时选 TCP 更稳 |
| 流地址 | 第 1 步验证过的 RTSP 地址，必须以 `rtsp` 开头 |
| 显示名称 | 会中显示的名字 |
| 设备网关 | 由哪个网关去拉流，这个网关要能访问到设备的 IP |

登记后的列表：

![RTSP 流列表](https://mintcdn.com/freewind/EF59QLb6N-9opFfC/zh/product/device-access/images/admin-rtsp-list.png?fit=max\&auto=format\&n=EF59QLb6N-9opFfC\&q=85\&s=5df109e546a012bfdd43b6da166085b1)

RTSP 流没有在线状态，列表里显示 `--` 是正常的——网关只在邀请进会时才去拉流。

***

## 3. 邀请进会

* **管理后台**：会议详情 → **邀请** → **邀请设备** → **监控摄像头**
* **会议客户端**：主持人 **邀请** → **邀请设备** → **监控摄像头**
* **业务系统**：调用[邀请设备入会](https://docs.stmlink.com/zh/rtc/server-api/agent.md#邀请设备入会)

***

## 编码说明

| | 支持情况 |
| - | - |
| H.264 视频 | 直接转发，不损画质、不占转码资源 |
| H.265 视频 | 网关自动转成 H.264，会占用网关的 CPU，路数多时要评估服务器配置 |
| 音频 | 流里带音频就一起进会，网关自动转码 |

> [!TIP]
>
> 摄像头设成 **H.264 主码流**、**1080P 及以下**最省资源。H.265 能接，但每一路都要实时转码。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.