# LiveTranscoding (/zh-CN/api-reference/rtc/android/class-livetranscoding)

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

<a id="class_livetranscoding__prototype"></a>

```java
public class LiveTranscoding {
  public int width;
  public int height;
  public int videoBitrate;
  public int videoFramerate;
  @Deprecated public boolean lowLatency;
  public int videoGop;
  private ArrayList<AgoraImage> watermarkList;
  private ArrayList<AgoraImage> backgroundImageList;
  public AudioSampleRateType audioSampleRate;
  public int audioBitrate;
  public int audioChannels;
  public AudioCodecProfileType audioCodecProfile;
  public VideoCodecProfileType videoCodecProfile;
  public VideoCodecType videoCodecType;
  @Deprecated public int userCount;
  @Deprecated public int backgroundColor;
  public String userConfigExtraInfo;
  @Deprecated public String metadata;
  private Map<Integer, TranscodingUser> transcodingUsers;
  private Map<String, Boolean> advancedFeatures;
}
```

<a id="class_livetranscoding__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="width"></a>
<Parameter name="width">

视频宽度，单位为像素，默认值为 360。

- 当推送视频流至 CDN 时，`width` 的取值范围为 [64,1920]。若该值小于 64，声网服务器会自动调整为 64；若该值大于 1920，则自动调整为 1920。
- 当推送音频流至 CDN 时，请将 `width` 和 `height` 设置为 0。

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

视频高度，单位为像素，默认值为 640。

- 当推送视频流至 CDN 时，`height` 的取值范围为 [64,1080]。若该值小于 64，声网服务器会自动调整为 64；若该值大于 1080，则自动调整为 1080。
- 当推送音频流至 CDN 时，请将 `width` 和 `height` 设置为 0。

</Parameter>
<a id="videobitrate"></a>
<Parameter name="videoBitrate">

视频编码码率（Kbps）。无需设置该参数，仅保留默认值 STANDARD_BITRATE 即可。SDK 会根据已设置的视频分辨率和帧率自动匹配最合适的码率。关于视频分辨率与帧率的对应关系，详见 `Video profile`。

</Parameter>
<a id="videoframerate"></a>
<Parameter name="videoFramerate">

媒体推流设置的视频输出帧率（fps），默认值为 15。该值的取值范围为 (0,30]。

:::note
注： 声网服务器会将大于 30 的值调整为 30。
:::

</Parameter>
<a id="lowlatency"></a>
<Parameter name="lowLatency">

延迟模式：

- true：低延迟模式，但无法保证画质。
- false：默认值，高延迟但可保证画质。

</Parameter>
<a id="videogop"></a>
<Parameter name="videoGop">

媒体推流中视频帧的 GOP（图像组）设置，单位为帧，默认值为 30。

</Parameter>
<a id="audiosamplerate"></a>
<Parameter name="audioSampleRate">

媒体输出流的音频采样率（Hz）。详见 [AudioSampleRateType](/zh-CN/api-reference/rtc/android/enum-audiosampleratetype)。

</Parameter>
<a id="audiobitrate"></a>
<Parameter name="audioBitrate">

音频输出流的编码码率，单位为 Kbps，默认值为 48，最大值为 128。

</Parameter>
<a id="audiochannels"></a>
<Parameter name="audioChannels">

媒体推流使用的音频声道数。声网建议选择 1（单声道）或 2（立体声）。若选择 3、4 或 5，则需要特定播放器支持。

- 1：默认值，单声道。
- 2：立体声。
- 3：三声道。
- 4：四声道。
- 5：五声道。

</Parameter>
<a id="audiocodecprofile"></a>
<Parameter name="audioCodecProfile">

媒体推流使用的音频编码器配置类型。详见 [AudioCodecProfileType](/zh-CN/api-reference/rtc/android/enum-audiocodecprofiletype)。

</Parameter>
<a id="videocodecprofile"></a>
<Parameter name="videoCodecProfile">

媒体推流使用的视频编码器配置类型。可设置为 66、77 或默认值 100。详见 [VideoCodecProfileType](/zh-CN/api-reference/rtc/android/enum-videocodecprofiletype)。

:::note
注： 如果设置为其他值，声网会自动使用默认值。
:::

</Parameter>
<a id="videocodectype"></a>
<Parameter name="videoCodecType">

媒体推流使用的视频编码器类型。详见 [VideoCodecType](/zh-CN/api-reference/rtc/android/enum-videocodectypeforstream)。

</Parameter>
<a id="usercount"></a>
<Parameter name="userCount">

媒体推流中用户数量，取值范围为 [0,17]。

</Parameter>
<a id="userconfigextrainfo"></a>
<Parameter name="userConfigExtraInfo">

保留字段。用于将用户自定义的信息以 SEI 的形式随 H.264/H.265 视频流发送至 CDN 侧播放端，最大字节长度为 4096。

</Parameter>
<a id="metadata"></a>
<Parameter name="metadata">

发送至 CDN 客户端的元数据内容。

</Parameter>
</ParameterList>

### 相关参考 [#相关参考]

- [addBackgroundImage](/zh-CN/api-reference/rtc/android/api-livetranscoding-addbackgroundimage)
- [addUser](/zh-CN/api-reference/rtc/android/api-livetranscoding-adduser)
- [addWatermark](/zh-CN/api-reference/rtc/android/api-livetranscoding-addwatermark)
- [getAdvancedFeatures](/zh-CN/api-reference/rtc/android/api-livetranscoding-getadvancedfeatures)
- [getBackgroundColor](/zh-CN/api-reference/rtc/android/api-livetranscoding-getbackgroundcolor)
- [getBackgroundImageList](/zh-CN/api-reference/rtc/android/api-livetranscoding-getbackgroundimagelist)
- [getBlue](/zh-CN/api-reference/rtc/android/api-livetranscoding-getblue)
- [getGreen](/zh-CN/api-reference/rtc/android/api-livetranscoding-getgreen)
- [getRed](/zh-CN/api-reference/rtc/android/api-livetranscoding-getred)
- [getUserCount](/zh-CN/api-reference/rtc/android/api-livetranscoding-getusercount)
- [getUsers](/zh-CN/api-reference/rtc/android/api-livetranscoding-getusers)
- [getWatermarkList](/zh-CN/api-reference/rtc/android/api-livetranscoding-getwatermarklist)
- [removeBackgroundImage](/zh-CN/api-reference/rtc/android/api-livetranscoding-removebackgroundimage)
- [removeUser](/zh-CN/api-reference/rtc/android/api-livetranscoding-removeuser)
- [removeWatermark](/zh-CN/api-reference/rtc/android/api-livetranscoding-removewatermark)
- [setAdvancedFeatures](/zh-CN/api-reference/rtc/android/api-livetranscoding-setadvancedfeatures)
- [setBackgroundColor [1/2]](/zh-CN/api-reference/rtc/android/api-livetranscoding-setbackgroundcolor)
- [setBackgroundColor [2/2]](/zh-CN/api-reference/rtc/android/api-livetranscoding-setbackgroundcolor2)
- [setBlue](/zh-CN/api-reference/rtc/android/api-livetranscoding-setblue)
- [setGreen](/zh-CN/api-reference/rtc/android/api-livetranscoding-setgreen)
- [setRed](/zh-CN/api-reference/rtc/android/api-livetranscoding-setred)
- [setUsers [1/2]](/zh-CN/api-reference/rtc/android/api-livetranscoding-setusers)
- [setUsers [2/2]](/zh-CN/api-reference/rtc/android/api-livetranscoding-setusers2)