音视频通话

屏幕共享启停

注意:

同一个房间中,同一时间只有一人能开启屏幕共享。

共享端

1.开始共享

在开始共享前,需先配置质量参数,再调用开始接口:

// 1. 可选:配置共享质量参数,参见 [屏幕共享质量配置](screenShareCfg.md)
const cfg = { maxFPS: 15, maxKbps: 2000 };
sdk_engine.setScreenShareCfg(cfg);

// 2. 开始屏幕共享
sdk_engine.startScreenShare();
  • 回调通知:
// 开启结果
sdk_engine.on("startScreenShareRslt", (sdkErr) => {
    if (sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR){
        // 开启屏幕共享失败
        return;
    }
})

相关API请参考:

2.停止共享

  • 接口调用:
//主动停止屏幕共享
sdk_engine.stopScreenShare();
  • 回调通知:
//主动停止屏幕共享的结果
sdk_engine.on("stopScreenShareRslt", (sdkErr) => {
    if (sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR){
        // 停止屏幕共享失败
        return;
    }
})

相关API请参考:

3. 共享端注意点

  1. 共享端不应该在"共享源"区域上显示共享内容,这样观看的内容又被采集,形成图像无限嵌套效果;
  2. 不要在共享端上运行"观看端"程序,有可能导致观看的内容又被采集,形成图像无限嵌套效果;

4. 共享端相关 API

观看端

1.准备屏幕共享图像播放容器

使用 VideoComponent 组件,视图类型设为 CRVSDK_VIEWTP_SCREEN:

import { CRVSDK_STREAM_VIEWTYPE } from '@cloudroom/harmony_rtcsdk'
import { util } from '@kit.ArkTS';

VideoComponent({
  canvas: {
    canvasId: util.generateRandomUUID(),
    type: CRVSDK_STREAM_VIEWTYPE.CRVSDK_VIEWTP_SCREEN
  }
})

VideoComponent组件是一个自行封装的组件,封装方法请参考封装视图容器

2.收到共享通知,创建UI组件

//通知屏幕共享开始
sdk_engine.on("notifyScreenShareStarted", (userID) => {
    //此时可以把VideoComponent组件渲染出来
})

相关API请参考:

3.通知停止共享

//收到他人停止了屏幕共享的通知
sdk_engine.on("notifyScreenShareStopped", (operatorID) => {
  //此时可以把VideoComponent组件销毁
})

相关API请参考:

观看端相关 API