# Interface LiveStreamingTranscodingConfig (/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/livestreamingtranscodingconfig)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## Properties [#properties]

<a id="audiobitrate"></a>

<a id="optional-audiobitrate"></a>

### audioBitrate [#audiobitrate]

<ApiSignature labels="Optional">

audioBitrate: number

</ApiSignature>

用于直播推流的输出音频的码率，单位为 Kbps。

正整数，默认值为 48，最大值为 128。

<a id="audiochannels"></a>

<a id="optional-audiochannels"></a>

### audioChannels [#audiochannels]

<ApiSignature labels="Optional">

audioChannels: 1|2|3|4|5

</ApiSignature>

用于直播推流的输出音频的声道数。

建议取 1 或 2。 3、4、5 需要特殊播放器支持：

- 1:（默认值）单声道
- 2: 双声道
- 3: 三声道
- 4: 四声道
- 5: 五声道

<a id="audiosamplerate"></a>

<a id="optional-audiosamplerate"></a>

### audioSampleRate [#audiosamplerate]

<ApiSignature labels="Optional">

audioSampleRate: 32000|44100|48000

</ApiSignature>

用于直播推流的输出音频的采样率。

- 32000: 音频采样率 32 kHz。
- 44100: 音频采样率 44.1 kHz。
- 48000: （默认值）音频采样率 48 kHz。

<a id="backgroundcolor"></a>

<a id="optional-backgroundcolor"></a>

### backgroundColor [#backgroundcolor]

<ApiSignature labels="Optional">

backgroundColor: number

</ApiSignature>

背景色。

默认 0x000000，必须是 16 进制格式。

<a id="backgroundimage"></a>

<a id="optional-backgroundimage"></a>

### backgroundImage [#backgroundimage]

<ApiSignature labels="Optional">

backgroundImage: [LiveStreamingTranscodingImage](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/livestreamingtranscodingimage)

</ApiSignature>

用于给直播推流的视频添加背景图片。

<a id="height"></a>

<a id="optional-height"></a>

### height [#height]

<ApiSignature labels="Optional">

height: number

</ApiSignature>

推流视频的总高度，默认值 360，单位为像素。

- 如果推视频流，`height` 值不得低于 64，否则声网会调整为 64。
- 如果推音频流，请将 `width` 和 `height` 设为 0。

<a id="images"></a>

<a id="optional-images"></a>

### images [#images]

<ApiSignature labels="Optional">

images: [LiveStreamingTranscodingImage](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/livestreamingtranscodingimage)[]

</ApiSignature>

#### deprecated [#deprecated]

用于给直播推流的视频添加水印。

推荐使用 [LiveStreamingTranscodingConfig.watermark](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/livestreamingtranscodingconfig#watermark) 为直播推流的视频添加水印。

> 目前推流后台只支持添加一张水印图片

<a id="transcodingusers"></a>

<a id="optional-transcodingusers"></a>

### transcodingUsers [#transcodingusers]

<ApiSignature labels="Optional">

transcodingUsers: [LiveStreamingTranscodingUser](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/livestreamingtranscodinguser)[]

</ApiSignature>

用于管理参与直播推流的视频合图的用户。

最多支持 17 人同时转码合图。

<a id="userconfigextrainfo"></a>

<a id="optional-userconfigextrainfo"></a>

### userConfigExtraInfo [#userconfigextrainfo]

<ApiSignature labels="Optional">

userConfigExtraInfo: string

</ApiSignature>

用户自定义的发送到旁路推流客户端的信息，用于填充 H264/H265 视频中 SEI 帧内容。长度限制：4096字节。关于 SEI 的详细信息，详见 [SEI 帧相关问题](/zh-CN/reference/faq/quality/sei)。

<a id="videobitrate"></a>

<a id="optional-videobitrate"></a>

### videoBitrate [#videobitrate]

<ApiSignature labels="Optional">

videoBitrate: number

</ApiSignature>

用于直播推流的输出视频的码率，单位为 Kbps，默认值 400。

<a id="videocodecprofile"></a>

<a id="optional-videocodecprofile"></a>

### videoCodecProfile [#videocodecprofile]

<ApiSignature labels="Optional">

videoCodecProfile: 66|77|100

</ApiSignature>

用于直播推流的输出视频的编码规格。

可以设置为 `66`、`77` 或 `100`。如果设置其他值，声网会统一设为默认值 `100`。

- `66`: Baseline 级别的视频编码规格，一般用于低阶或需要额外容错的应用，比如视频通话、手机视频等。
- `77`: Main 级别的视频编码规格，一般用于主流消费类电子产品，如 MP4、便携的视频播放器、PSP 和 iPad 等。
- `100`:（默认）High 级别的视频编码规格，一般用于广播及视频碟片存储，高清电视。

<a id="videoframerate"></a>

<a id="optional-videoframerate"></a>

### videoFrameRate [#videoframerate]

<ApiSignature labels="Optional">

videoFrameRate: number

</ApiSignature>

用于直播推流的输出视频的帧率，单位为 fps，默认值 15。

声网会将高于 30 的帧率设置改为 30。

<a id="videogop"></a>

<a id="optional-videogop"></a>

### videoGop [#videogop]

<ApiSignature labels="Optional">

videoGop: number

</ApiSignature>

用于直播推流的输出视频的 GOP，单位为帧，默认值 30。

<a id="watermark"></a>

<a id="optional-watermark"></a>

### watermark [#watermark]

<ApiSignature labels="Optional">

watermark: [LiveStreamingTranscodingImage](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/livestreamingtranscodingimage)

</ApiSignature>

用于给直播推流的视频添加水印。

<a id="width"></a>

<a id="optional-width"></a>

### width [#width]

<ApiSignature labels="Optional">

width: number

</ApiSignature>

推流视频的总宽度，默认值 640，单位为像素。

- 如果推视频流，`width` 值不得低于 64，否则声网会调整为 64。
- 如果推音频流，请将 `width` 和 `height` 设为 0。