media-tracks

BaseTrack
├── LocalAudioTrack          ← 本地音频基类（自定义音频流）
│   └── LocalMicTrack        ← 麦克风流
├── LocalVideoTrack          ← 本地视频基类（自定义视频流）
│   ├── LocalCameraTrack     ← 摄像头流
│   └── LocalScreenTrack     ← 屏幕共享流（含系统音频）
├── RemoteAudioTrack         ← 远端单路音频流
│   └── RemoteAudioMixTrack  ← 远端全频道混音流
└── RemoteVideoTrack         ← 远端视频流

get id(): string
```typescript

轨道 ID，在频道内唯一标识该轨道。

#### kind

```typescript
get kind(): TrackKind

get desc(): string
```typescript

轨道描述，由发布时指定（如 `'camera_big'`、`'screen'`）。

#### getInfo

获取完整轨道信息（分辨率、码率、采样率等）。

```typescript
getInfo(): TrackInfo

getUid(): string
```typescript

#### getMediaStreamTrack

获取底层 `MediaStreamTrack`（可用于自定义处理，如 Web Audio API 接入）。

```typescript
getMediaStreamTrack(): MediaStreamTrack | undefined

startPlay(opt?: AudioOutputOptions): Promise<void>
```typescript

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | :---: | --- |
| `opt` | `AudioOutputOptions` | 否 | 播放配置，可指定扬声器设备 |

#### stopPlay

停止播放，释放对播放设备的占用。

```typescript
stopPlay(): void

getVolume(): number
```typescript

#### isPlaying

当前是否正在播放。

```typescript
isPlaying(): boolean

startCapture(opt?: MicCaptureOptions): Promise<void>
```typescript

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | :---: | --- |
| `opt` | `MicCaptureOptions` | 否 | 采集配置，可指定设备 ID、回声消除等 |

#### stopCapture

停止采集，释放麦克风设备。

```typescript
stopCapture(): void

changeDeviceId(deviceId: string): Promise<void>
```typescript

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | :---: | --- |
| `deviceId` | `string` | 是 | 目标设备 ID（从 `getDevices('audioinput')` 获取） |

---

## LocalVideoTrack

本地视频轨道基类，也用于自定义视频流（通过 `srtc.createLocalCustomVideoTrack` 创建）。

继承自 `BaseTrack`。

#### addPlayView

将视频渲染到指定 HTML 容器元素。

```typescript
addPlayView(container: HTMLElement): void

hasPlayView(): boolean
```typescript

#### removePlayView

移除指定渲染容器。

```typescript
removePlayView(container: HTMLElement): void

removeAllPlayViews(): void
```typescript

#### getSimulcastTrack

获取联播（Simulcast）模式下的指定清晰度轨道（需发布时配置了 Simulcast）。

```typescript
getSimulcastTrack(layer: 'high' | 'medium' | 'low'): MediaStreamTrack | undefined

startCapture(opt?: CameraCaptureOptions): Promise<void>
```typescript

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | :---: | --- |
| `opt` | `CameraCaptureOptions` | 否 | 采集配置，可指定设备 ID、分辨率、帧率 |

#### stopCapture

停止采集，释放摄像头设备。

```typescript
stopCapture(): void

changeDeviceId(deviceId: string): Promise<void>
```typescript

#### switchFacingMode

在前置/后置摄像头之间切换（仅移动端）。

```typescript
switchFacingMode(): Promise<void>

startCapture(opt?: ScreenCaptureOptions): Promise<void>
```typescript

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | :---: | --- |
| `opt` | `ScreenCaptureOptions` | 否 | 采集配置，可指定分辨率、帧率、内容提示 |

#### stopCapture

停止屏幕采集。

```typescript
stopCapture(): void

getAudioTrack(): LocalAudioTrack | undefined
```typescript

> 详细用法见 [屏幕共享 - 同时采集系统音频](/zh/rtc/web/advanced/screen-sharing#同时采集系统音频)

---

## RemoteAudioTrack

远端单路音频轨道，通过 `srtc.subscribeRemoteAudioTrack` 订阅。

继承自 `BaseTrack`。

#### startPlay

播放远端音频。

```typescript
startPlay(opt?: AudioOutputOptions): Promise<void>

stopPlay(): void
```typescript

---

## RemoteAudioMixTrack

远端全频道混音流，继承自 `RemoteAudioTrack`，通过 `srtc.subscribeRemoteAudioMixTrack` 订阅。

大多数场景下只需要订阅这一路混音流，而无需订阅每个用户的单独音频流。

#### getFilterUids

获取当前从混音中排除的用户 ID 列表。

```typescript
getFilterUids(): string[]

addPlayView(container: HTMLElement): void
```typescript

#### hasPlayView

判断是否已有渲染容器。

```typescript
hasPlayView(): boolean

removePlayView(container: HTMLElement): void
```typescript

#### removeAllPlayViews

移除所有渲染容器。

```typescript
removeAllPlayViews(): void