屏幕采集
startScreenCapture
开始屏幕采集。
ArkTS
public abstract startScreenCapture(parameter: ScreenCaptureParameters): number;
注意
适用场景
在屏幕共享场景下,你需要调用该方法开始采集屏幕视频流。有关屏幕共享的实现方法,详见屏幕共享。
调用时机
该方法在加入频道前后均可调用,区别如下:
- 如果在加入频道前调用该方法,然后调用 joinChannelWithOptions 加入频道,并设置 publishScreenCaptureVideo 为
true
,即可开始屏幕共享。 - 如果在加入频道后调用该方法,然后调用 updateChannelMediaOptions 更新频道媒体选项,并设置 publishScreenCaptureVideo 为
true
,即可开始屏幕共享。
调用限制
- 为提高屏幕共享时采集系统音频的成功率,建议你在加入频道前通过 setAudioScenario 方法设置音频场景为 GAME_STREAMING。
参数
- screenCaptureParameters
- 屏幕共享的编码参数配置。默认的分辨率为 1920 x 1080,即 2,073,600 像素。该像素值为计费标准。详见 ScreenCaptureParameters。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。