# 屏幕采集 (/zh-CN/api-reference/rtc/harmonyos/video/screencapture) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## startScreenCapture [#startscreencapture] 开始屏幕采集。 ```ts public abstract startScreenCapture(screenCaptureParameters: ScreenCaptureParameters): number; ``` :::caution 注意: - 屏幕共享流的计费标准以 VideoCaptureParameters 中的 dimensions 值为准: - 当你未传值时,以 1280 × 720 计费。 - 当你传值时,以你传入的值计费。 ::: ### 适用场景 [#适用场景] 在屏幕共享场景下,你需要调用该方法开始采集屏幕视频流。有关屏幕共享的实现方法,详见[屏幕共享](/zh-CN/realtime-media/rtc/build/video/screen-share)。 ### 调用时机 [#调用时机] 该方法在加入频道前后均可调用,区别如下: - 如果在加入频道前调用该方法,然后调用 [joinChannelWithOptions](/zh-CN/api-reference/rtc/harmonyos/channel#api_irtcengine_joinchannel2) 加入频道,并设置 publishScreenCaptureVideo 为 `true`,即可开始屏幕共享。 - 如果在加入频道后调用该方法,然后调用 [updateChannelMediaOptions](/zh-CN/api-reference/rtc/harmonyos/channel#api_irtcengine_updatechannelmediaoptions) 更新频道媒体选项,并设置 publishScreenCaptureVideo 为 `true`,即可开始屏幕共享。 ### 调用限制 [#调用限制] - 为提高屏幕共享时采集系统音频的成功率,建议你在加入频道前通过 [setAudioScenario](/zh-CN/api-reference/rtc/harmonyos/audio/audio-basic#api_irtcengine_setaudioscenario) 方法设置音频场景为 GAME_STREAMING。 ### 参数 [#参数] 屏幕共享的编码参数配置。默认的分辨率为 1920 x 1080,即 2,073,600 像素。该像素值为计费标准。详见 [ScreenCaptureParameters](/zh-CN/api-reference/rtc/harmonyos/class-screencaptureparameters2)。 ### 返回值 [#返回值] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine) ## stopScreenCapture [#stopscreencapture] 停止屏幕采集。 ```ts public abstract stopScreenCapture(): number; ``` ### 适用场景 [#适用场景-1] 如果你调用了 [startScreenCapture](/zh-CN/api-reference/rtc/harmonyos/video/screencapture#api_irtcengine_startscreencapture) 开启屏幕采集,则停止屏幕采集时需要调用该方法。 ### 调用时机 [#调用时机-1] 该方法在加入频道前后均可调用。 ### 调用限制 [#调用限制-1] 无。 ### 返回值 [#返回值-1] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine) ## updateScreenCaptureParameters [#updatescreencaptureparameters] 更新屏幕采集的参数配置。 ```ts public abstract updateScreenCaptureParameters(screenCaptureParameters: ScreenCaptureParameters): number; ``` ### 详情 [#详情] :::caution 注意: - 请在开启屏幕共享或窗口共享后调用该方法。 ::: ### 参数 [#参数-1] 屏幕共享的编码参数配置。默认的分辨率为 1920 x 1080,即 2073600 像素。该像素值为计费标准。详见 。 :::caution 注意: 屏幕共享流的视频属性只需通过该参数设置,与 [setVideoEncoderConfiguration](/zh-CN/api-reference/rtc/harmonyos/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 无关。 ::: ### 返回值 [#返回值-2] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -2:传入的参数无效。 - -8:屏幕共享状态无效。可能因为你已经共享了其他屏幕或窗口。尝试调用 [stopScreenCapture](/zh-CN/api-reference/rtc/harmonyos/video/screencapture#api_irtcengine_stopscreencapture) 停止当前共享,再重新开始共享屏幕。