SRTC - STMLink 文档

SRTC 是 Web SDK 的核心入口，通过 new SRTC(initParams) 创建实例。本页中的频道级方法（发布、订阅、成员查询、leave 等）与 join 返回的 Channel 对象上的同名方法等价，作用于当前（默认）频道；同时加入多个频道时改用各 Channel 对象调用以区分操作目标，详见多频道。

constructor

constructor(initParams: SdkInitParams)

参数	类型	必填	说明
`initParams`	`SdkInitParams`	是	初始化参数，详见 SdkInitParams

buildInfo

获取 SDK 编译信息。

buildInfo(): BuildInfo

getEnvInfo

获取当前浏览器的 WebRTC 能力检测结果，建议在初始化后尽早调用。

getEnvInfo(): EnvWebInfo

返回值： EnvWebInfo，详见 EnvWebInfo

onNotifyChannelEvent

频道内事件回调，建议在 join 前注册。

onNotifyChannelEvent?: ((event: ChannelEvent) => void) | null

完整事件类型详见事件参考。

onNotifyImEvent

频道外 IM 事件回调。

onNotifyImEvent?: ((event: ImEvent) => void) | null

join

加入频道，返回该频道的 Channel 对象。频道信息通过 channel.getInfo() 获取。

join(token: string, options?: JoinOptions): Promise<Channel>

参数	类型	必填	说明
`token`	`string`	是	服务端签发的加入频道 Token
`options`	`JoinOptions`	否	加入选项，详见 JoinOptions

可多次调用同时加入多个频道；单频道应用可忽略返回值，继续使用 srtc 实例上的频道级方法（作用于当前频道）。Channel 对象的方法与多频道用法详见多频道。

从旧版本迁移：join 原先返回 ChannelInfo，现改为返回 Channel 对象，原返回值等价于 (await srtc.join(token)).getInfo()。

leave

主动离开频道。对于本地轨道，SDK 会在离会后自动停止采集、停止播放或移除播放视图。

leave(): Promise<void>

多频道时作用于最早加入的频道，等价于该频道的 channel.leave()；退某个特定频道请直接调用其 Channel 对象的 leave()。

getChannelInfo

获取当前频道信息。未加入频道时返回 null。

getChannelInfo(): ChannelInfo | null

getUserInfo

获取频道内指定用户信息。

getUserInfo(uid: string): UserInfo

参数	类型	必填	说明
`uid`	`string`	是	用户 ID

getUsersInfo

获取频道内所有用户信息，支持数组和映射两种返回格式。

getUsersInfo(map: true): Record<string, UserInfo>
getUsersInfo(map: false): UserInfo[]

getStreamMetric

获取当前流媒体全量 metric 快照，包含网络总体统计以及每条本地/远端轨道的 TrackMetric。

getStreamMetric(): StreamMetric | undefined

未加入频道时调用会抛出异常。详细字段含义见网络质量。

getNetworkStats

获取当前网络总体统计，只关心网络全景（码率、丢包、RTT、可用带宽）时用，比 getStreamMetric 更轻量。

getNetworkStats(): NetworkStats | undefined

未加入频道时调用会抛出异常。

getConnectionQuality

获取当前连接质量评估结果，返回上下行等级、总体等级、MOS 和触发原因。SDK 内部以 2 秒为周期滑动窗口评估。

getConnectionQuality(): QualityEvaluation | undefined

未加入频道时调用会抛出异常。业务层更推荐订阅 ChannelEventType.CONNECTION_QUALITY_CHANGED 事件被动感知变化。

getDevices

枚举媒体设备列表。

getDevices(kind?: MediaDeviceKind, requestPermissions?: boolean): Promise<MediaDeviceInfo[]>

参数	类型	必填	说明
`kind`	`'audioinput' \| 'audiooutput' \| 'videoinput'`	否	不传则返回所有类型设备
`requestPermissions`	`boolean`	否	是否主动请求媒体权限，默认 `true`

createLocalMicTrack

创建麦克风音频轨道。

