音视频通话

远程协助

功能介绍

开启屏幕共享后,可将共享区域的操作控制权授予房间内其他用户,控制端可发送鼠标、键盘事件,实现对被控端共享画面的远程操作。

注意:

当前仅 Windows 端支持做被控端,Windows、macOS、Linux(包括信创系统)可做控制端;
当集成 SDK 的宿主程序以低权限(非管理员身份)运行时,将无法对高权限的程序进行控制;

被控端

1. 赋予他人控制权限


//赋予UserID用户控制权限
g_sdkMain->getSDKMeeting().giveCtrlRight(UserID);

授予他人控制权限后,对应人发出的键盘、鼠标操作,会被SDK自动处理,无需业务层参与。

2.收回远程控制权限


//收回UserID用户的控制权限
g_sdkMain->getSDKMeeting().releaseCtrlRight(UserID);

收回他人控制权限后,将不再被远程控制;

3.临时暂停被控

在被控制过程中,只要本地摇晃鼠标,就能立即自动临时暂停被控(此时远端过来的控制消息将被丢弃)。
临时暂停时,本地可以去停止被控或做一些辅助操作。如果想恢复,只要保持本地鼠标不移动1秒以上即可。

控制端

1.被赋予远程控制权限通知

  • 回调通知:

//用户被赋予了远程控制权限
void notifyGiveCtrlRight(const char* operUserId, const char* targetUserId){
    //operUserId: 权限操作人员
	//targetUserId: 被赋予权限的人员
	
	//如targetUserId为本人,则进入远程控制状态
}

2.控制端发送控制消息

当本端获得远程控制权限后,可以对远端进行控制操作。
如下演示了,如何从Qt界面拦截鼠标、键盘事件,转换成远控消息:


CRPoint ScreenView::ptCover(const QPoint &curPt)
{
	CRPoint pt;
	pt.x = curPt.x() * m_fScaleRate_x;  //m_fScaleRate_x当前图像的缩放比
	pt.y = curPt.y() * m_fScaleRate_y;

	return pt;
}


CRVSDK::CRVSDK_MOUSEKEY_TYPE ScreenView::mouseKeyCover(Qt::MouseButton btn)
{
	switch (btn)
	{
	case Qt::LeftButton: return CRVSDK::CRVSDK_MOUSEKEY_L;
	case Qt::RightButton: return CRVSDK::CRVSDK_MOUSEKEY_R;
	case Qt::MidButton: return CRVSDK::CRVSDK_MOUSEKEY_M;
	case Qt::XButton1: return CRVSDK::CRVSDK_MOUSEKEY_X;
	default: return CRVSDK::CRVSDK_MOUSEKEY_NULL;
	}
}


bool ScreenView::event(QEvent *e)
{
	if (e->type() == QEvent::Wheel)
	{
		if (e->delta() > 0)
		{
			g_sdkMain->getSDKMeeting().sendMouseCtrlMsg(CRVSDK::CRVSDK_MOUSEMSG_DOWN, CRVSDK::CRVSDK_MOUSEKEY_WHEEL, ptTrans(e->pos()));
		}
		else
		{
			g_sdkMain->getSDKMeeting().sendMouseCtrlMsg(CRVSDK::CRVSDK_MOUSEMSG_UP, CRVSDK::CRVSDK_MOUSEKEY_WHEEL, ptTrans(e->pos()));
		}
	}
	else if (e->type() == QEvent::MouseMove)
	{
		g_sdkMain->getSDKMeeting().sendMouseCtrlMsg(CRVSDK::CRVSDK_MOUSEMSG_MOVE, CRVSDK::CRVSDK_MOUSEKEY_NULL, ptTrans(e->pos()));
	}
	else if (e->type() == QEvent::MouseButtonPress)
	{
		CRVSDK::CRVSDK_MOUSEKEY_TYPE kType = mouseKeyCover(e->button())
		if ( kType!=CRVSDK_CRVSDK_MOUSEKEY_NULL )
		{
			g_sdkMain->getSDKMeeting().sendMouseCtrlMsg(CRVSDK::CRVSDK_MOUSEMSG_DOWN, kType, ptTrans(e->pos()));
		}
	}
	else if (e->type() == QEvent::MouseButtonRelease)
	{
		CRVSDK::CRVSDK_MOUSEKEY_TYPE kType = mouseKeyCover(e->button())
		if ( kType!=CRVSDK_CRVSDK_MOUSEKEY_NULL )
		{
			g_sdkMain->getSDKMeeting().sendMouseCtrlMsg(CRVSDK::CRVSDK_MOUSEMSG_UP, kType, ptTrans(e->pos()));
		}
	}
	else if (e->type() == QEvent::MouseButtonDblClick)
	{
		CRVSDK::CRVSDK_MOUSEKEY_TYPE kType = mouseKeyCover(e->button())
		if ( kType!=CRVSDK_CRVSDK_MOUSEKEY_NULL )
		{
			g_sdkMain->getSDKMeeting().sendMouseCtrlMsg(CRVSDK::CRVSDK_MOUSEMSG_DBCLICK, kType, ptTrans(e->pos()));
		}
	}
	else if (e->type() == QEvent::KeyRelease)
	{
		quint32 modifiers = e->nativeModifiers();
		bool bExtendedKey = modifiers & 0x1000000;
		g_sdkMain->getSDKMeeting().sendKeyCtrlMsg(CRVSDK::CRVSDK_KEYMSG_DWON, e->nativeVirtualKey(), bExtendedKey);
	}
	else if (e->type() == QEvent::KeyPress)
	{
		quint32 modifiers = e->nativeModifiers();
		bool bExtendedKey = modifiers & 0x1000000;
		g_sdkMain->getSDKMeeting().sendKeyCtrlMsg(CRVSDK::CRVSDK_KEYMSG_UP, e->nativeVirtualKey(), bExtendedKey);
	}

	return QWidget::event(e);
}

3.被收回远程控制权限通知

  • 回调通知:

// 用户远程控制权限被收回
void notifyReleaseCtrlRight(const char* operUserId, const char* targetUserId){
	//targetUserId 为 本端时,结束远程控制
}

相关 API