# 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`:失败。