createLocalMicTrack(preset?: MicPreset): LocalMicTrack

参数	类型	必填	说明
`preset`	`MicPreset`	否	麦克风预设，默认 `MicPresets.music`

createLocalCustomAudioTrack

使用自定义 MediaStreamTrack 创建本地音频轨道。

createLocalCustomAudioTrack(msTrack: MediaStreamTrack): LocalAudioTrack

参数	类型	必填	说明
`msTrack`	`MediaStreamTrack`	是	音频类型的 `MediaStreamTrack`

createLocalCameraTrack

创建摄像头视频轨道。

createLocalCameraTrack(preset?: CameraPreset): LocalCameraTrack

参数	类型	必填	说明
`preset`	`CameraPreset`	否	摄像头预设，默认 `CameraPresets['720p']`

createLocalScreenTrack

创建屏幕共享视频轨道。

createLocalScreenTrack(preset?: ScreenPreset, audioPreset?: ScreenAudioPreset): LocalScreenTrack

参数	类型	必填	说明
`preset`	`ScreenPreset`	否	视频预设，默认 `ScreenPresets['1080p']`
`audioPreset`	`ScreenAudioPreset`	否	系统音频预设，默认 `ScreenAudioPresets.default`

默认会同时创建系统音频轨道。真正能否采集到系统音频，还取决于浏览器能力和用户是否在系统分享弹窗中勾选“分享音频”。

createLocalCustomVideoTrack

使用自定义 MediaStreamTrack 创建本地视频轨道。

createLocalCustomVideoTrack(msTrack: MediaStreamTrack): LocalVideoTrack

参数	类型	必填	说明
`msTrack`	`MediaStreamTrack`	是	视频类型的 `MediaStreamTrack`

createLocalCompositeRecorder

创建本地合成录制器，用于在浏览器端把当前页面需要录制的视频宫格和音频轨道合成为本地录制文件。

createLocalCompositeRecorder(): LocalCompositeRecorder

返回的 LocalCompositeRecorder 只负责媒体合成与 MediaRecorder 生命周期；会议宫格、分页、主讲人布局、共享屏幕优先级等业务视角由应用层计算后，通过 videoItems 和 updateVideoItems(...) 传入。

详细用法见本地合成录制。

publishLocalTrack

将本地轨道发布到频道，发布后远端用户可以订阅。

publishLocalTrack(
  track: LocalAudioTrack | LocalVideoTrack,
  opt?: Partial<AudioPublishOptions> | Partial<VideoPublishOptions>
): Promise<TrackInfo>

参数	类型	必填	说明
`track`	`LocalAudioTrack \| LocalVideoTrack`	是	要发布的本地轨道
`opt`	`Partial<AudioPublishOptions> \| Partial<VideoPublishOptions>`	否	发布参数，会与创建轨道时的预设参数合并

返回值： TrackInfo，本次发布在频道内的轨道描述快照；后续要拿最新值请用 channel.getPublishInfo(track)。

同一个频道内，一个 desc 只能有一条轨道处于发布状态。用另一条轨道重复发布同一个 desc（例如已经发着一条 mic，又发布第二条 mic）会抛错；同一条轨道重复发布不受影响，仍是幂等的。所以开麦、开摄像头这类入口要自行串行：上一次 publishLocalTrack 还没 await 完就再发一次，两条轨道会同时推流，而你手上通常只留得下后创建的那条引用，先发的那条就再也取消不掉了。

unpublishLocalTrack

停止发布本地轨道，远端用户将收到 USER_TRACK_REMOVE 事件。

unpublishLocalTrack(track: LocalAudioTrack | LocalVideoTrack): Promise<void>

enableLocalTrack

恢复已暂停的本地轨道数据发送。

enableLocalTrack(track: LocalAudioTrack | LocalVideoTrack): Promise<void>

远端会收到 TRACK_UNMUTED 事件。与 publishLocalTrack 的区别详见静音 vs 停止发布。

disableLocalTrack

暂停本地轨道数据发送，但不取消发布。

disableLocalTrack(track: LocalAudioTrack | LocalVideoTrack): void

