继上篇《GGTalk 开源即时通讯系统源码剖析之:聊天消息防错漏机制》介绍了 GGTalk 对消息的可靠性,即消息的不丢失和不重复做了一系列优化处理,以保证不会错漏消息。这篇我们来剖析 GGTalk 新增的远程磁盘功能其对应的源码实现。
在之前的博文《实现远程磁盘:像访问自己的电脑硬盘一样访问对方的电脑硬盘 》,我们通过一个Demo介绍了访问远程磁盘如何实现。最近,我们已经在GGTalk开源即时通讯IM的最新版中增加访问好友磁盘的功能:在一对一的对话窗口,请求方可以发起访问对方磁盘的请求,如果对方同意,则请求方就可以通过远程磁盘的窗口来操作对方的磁盘了。现在我们来看看GGTalk的远程磁盘这一功能具体是如何实现的,大家可以先下载GGTalk的最新源码,然后对照源码,更容易理解本文的内容。
一. 定义消息协议
在远程磁盘请求方和应答方相互通信之前,我们先定义好远程磁盘这一功能需要用到的消息协议。
/// <summary>
/// 交互媒体的类型。
/// </summary>
public enum CommunicateMediaType
{
Video = 0,
Audio,
RemoteHelp,
RemoteControl,
RemoteDisk,
GroupVideo
}
在交互媒体的类型枚举上,我们增加了 远程磁盘(RemoteDisk)这个类型。
再结合原先的 CommunicateType 枚举,我们就可以组合出远程磁盘相关的业务通信:请求、应答(同意或拒绝)、中断等。
/// <summary>
/// 交互的类型。比如 请求视频会话,同意视频会话,拒绝视频会话,终止视频会话
/// </summary>
public enum CommunicateType
{
Request = 0,
Agree,
Reject,
Terminate,
Busy
}
有了上面的铺垫,我们就可以来实现整个远程磁盘功能的业务流程了。
二. 远程磁盘请求方实现
首先,使用VS 2022 打开 GGTalk 解决方案,找到GGTalk 客户端项目(Windows版):

我们在一对一的聊天窗口 FriendChatForm (在Forms文件夹下)上增加"请求访问对方磁盘"的按钮,如下图所示:

点击该按钮时,将执行如下动作:
public void RequestControlFriendDisk()
{
//如果自己掉线,则直接返回。
if (this.resourceCenter.ClientGlobalCache.CurrentUser.UserStatus == UserStatus.OffLine)
{
return;
}
this.resourceCenter.ClientOutter.SendMediaCommunicate(this.currentFriend.ID, CommunicateMediaType.RemoteDisk, CommunicateType.Request, null);
NDiskOutter diskOutter = new NDiskOutter(this.resourceCenter.RapidPassiveEngine, this.resourceCenter.NDiskPassiveHandler);
this.remoteDiskForm = new RemoteDiskForm(this.currentFriend.ID,ClientType.DotNET,this.currentFriend.DisplayName, diskOutter, this.resourceCenter.RapidPassiveEngine.FileOutter, this.resourceCenter.CurrentUserID);
this.remoteDiskForm.RemoteDiskRequestCancelled += new CbGeneric(remoteDiskForm_RemoteDiskRequestCancelled);
this.remoteDiskForm.RemoteDiskEnded += new CbGeneric<bool>(remoteDiskForm_RemoteDiskEnded);
this.remoteDiskForm.Show();
}
(1)客户端通过调用 IClientOutter 的 SendMediaCommunicate 方法,来实现与远程磁盘功能相关的业务通信。
(2)通过 CommunicateMediaType.RemoteDisk 和 CommunicateType.Request 来表名这次交互发送的是一个远程磁盘请求。
(3)在等待对方应答期间,使用 RemoteDiskForm 来显示正在等待对方回复。如下图所示:

(4)如果对方同意了远程磁盘请求,那么RemoteDiskForm 将改变状态,请求方就能通过该窗体来操作对方的磁盘,如下图所示:

关于 RemoteDiskForm 的具体实现细节,可以参考 《实现远程磁盘:像访问自己的电脑硬盘一样访问对方的电脑硬盘 》。
三. 远程磁盘应答方实现
当应答方收到跟远程磁盘相关的业务消息时,会进入到 RemoteDiskManager的 HandleRemoteDisk 方法,如下代码所示:
public void HandleRemoteDisk(CommunicateType communicateType, string tag)
{
if (communicateType == CommunicateType.Request)
{
this.OnRemoteDiskRequestReceived();
this.ownerForm.FlashWindow();
return;
}
if (communicateType == CommunicateType.Agree)
{
this.OnRemoteDiskAnswerReceived(true);
this.ownerForm.FlashWindow();
return;
}
if (communicateType == CommunicateType.Reject)
{
this.OnRemoteDiskAnswerReceived(false);
this.ownerForm.FlashWindow();
return;
}
if (communicateType == CommunicateType.Terminate)
{
if (tag == "owner")
{
this.OnOwnerTerminateRemoteDisk();
}
else
{
this.OnGuestCloseRemoteDisk();
}
this.ownerForm.FlashWindow();
return;
}
}
(1)在 OnRemoteDiskRequestReceived 方法中,会在窗体的右侧,显示远程磁盘请求,如下截图:

(2)当应答方点击"接受"或"拒绝"按钮时,也将通过调用 IClientOutter 的 SendMediaCommunicate 方法(位于RemoteDiskManager类),来将回复消息发送给请求方。
void remoteDiskRequestPanel_RemoteRequestAnswerd(bool agree)
{
this.ownerForm.RemoveDisplayedPanel(this.Title_Disk);
this.resourceCenter.ClientOutter.SendMediaCommunicate(this.currentFriend.ID, CommunicateMediaType.RemoteDisk, agree ? CommunicateType.Agree : CommunicateType.Reject, null);
string showText = string.Format("您{0}了对方的磁盘访问请求。", agree ? "同意" : "拒绝");
this.ownerForm.AppendSysMessage(showText);
if (agree)
{
this.remoteDiskHandlePanel.OnAgree();
this.ownerForm.AddDisplayedPanel(this.Title_Disk, this.remoteDiskHandlePanel);
}
}
(3)如果点击"接受"按钮,则聊天窗体右侧将会出现"远程磁盘的控制面板",以随时可以收回远程磁盘控制权。

(4)在对方控制自己磁盘的过程中,应答方点击上方的"终止"按钮,即可结束控制。这是给对方发送一个"终止控制"的 CommunicateType.Terminate 消息:
void remoteDiskHandlePanel_RemoteDiskTerminated()
{
this.ownerForm.RemoveDisplayedPanel(this.Title_Disk);
this.resourceCenter.ClientOutter.SendMediaCommunicate(this.currentFriend.ID, CommunicateMediaType.RemoteDisk, CommunicateType.Terminate, "owner");
string showText = "您关闭了磁盘共享。";
this.ownerForm.AppendSysMessage(showText);
}
四. 结语
以上就是关于 GGTalk 远程磁盘功能的设计与实现的核心了。在某些办公场景中,远程磁盘这个功能还是很有用的,所以,GGTalk 即时通讯就实现该功能,方便那些有需要的人。
如果你觉得还不错,请点赞支持啊!下篇再见!
若需下载GGTalk最新源码,请移不到 GGTalk 源码下载中心 ,谢谢 。