# Interface ICameraVideoTrack (/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
可以通过 [AgoraRTC.createCameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartc#createcameravideotrack) 来获取。
## Properties [#properties]
### enabled [#enabled]
enabled: boolean
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[enabled](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#enabled)
本地轨道当前的启用状态。
### isPlaying [#isplaying]
isPlaying: boolean
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[isPlaying](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#isplaying)
媒体轨道是否正在页面上播放。
- `true`: 媒体轨道正在页面上播放。
- `false`: 媒体轨道没有在页面上播放。
### muted [#muted]
muted: boolean
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[muted](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#muted)
本地媒体轨道当前的静音状态。
### processorDestination [#processordestination]
processorDestination: IBaseProcessor
Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack).[processorDestination](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack#processordestination)
:::info[自从]
*4.10.0*
本地视频轨道上当前媒体处理链路的最终节点。
:::
### trackMediaType [#trackmediatype]
trackMediaType: "audio"|"video"
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[trackMediaType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#trackmediatype)
媒体轨道的类型:
- `"audio"`: 音频轨道。
- `"video"`: 视频轨道。
## Methods [#methods]
### clone [#clone]
clone(config?: [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/videoencoderconfiguration) | [VideoEncoderConfigurationPreset](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#videoencoderconfigurationpreset), cloneTrack?: boolean): [ICameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack)
Overrides [ILocalVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocalvideotrack).[clone](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocalvideotrack#clone)
:::info[自从]
*4.19.0*
复制当前的视频轨道对象,生成一个新的视频轨道。
在视频会议、在线教育等场景中,你可以用该方法实现同一视频流的两路显示,并为每路显示设置不同的分辨率、帧率、码率等参数。
:::
[VideoEncoderConfiguration](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/videoencoderconfiguration) | [VideoEncoderConfigurationPreset](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#videoencoderconfigurationpreset)
新生成视频轨道的编码配置。你可以通过 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/videoencoderconfiguration) 传入 SDK 内置的编码配置;也可以通过传入一个 [VideoEncoderConfigurationPreset](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#videoencoderconfigurationpreset) 来自定义视频编码配置。
是否克隆当前轨道。默认为 `true`。
[ICameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack)
新生成的视频轨道。
### close [#close]
close(): void
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[close](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#close)
关闭本地轨道,并释放相关采集设备。
一旦本地轨道被关闭,就无法再次使用。如需再次使用本地轨道,需要重新创建。
void
### getCurrentFrameData [#getcurrentframedata]
getCurrentFrameData(): ImageData
Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack).[getCurrentFrameData](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack#getcurrentframedata)
:::info[自从]
*4.1.0*
获取当前渲染的视频帧数据。
**注意:**
只有在播放后才能调用此方法,如果没有调用 [play](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack#play) 则返回空数据。
:::
ImageData
存储了 RGBA 数据的 `ImageData` 对象。该对象为浏览器原生对象,详见 [ImageData](https://developer.mozilla.org/zh-CN/docs/Web/API/ImageData)。
### getListeners [#getlisteners]
getListeners(event: string): Function[]
Inherited from EventEmitter.getListeners
指定一个事件名,获取当前所有监听这个事件的回调函数。
事件名称。
Function[]
### getMediaStreamTrack [#getmediastreamtrack]
getMediaStreamTrack(): MediaStreamTrack
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getMediaStreamTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#getmediastreamtrack)
获取浏览器原生的 [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack) 对象。
MediaStreamTrack
一个 [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack) 对象。
### getRTCRtpTransceiver [#getrtcrtptransceiver]
getRTCRtpTransceiver(type?: [StreamType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/streamtype)): RTCRtpTransceiver | undefined
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getRTCRtpTransceiver](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#getrtcrtptransceiver)
获取当前轨道的 [RTCRtpTransceiver](https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpTransceiver) 实例。
该方法目前主要用于视频流的[端到端加密(Beta)](/zh-CN/realtime-media/rtc/build/security-and-auth/e2e-encryption)。
:::caution[注意]
如果 SDK 发生断线重连,当前轨道对应的 `RTCRtpTransceiver` 实例可能会发生变化。你可以通过以下回调来获取新的 `RTCRtpTransceiver` 实例:
- 本地轨道:[ILocalTrack.transceiver-updated](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack#event_transceiver_updated)
- 远端轨道:[IRemoteTrack.transceiver-updated](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iremotetrack#event_transceiver_updated_2)
:::
[StreamType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/streamtype)
视频流的类型。详见 [StreamType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/streamtype)。
RTCRtpTransceiver | undefined
当前轨道的 `RTCRtpTransceiver` 实例。
### getStats [#getstats]
getStats(): [LocalVideoTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/localvideotrackstats)
Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack).[getStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack#getstats)
Overrides [ILocalTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack).[getStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack#getstats)
获取本地视频轨道的相关信息。
:::warning[deprecated]
自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getLocalVideoStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#getlocalvideostats) 和 [AgoraRTCClient.getLocalAudioStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#getlocalaudiostats)。
:::
[LocalVideoTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/localvideotrackstats)
### getTrackId [#gettrackid]
getTrackId(): string
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getTrackId](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#gettrackid)
获取由 SDK 生成的对于媒体轨道来说的唯一 ID。
string
媒体轨道 ID。
### getTrackLabel [#gettracklabel]
getTrackLabel(): string
Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getTrackLabel](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#gettracklabel)
获取本地轨道的来源描述。
string
可能返回以下值:
- 如果是通过 `createMicrophoneAudioTrack` 或 `createCameraVideoTrack` 创建的轨道,返回 [MediaDeviceInfo.label](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo/label) 字段。
- 如果是通过 `createScreenVideoTrack` 创建的轨道,返回屏幕共享的 `sourceId`。
- 如果是 `createCustomAudioTrack` 或 `createCustomVideoTrack` 创建的轨道,返回 [MediaStreamTrack.label](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack/label) 字段。
### getVideoElementVisibleStatus [#getvideoelementvisiblestatus]
getVideoElementVisibleStatus(): [CheckVideoVisibleResult](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#checkvideovisibleresult) | undefined
Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack).[getVideoElementVisibleStatus](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/icameravideotrack#getvideoelementvisiblestatus)
- @自从
*4.8.0*
获取 HTML `