> ## 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 不能混用。 # 媒体轨道接口 > Windows SMeeting SDK 本地 / 远端 / 自定义媒体轨道 C++ 接口参考 以下媒体对象均通过 [ISMeetingChannel](smeeting-channel) 获取。 *** ## 本地媒体流接口 ### 获取本地麦克风对象 ```cpp theme={null} virtual StatusCode getLocalMic(IMEETLocalMic**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | --- | ----------------- | --------- | | 返回值 | IMEETLocalMic\*\* | 本地麦克风对象指针 | **返回值** `StatusCode` - 错误码 ### 获取本地摄像头对象 ```cpp theme={null} virtual StatusCode getLocalCamera(IMEETLocalCamera**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | --- | -------------------- | --------- | | 返回值 | IMEETLocalCamera\*\* | 本地摄像头对象指针 | **返回值** `StatusCode` - 错误码 ### 获取本地屏幕共享对象 ```cpp theme={null} virtual StatusCode getLocalScreen(IMEETLocalScreen**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | --- | -------------------- | ---------- | | 返回值 | IMEETLocalScreen\*\* | 本地屏幕共享对象指针 | **返回值** `StatusCode` - 错误码 *** ## 远端媒体流接口 ### 获取远端视频对象 ```cpp theme={null} virtual StatusCode getRemoteVideo(std::string uid, std::string track_desc, IMEETRemoteVideo**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | ----------- | -------------------- | -------- | | uid | std::string | 用户 ID | | track\_desc | std::string | 轨道描述 | | 返回值 | IMEETRemoteVideo\*\* | 远端视频对象指针 | **返回值** `StatusCode` - 错误码 ### 获取远端音频对象 ```cpp theme={null} virtual StatusCode getRemoteAudio(std::string uid, IMEETRemoteAudio**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | --- | -------------------- | -------- | | uid | std::string | 用户 ID | | 返回值 | IMEETRemoteAudio\*\* | 远端音频对象指针 | **返回值** `StatusCode` - 错误码 ### 获取 MCU 视频对象 ```cpp theme={null} virtual StatusCode getMcuVideo(IMEETRemoteVideo**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | --- | -------------------- | ---------- | | 返回值 | IMEETRemoteVideo\*\* | MCU 视频对象指针 | **返回值** `StatusCode` - 错误码 *** ## 自定义轨道接口 ### 获取自定义视频轨道 ```cpp theme={null} virtual StatusCode getCustomVideo(CustomPublishTrack* push, IMeetCustomVideoTrack**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | ---- | ------------------------- | ----------- | | push | CustomPublishTrack\* | 自定义轨道配置 | | 返回值 | IMeetCustomVideoTrack\*\* | 自定义视频轨道对象指针 | **返回值** `StatusCode` - 错误码 ### 获取自定义音频轨道 ```cpp theme={null} virtual StatusCode getCustomAudio(CustomPublishTrack* push, IMeetCustomAudioTrack**) = 0; ``` **参数** | 参数 | 类型 | 说明 | | ---- | ------------------------- | ----------- | | push | CustomPublishTrack\* | 自定义轨道配置 | | 返回值 | IMeetCustomAudioTrack\*\* | 自定义音频轨道对象指针 | **返回值** `StatusCode` - 错误码 ### 设置自定义接收回调 ```cpp theme={null} virtual StatusCode setCustomRecvBack(RTC_Custom_FrameEvent e, void* ext) = 0; ``` **参数** | 参数 | 类型 | 说明 | | --- | ----------------------- | ------- | | e | RTC\_Custom\_FrameEvent | 帧事件回调函数 | | ext | void\* | 扩展数据 | **返回值** `StatusCode` - 错误码 *** ## 本地录制接口 ### 获取本地录制对象 ```cpp theme={null} virtual StatusCode getLocalRecord(IMEETRecord** e) = 0; ``` **参数** | 参数 | 类型 | 说明 | | -- | --------------- | ------ | | e | IMEETRecord\*\* | 录制对象指针 | **返回值** `StatusCode` - 错误码 > 从 `1.0.0-alpha.5` 开始不再需要传入会议 ID，使用当前 channel 自己的会议 ID。 *** ## IMEETLocalMic 接口 ### 请求打开麦克风 ```cpp theme={null} virtual StatusCode requestOpenMic(Callback back = NULL) = 0; ``` ### 关闭麦克风 ```cpp theme={null} virtual StatusCode closeMic(Callback back = NULL) = 0; ``` ### 切换麦克风 ```cpp theme={null} virtual StatusCode switchMic(std::string name) = 0; ``` ### 确认打开麦克风 ```cpp theme={null} virtual StatusCode confirmOpenMic(bool approve, std::string uid, Callback function = NULL) = 0; ``` *** ## IMEETLocalCamera 接口 继承自 `IMEETVideo`。 ### 切换摄像头 ```cpp theme={null} virtual StatusCode switchCamera(std::string name, int w = 0, int h = 0) = 0; ``` ### 请求打开摄像头 ```cpp theme={null} virtual StatusCode requestOpenCamera(Callback back = NULL) = 0; ``` ### 关闭摄像头 ```cpp theme={null} virtual StatusCode closeCamera(Callback back = NULL) = 0; ``` ### 确认打开摄像头 ```cpp theme={null} virtual StatusCode confirmOpenCamera(bool approve, std::string uid, Callback function = nullptr) = 0; ``` *** ## IMEETLocalScreen 接口 继承自 `IMEETVideo`。 ### 请求共享 ```cpp theme={null} virtual StatusCode requestShare(int tp, std::string data, Callback back = NULL) = 0; ``` ### 停止共享 ```cpp theme={null} virtual StatusCode stopShare(Callback back = NULL) = 0; ``` ### 添加屏幕音频 ```cpp theme={null} virtual StatusCode addScreenAudio(bool) = 0; ``` ### 更新流输出 ```cpp theme={null} virtual StatusCode updateStreamOutput(int w, int h) = 0; ``` ### 确认打开共享 ```cpp theme={null} virtual StatusCode confirmOpenShare(int tp, std::string data, Callback back = NULL) = 0; ``` *** ## IMEETRemoteVideo 接口 继承自 `IMEETVideo`。 ### 加载远端视频 ```cpp theme={null} virtual StatusCode loadRemoteVideo() = 0; ``` ### 卸载远端视频 ```cpp theme={null} virtual StatusCode unLoadRemoteVideo() = 0; ``` *** ## IMEETRemoteAudio 接口 ### 打开扬声器 ```cpp theme={null} virtual StatusCode openSpeaker() = 0; ``` ### 关闭扬声器 ```cpp theme={null} virtual StatusCode closeSpeaker() = 0; ``` ### 切换扬声器 ```cpp theme={null} virtual StatusCode switchSpeaker(std::string name) = 0; ``` *** ## IMEETRecord 接口 ### 设置录制文件名 ```cpp theme={null} virtual StatusCode setRecordFileName(std::string filepath) = 0; ``` ### 设置水印 ```cpp theme={null} virtual StatusCode setWaterMask(std::string mask) = 0; ``` ### 开始录制 ```cpp theme={null} virtual StatusCode startRecord() = 0; ``` ### 设置录制窗口 ```cpp theme={null} virtual StatusCode setRecordHwnd(void*, int, int, int, int) = 0; ``` ### 设置录制布局成员视图 ```cpp theme={null} virtual StatusCode setRecordLayoutMemberView(std::string json) = 0; ``` ### 暂停录制 ```cpp theme={null} virtual StatusCode pauseRecord() = 0; ``` ### 停止录制 ```cpp theme={null} virtual StatusCode stopRecord() = 0; ``` *** ## IMEETVideo 接口 ### 添加播放视图 ```cpp theme={null} virtual StatusCode addPlayView(IRTCView* v) = 0; ``` ### 移除播放视图 ```cpp theme={null} virtual StatusCode removePlayView(IRTCView* v) = 0; ``` ### 移除所有播放视图 ```cpp theme={null} virtual StatusCode removeAllPlayView() = 0; ```