屏幕共享启停
注意:
同一个房间中,同一时间只有一人能开启屏幕共享。
共享端
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. 共享端注意点
- 共享端不应该在"共享源"区域上显示共享内容,这样观看的内容又被采集,形成图像无限嵌套效果;
- 不要在共享端上运行"观看端"程序,有可能导致观看的内容又被采集,形成图像无限嵌套效果;
4. 共享端相关 API
- setScreenShareCfg / getScreenShareCfg
- startScreenShare / stopScreenShare / pauseScreenShare
- getScreenShareInfo
- startScreenShareRslt / stopScreenShareRslt
观看端
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请参考: