# 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).
## 详细描述 [#详细描述]
[`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) 方法发布一个或多个视频轨道。
## 构造及析构函数说明 [#构造及析构函数说明]
### ~ILocalVideoTrack() [#ilocalvideotrack]
agora::rtc::ILocalVideoTrack::~ILocalVideoTrack()
## 成员函数说明 [#成员函数说明]
### setEnabled() [#setenabled]
virtual void agora::rtc::ILocalVideoTrack::setEnabled(bool *enable*, aosl_ref_t *ares* = `AOSL_REF_INVALID`)
开启或关闭本地视频轨道。
本地视频轨道开启之后,SDK 可以对采集、处理和编码本地视频。
开启或关闭本地视频轨道。
- `true`: 开启本地视频轨道。
- `false`: 关闭本地视频轨道。
用于 SDK 的生命周期保护,填写默认值即可。
### setVideoEncoderConfiguration() [#setvideoencoderconfiguration]
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`)
设置视频编码属性。
视频编码参数配置。详见 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-encoder-configuration) 。
用于 SDK 的生命周期保护,填写默认值即可。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### setSimulcastStreamMode() [#setsimulcaststreammode]
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`)
在发送端设置双流模式并设置视频小流。
发送视频流的模式。详见 [SIMULCAST_STREAM_MODE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a0ec618f678ca12272679cbb93e01f3f4) 。
视频小流的配置。详见 [SimulcastConfigInternal](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-simulcast-config-internal) 。当设置 `mode` 参数为 `DISABLE_SIMULCAST_STREAM` 时,`config` 参数不会生效。
用于 SDK 的生命周期保护,填写默认值即可。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### getState() [#getstate]
virtual [LOCAL_VIDEO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a7c8ce313cb6ccb0d186953bd06e6200b) agora::rtc::ILocalVideoTrack::getState()
获取本地视频流状态。
返回值
本地视频流状态: [LOCAL_VIDEO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a7c8ce313cb6ccb0d186953bd06e6200b) 。
### getStatistics() [#getstatistics]
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*)
获取本地视频轨道的统计信息。
统计信息: [LocalVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-video-track-stats)。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### registerVideoMetadataObserver() [#registervideometadataobserver]
virtual int agora::rtc::ILocalVideoTrack::registerVideoMetadataObserver([IMetadataObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer) * *metadataObserver*, aosl_ref_t *ares* = `AOSL_REF_INVALID`)
注册视频 Metadata 观测器,用于发送和接收视频附属信息。
:::info[自从]
4.4.33
:::
Metadata 观测器:IMetadataObserver。
异步操作引用,默认值为 `AOSL_REF_INVALID`。
返回值
`0`:成功;小于 `0`:失败。
### unregisterVideoMetadataObserver() [#unregistervideometadataobserver]
virtual int agora::rtc::ILocalVideoTrack::unregisterVideoMetadataObserver([IMetadataObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer) * *metadataObserver*)
注销视频 Metadata 观测器。
:::info[自从]
4.4.33
:::
要注销的 Metadata 观测器。
返回值
`0`:成功;小于 `0`:失败。