# Interface ICameraVideoTrack (/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 可以通过 [AgoraRTC.createCameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createcameravideotrack) 来获取。 ## Properties [#properties] ### enabled [#enabled] enabled: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[enabled](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#enabled) 本地轨道当前的启用状态。 ### isPlaying [#isplaying] isPlaying: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[isPlaying](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#isplaying) 媒体轨道是否正在页面上播放。 - `true`: 媒体轨道正在页面上播放。 - `false`: 媒体轨道没有在页面上播放。 ### muted [#muted] muted: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[muted](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#muted) 本地媒体轨道当前的静音状态。 ### processorDestination [#processordestination] processorDestination: IBaseProcessor Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack).[processorDestination](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack#processordestination) :::info[自从] *4.10.0* ::: :::warning[deprecated] 旧版 v1 pipe 模式 API。新插件请使用 `useExtension` 和 `removeExtension`。 ::: 本地视频轨道上当前媒体处理链路的最终节点。 ### trackMediaType [#trackmediatype] trackMediaType: "audio"|"video" Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[trackMediaType](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#trackmediatype) 媒体轨道的类型: - `"audio"`: 音频轨道。 - `"video"`: 视频轨道。 ## Methods [#methods] ### clone [#clone] clone(config?: [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/web/interfaces/videoencoderconfiguration) | [VideoEncoderConfigurationPreset](/zh-CN/api-reference/rtc/web/globals#videoencoderconfigurationpreset), cloneTrack?: boolean): [ICameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack) Overrides [ILocalVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocalvideotrack).[clone](/zh-CN/api-reference/rtc/web/interfaces/ilocalvideotrack#clone) :::info[自从] *4.19.0* ::: 复制当前的视频轨道对象,生成一个新的视频轨道。 在视频会议、在线教育等场景中,你可以用该方法实现同一视频流的两路显示,并为每路显示设置不同的分辨率、帧率、码率等参数。 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/web/interfaces/videoencoderconfiguration) | [VideoEncoderConfigurationPreset](/zh-CN/api-reference/rtc/web/globals#videoencoderconfigurationpreset) 新生成视频轨道的编码配置。你可以通过 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/web/interfaces/videoencoderconfiguration) 传入 SDK 内置的编码配置;也可以通过传入一个 [VideoEncoderConfigurationPreset](/zh-CN/api-reference/rtc/web/globals#videoencoderconfigurationpreset) 来自定义视频编码配置。 是否克隆当前轨道。默认为 `true`。 [ICameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack) 新生成的视频轨道。 ### close [#close] close(): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[close](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#close) 关闭本地轨道,并释放相关采集设备。 一旦本地轨道被关闭,就无法再次使用。如需再次使用本地轨道,需要重新创建。 void ### getCurrentFrameData [#getcurrentframedata] getCurrentFrameData(): ImageData Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack).[getCurrentFrameData](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack#getcurrentframedata) :::info[自从] *4.1.0* ::: 获取当前渲染的视频帧数据。 :::caution[注意] 只有在播放后才能调用此方法,如果没有调用 [play](/zh-CN/api-reference/rtc/web/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/web/interfaces/ibuffersourceaudiotrack).[getMediaStreamTrack](/zh-CN/api-reference/rtc/web/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/web/enums/streamtype)): RTCRtpTransceiver | undefined Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[getRTCRtpTransceiver](/zh-CN/api-reference/rtc/web/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/web/interfaces/ilocaltrack#event_transceiver_updated) - 远端轨道:[IRemoteTrack.transceiver-updated](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack#event_transceiver_updated_2) ::: [StreamType](/zh-CN/api-reference/rtc/web/enums/streamtype) 视频流的类型。详见 [StreamType](/zh-CN/api-reference/rtc/web/enums/streamtype)。 RTCRtpTransceiver | undefined 当前轨道的 `RTCRtpTransceiver` 实例。 ### getStats [#getstats] getStats(): [LocalVideoTrackStats](/zh-CN/api-reference/rtc/web/interfaces/localvideotrackstats) Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack).[getStats](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack#getstats) Overrides [ILocalTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocaltrack).[getStats](/zh-CN/api-reference/rtc/web/interfaces/ilocaltrack#getstats) 获取本地视频轨道的相关信息。 :::warning[deprecated] 自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getLocalVideoStats](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#getlocalvideostats) 和 [AgoraRTCClient.getLocalAudioStats](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#getlocalaudiostats)。 ::: [LocalVideoTrackStats](/zh-CN/api-reference/rtc/web/interfaces/localvideotrackstats) ### getTrackId [#gettrackid] getTrackId(): string Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[getTrackId](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#gettrackid) 获取由 SDK 生成的对于媒体轨道来说的唯一 ID。 string 媒体轨道 ID。 ### getTrackLabel [#gettracklabel] getTrackLabel(): string Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[getTrackLabel](/zh-CN/api-reference/rtc/web/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/web/globals#checkvideovisibleresult) | undefined Inherited from [ICameraVideoTrack](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack).[getVideoElementVisibleStatus](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack#getvideoelementvisiblestatus) :::info[自从] *4.8.0* ::: 获取 HTML `