远端会收到 TRACK_MUTED 事件。与 unpublishLocalTrack 的区别详见静音 vs 停止发布。

subscribeRemoteAudioMixTrack

订阅全频道混音流。

subscribeRemoteAudioMixTrack(
  filter?: string[] | ((track: BaseTrack) => boolean)
): Promise<RemoteAudioMixTrack>

参数	类型	必填	说明
`filter`	`string[] \| ((track: BaseTrack) => boolean)`	否	传 `string[]` 时按 UID 排除；传函数时按轨道判断是否过滤

subscribeRemoteAudioTrack

订阅指定用户的单路音频流。

subscribeRemoteAudioTrack(uid: string, id: string): Promise<RemoteAudioTrack>

参数	类型	必填	说明
`uid`	`string`	是	用户 ID
`id`	`string`	是	轨道 ID，可从 `TrackInfo.id` 获取

subscribeRemoteVideoTrack

订阅指定用户的视频流。

subscribeRemoteVideoTrack(uid: string, id: string): Promise<RemoteVideoTrack>

参数	类型	必填	说明
`uid`	`string`	是	用户 ID
`id`	`string`	是	轨道 ID，可从 `TrackInfo.id` 获取

subscribeRemoteVideoMcuTrack

订阅远端视频合成流。

subscribeRemoteVideoMcuTrack(): Promise<RemoteVideoMcuTrack>

RemoteVideoMcuTrack 继承自 RemoteVideoTrack，可按普通远端视频轨道使用。

unsubscribeRemoteTrack

取消订阅远端流。

unsubscribeRemoteTrack(
  track: RemoteAudioMixTrack | RemoteAudioTrack | RemoteVideoTrack
): Promise<void>

getRemoteTrack

通过用户 ID 与轨道 ID 或轨道描述获取已订阅的远端轨道实例。

getRemoteTrack(uid: string, id?: string, desc?: string): RemoteAudioTrack | RemoteVideoTrack

参数	类型	必填	说明
`uid`	`string`	是	用户 ID
`id`	`string`	否	轨道 ID，与 `desc` 二选一
`desc`	`string`	否	轨道描述，与 `id` 二选一

id 和 desc 至少要传一个，否则会抛出异常。

enableIm

启用频道外 IM 消息功能。

enableIm(token: string): Promise<string>

参数	类型	必填	说明
`token`	`string`	是	IM 启用 Token

返回值： Promise<string>，返回 IM 会话 sid。

disableIm

关闭频道外 IM 消息功能。

disableIm(): Promise<void>

destroy

彻底释放 SRTC 实例：依次离开所有频道、关闭 IM，并解除实例在浏览器全局对象上注册的监听（设备插拔、页面可见性）。幂等，重复调用直接返回；调用后再使用该实例的方法会抛错。

destroy(): Promise<void>

不调用 destroy() 时，全局监听会一直持有实例引用、使其无法被回收。因此在 SPA 路由切走音视频页面、组件卸载、或重建新 SRTC 实例之前必须调用；实例与页面同生命周期的应用可以不调。日常进出频道用 leave()（或 channel.leave()）即可，实例可复用继续 join。

​constructor

​buildInfo

​getEnvInfo

​onNotifyChannelEvent

​onNotifyImEvent

​join

​leave

​getChannelInfo

​getUserInfo

​getUsersInfo

​getStreamMetric

​getNetworkStats

​getConnectionQuality

​getDevices

​createLocalMicTrack

​createLocalCustomAudioTrack

​createLocalCameraTrack

​createLocalScreenTrack

​createLocalCustomVideoTrack

​createLocalCompositeRecorder

​publishLocalTrack

​unpublishLocalTrack

​enableLocalTrack

​disableLocalTrack

​subscribeRemoteAudioMixTrack

​subscribeRemoteAudioTrack

​subscribeRemoteVideoTrack

​subscribeRemoteVideoMcuTrack

​unsubscribeRemoteTrack

​getRemoteTrack

​enableIm

​disableIm

​destroy