- 最新动态
- 服务公告
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
-
客户端SDK参考
- 使用前必读
- SDK概述
- 隐私声明
- 合规使用指南
- Android SDK
- iOS/macOS SDK
- All Platform C++ SDK
- Web SDK
- 接入鉴权
- 附录
- 修订记录
-
常见问题
-
产品咨询
- SparkRTC支持哪些平台?
- SparkRTC Demo怎么体验?
- 在进行Windows的Demo使用或集成SDK时,提示微软C++标准库缺失,该如何获取?
- SparkRTC支持接入微信小程序吗?
- 实时音视频是什么?
- 实时音视频和直播有什么区别?
- SparkRTC是否支持在国外使用?
- SparkRTC RoomID是什么?取值区间值是多少?
- SparkRTC最多可以同时创建多少个房间?
- SparkRTC UserID是什么?取值范围是多少?
- 怎么理解SparkRTC的角色Role?
- SparkRTC最多可以支持多少个人同时视频通话?
- 实时音视频的时延是多少?
- SparkRTC是否支持连麦互动?
- SparkRTC是否支持双向的桌面推送?
- 实时音视频支持私有化部署吗?
- PC端实时音视频支持USB摄像头吗?
- 计费购买
- Signature相关
- 录制相关
-
SDK使用
- 移动端(Android/iOS)创建一个房间,是否支持PC端(MAC/Windows)接入?
- iOS平台如何缩减安装包体积?
- Android平台如何缩减安装包体积?
- iOS端是否可以监听远端离开房间?
- 背景音乐是否支持循环播放?
- SparkRTC是否支持调整背景音乐的播放进度?
- 支持监听房间成员进出房间吗?
- 如何监测断网和重连?
- 支持首帧渲染回调吗?能否监听画面开始渲染?
- 如何设置上行视频码率、分辨率和帧率?
- 有没有推荐的画面质量(码率、分辨率、帧率)相关参数配置?
- 如何实现横屏视频通话?
- 是否支持网络测速?如何操作?
- 是否支持音量大小提示?
- 自定义渲染支持哪些格式?
- SparkRTC支持iOS后台运行吗?
- 移动端如何实现录屏(屏幕分享)?
- 多人视频会议中,移动端和Web端可以进入同一房间吗?
- SparkRTC的Web端、移动端、PC端是不是同步的?
- Android SDK是否支持自定义采集数据?
- SparkRTC支持旁路推流吗?
- Windows端如何才能采集到被分享应用播放的声音?
- SDK是否支持断线重连机制?
- 如何创建房间?
- 两台手机同时运行SparkRTC APP,为什么无法互通?
- 鉴权是如何生成的?在什么时候生成?
- onVideoStats、onAudioStatus、onSubStreamStats回调触发时为什么程序会崩溃?
- 为什么本端听筒能听到自己的声音?
- setExternalAudioCapture(音频自采集)、setExternalVideoCapture(视频自采集)、setExternalMediaFrameOutput(视频自渲染)能在进入房间后开启吗?
- SparkRTC是否支持设置镜像画面?
- SparkRTC音视频过程中的上下行码率、分辨率、丢包率、音频采样率等信息怎么获取?
- SparkRTC是否支持设置本地采集音量?是否支持设置每个远端用户的播放音量?
- enableLocalVideo和muteLocalVideo有什么区别?
- enableLocalAudioStream和muteLocalAudio有什么区别?
- SparkRTC是否支持对房间进行权限校验?
- 接入PC端是否支持屏幕分享功能?
- SparkRTC是否支持将本地视频文件分享到实时音视频中?
- SparkRTC是否支持单纯的实时音频?
- 一个房间里可以同时有多路屏幕分享吗?
- SparkRTC是否支持1080P?
- 是否支持视频画面截图功能?
- 播放背景音乐是否支持在线音乐?
- 同一个页面中,可以创建N个RTC对象,通过N个UserID,分别登录到N个房间吗?
- Web端用宽高设置的推流分辨率适用于所有浏览器吗?
- Web端SDK在使用过程中拔掉摄像头,摄像头列表里面的数据如何清除?
- Web端SDK可以获取当前音量大小吗?
- Web端支持监听远端离开房间吗?
- Web端通话过程中为什么会出现回声、杂音、噪声、声音小?
- Web端如何切换摄像头和麦克风?
- SparkRTC支持白板功能吗?
- 相同UserID支持同时进入多个房间吗?
- SparkRTC房间的生命周期是多久?
- SparkRTC多人视频通话支持蓝牙耳机吗?
- SparkRTC多人视频通话支持仅订阅2/3/4人音频吗?
- 指定窗口分享,当窗口大小变化时,视频流的分辨率会跟着变化吗?
- 视频通话支持悬浮窗、大小画面切换功能吗?
- 发送自定义消息接口能实现聊天室、弹幕等功能吗?
- 支持查询所有的UserID吗?
- Web SDK中的checkSystemRequirements接口为什么会调用异常?
- 问题排查
-
产品咨询
- 文档下载
- 通用参考
链接复制成功!
屏幕分享
功能描述
屏幕共享用于在音视频会议中,把一个与会者的屏幕内容,以视频的方式分享给其他与会者。屏幕共享可以共享整个桌面,也可以共享某一个程序窗口。共享程序窗口的时候还可以指定共享该程序窗口的矩形区域。
实现屏幕共享
- 加入房间
参考接口调用流程中加入房间的时序图步骤加入房间。
- 共享桌面
加入房间后可以调用getScreenShareSources获取屏幕共享对象列表,然后遍历找到其中HRTCScreenShareSourceInfo.type为HRTC_SCREEN_SHARE的对象,该对象就是屏幕对象,再调用setScreenShareTarget设置共享桌面参数。桌面共享不支持区域共享。
然后调用startScreenShare开始共享。
还可以调用setAuxiliaryVideoEncodeSmooth来切换屏幕共享的分辨率,从默认的1080p切换为720p。
示例代码如下:
//获取引擎 IHRTCEngine* engine = CRtcEngineMgr::GetInstance()->GetEngine(); // 定义屏幕共享区域参数 HRTCSrceenCaptureOptionalInfo optionInfo; memset(&optionInfo, 0, sizeof(HRTCSrceenCaptureOptionalInfo)); // 获取屏幕共享列表,包含桌面共享对象 IHRTCScreenShareSourceList* sourceList = engine->getScreenShareSources(HRTC_SCREENSHARE_SMALL_ICON); unsigned int count = sourceList->count(); for (unsigned int index = 0; index < count; index++) { HRTCScreenShareSourceInfo sourceInfo = sourceList->get(index); if (sourceInfo.type == HRTC_SCREEN_SHARE) { //如果是桌面共享对象 // 调用设置屏幕共享接口 engine->setScreenShareTarget(&sourceInfo, &optionInfo); // 开启屏幕共享 engine->startScreenShare(); // 设置屏幕共享编码流畅优先 engine->setAuxiliaryVideoEncodeSmooth(true); break; } }
- 共享程序
加入房间后也可以调用getScreenShareSources来获取可以共享的程序窗口列表,然后展示在界面上供用户选择。
选择好需要共享的程序窗口后,调用setScreenShareTarget来设置要共享的程序窗口,其中HRTCScreenShareSourceInfo.type设为HRTC_WINDOW_CAPTURE,HRTCSrceenCaptureOptionalInfo参数用于指定共享的程序窗口的子矩形区域,矩形区域以共享的程序窗口的左上角为原点(0,0),最小96*92 最大1920*1080。如果需要共享该程序的完整窗口,则HRTCSrceenCaptureOptionalInfo参数的矩形区域全填为0。
然后调用startScreenShare开始共享。
当HRTCSrceenCaptureOptionalInfo参数的矩形区域填全0时,还可以调用setAuxiliaryVideoEncodeSmooth来切换屏幕共享的分辨率,从默认的1080p切换为720p。
示例代码如下:
//获取共享程序窗口列表 IHRTCEngine* engine = CRtcEngineMgr::GetInstance()->GetEngine(); IHRTCScreenShareSourceList* sourceList = engine->getScreenShareSources(HRTC_SCREENSHARE_SMALL_ICON); unsigned int count = sourceList->getCount(); for (unsigned int index = 0; index < count; index++) { HRTCScreenShareSourceInfo sourceInfo = sourceList->get(index); RD_LOG("appshare", "applist name: %s, HWND:%x", sourceInfo.sourceName, sourceInfo.sourceId); //将sourceInfo加入列表展示到界面上供用户选择 } //用户选择共享的程序后 int nIdx = m_appList.GetSelectionMark(); //获取用户选择的程序窗口序号 //获取用户选择的程序窗口序号对应的窗口信息对象 HRTCScreenShareSourceInfo sourceInfo = m_windowsList[nIdx]; //获取之前创建的主引擎指针 IHRTCEngine* engine = CRtcEngineMgr::GetInstance()->GetEngine(); //设置屏幕共享参数 HRTCSrceenCaptureOptionalInfo optionInfo; memset(&optionInfo, 0, sizeof(HRTCSrceenCaptureOptionalInfo)); //根据需要设置共享的程序窗口的子矩形区域,如果要共享完整的程序窗口,则矩形区域设为全0 optionInfo.rect.left = 0; optionInfo.rect.top = 0; optionInfo.rect.right = 320; optionInfo.rect.bottom = 240; int ret = engine->setScreenShareTarget(&sourceInfo, &optionInfo); ret = engine->startScreenShare();
- 接收远端用户的共享流
收到远端用户开启共享流通知onUserAuxiliaryStreamAvailable后,可以调用startRemoteAuxiliaryStreamView来设置远端用户的共享流的窗口句柄并开始选看。
还可以再调用updateRemoteRenderMode设置窗口显示共享流的方式。
示例代码如下:
engine->startRemoteAuxiliaryStreamView(userId, wndHandle);
- 停止屏幕共享
屏幕共享结束时,可以调用stopScreenShare停止屏幕共享。
示例代码如下:
engine->stopScreenShare();
- 停止接收远端用户的屏幕共享流
收到onUserAuxiliaryStreamAvailable消息后,如果选看的远端屏幕共享流不可用,或者收到远端用户下线通知onRemoteUserOffline,则接收端必须调用stopRemoteAuxiliaryStreamView关闭共享流窗口视图。
如果接收端需要主动停止接收远端用户的共享流,也需要调用stopRemoteAuxiliaryStreamView接口停止接收共享流。
示例代码如下:
engine->stopRemoteAuxiliaryStreamView(userId);