远程协助
功能介绍
开启屏幕共享后,可将共享区域的操作控制权授予房间内其他用户,控制端可发送鼠标、键盘事件,实现对被控端共享画面的远程操作。
注意:
当前仅 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 为 本端时,结束远程控制
}