# agora::rtc::ILocalVideoTrack类 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track)

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

继承自 [agora::rtc::IVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-track).

<a id="details"></a>

## 详细描述 [#详细描述]

[`ILocalVideoTrack`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) 类提供本地视频轨道的基本方法。

你可以通过 [publishVideo](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user#a40690b61671aa9e6ceef1e7347fd3e38) 方法发布一个或多个视频轨道。

## 构造及析构函数说明 [#构造及析构函数说明]

<a id="a7e36626a9d79baabffb6010356a48aeb"></a>

### ~ILocalVideoTrack() [#ilocalvideotrack]

<ApiSignature labels="inline protected">

agora::rtc::ILocalVideoTrack::~ILocalVideoTrack()

</ApiSignature>

## 成员函数说明 [#成员函数说明]

<a id="a9f297ef1b10e76ee54bb9102059e8ab8"></a>

### setEnabled() [#setenabled]

<ApiSignature labels="pure virtual">

virtual void agora::rtc::ILocalVideoTrack::setEnabled(bool *enable*, aosl_ref_t *ares* = `AOSL_REF_INVALID`)

</ApiSignature>

开启或关闭本地视频轨道。

本地视频轨道开启之后，SDK 可以对采集、处理和编码本地视频。

<ParameterList title="参数">
<Parameter name="enable">

开启或关闭本地视频轨道。

- `true`: 开启本地视频轨道。
- `false`: 关闭本地视频轨道。

</Parameter>
<Parameter name="ares">

用于 SDK 的生命周期保护，填写默认值即可。

</Parameter>
</ParameterList>

<a id="a0c5423ecd9dcde4fda0ac56d329f456d"></a>

### setVideoEncoderConfiguration() [#setvideoencoderconfiguration]

<ApiSignature labels="pure virtual">

virtual int agora::rtc::ILocalVideoTrack::setVideoEncoderConfiguration(const [VideoEncoderConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-encoder-configuration) & *config*, aosl_ref_t *ares* = `AOSL_REF_INVALID`)

</ApiSignature>

设置视频编码属性。

<ParameterList title="参数">
<Parameter name="config">

视频编码参数配置。详见 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-encoder-configuration) 。

</Parameter>
<Parameter name="ares">

用于 SDK 的生命周期保护，填写默认值即可。

</Parameter>
</ParameterList>

<h4 data-toc-hidden="true" id={"返回值"}>返回值</h4>

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。

<a id="ae9f954672d4b7a99e645459ce4c1083a"></a>

### setSimulcastStreamMode() [#setsimulcaststreammode]

<ApiSignature labels="pure virtual">

virtual int agora::rtc::ILocalVideoTrack::setSimulcastStreamMode([SIMULCAST_STREAM_MODE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a0ec618f678ca12272679cbb93e01f3f4) *mode*, const [SimulcastConfigInternal](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-simulcast-config-internal) & *config*, aosl_ref_t *ares* = `AOSL_REF_INVALID`)

</ApiSignature>

在发送端设置双流模式并设置视频小流。

<ParameterList title="参数">
<Parameter name="mode">

发送视频流的模式。详见 [SIMULCAST_STREAM_MODE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a0ec618f678ca12272679cbb93e01f3f4) 。

</Parameter>
<Parameter name="config">

视频小流的配置。详见 [SimulcastConfigInternal](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-simulcast-config-internal) 。当设置 `mode` 参数为 `DISABLE_SIMULCAST_STREAM` 时，`config` 参数不会生效。

</Parameter>
<Parameter name="ares">

用于 SDK 的生命周期保护，填写默认值即可。

</Parameter>
</ParameterList>

<h4 data-toc-hidden="true" id={"返回值-1"}>返回值</h4>

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。

<a id="a36640f215f62a7fa34ba9cae81497468"></a>

### getState() [#getstate]

<ApiSignature labels="pure virtual">

virtual [LOCAL_VIDEO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a7c8ce313cb6ccb0d186953bd06e6200b) agora::rtc::ILocalVideoTrack::getState()

</ApiSignature>

获取本地视频流状态。

<h4 data-toc-hidden="true" id={"返回值-2"}>返回值</h4>

本地视频流状态： [LOCAL_VIDEO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a7c8ce313cb6ccb0d186953bd06e6200b) 。

<a id="a1aa1259d42007c44273b3e0a0369efe1"></a>

### getStatistics() [#getstatistics]

<ApiSignature labels="pure virtual">

virtual bool agora::rtc::ILocalVideoTrack::getStatistics([LocalVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-video-track-stats) & *stats*)

</ApiSignature>

获取本地视频轨道的统计信息。

<ParameterList title="参数">
<Parameter name="stats" direction="[out]">

统计信息： [LocalVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-video-track-stats)。

</Parameter>
</ParameterList>

<h4 data-toc-hidden="true" id={"返回值-3"}>返回值</h4>

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。