C#服务端用到Fleck包，它包含哪些可用的回调函数，有哪些常用的api方法？

演示：服务端收到Unity用户发来的信息

1、Fleck服务器提供哪些回调函数

Fleck提供的回调函数有下面几种：

//用户连入服务器时...
Action OnOpen { get; set; }//用户与服务器断开连接时...
Action OnClose { get; set; }//收到字符串消息时...
Action<string> OnMessage { get; set; }//收到二进制数据时...
Action<byte[]> OnBinary { get; set; }//收到别人发来的ping信息时...
Action<byte[]> OnPing { get; set; }//收到别人发来的pong信息时...
Action<byte[]> OnPong { get; set; }//出错的时候调用...[?谁出错，服务器出错还是连接出错，出的是什么错？]
Action<Exception> OnError { get; set; }

2 、服务器提供的其它API

其它常用的api主要有：

//发送字符串
Task Send(string message);//发送字节码(二进制数据)
// 1Byte = 8 bits
// 1KB = 1024 Bytes
// 1MB = 1024KB
Task Send(byte[] message);//发送一个ping信息
Task SendPing(byte[] message);//发送一个pong信息
Task SendPong(byte[] message);//关闭连接
void Close();//关闭连接？关闭连接池中指定序号的连接？
void Close(int code);

• ping pong的作用是啥？
  WebSocket为了保持客户端、服务端的实时双向通信，需要确保客户端、服务端之间的TCP通道保持连接没有断开。然而，对于长时间没有数据往来的连接，如果依旧长时间保持着，可能会浪费包括的连接资源。但不排除有些场景，客户端、服务端虽然长时间没有数据往来，但仍需要保持连接。这个时候，可以采用心跳来实现。
  发送方->接收方：ping；
  接收方->发送方：pong；

C# 在WinForm里使用Fleck作为服务器的简单示例代码：

 private void button1_Click(object sender, EventArgs e)
{if (hasStartedServer)//不重复启动服务器实例return;var server = new WebSocketServer("ws://192.168.0.137:8081");  //ws://localhost:8081    ws://127.0.0.0:8181server.Start(socket =>{//连上时...socket.OnOpen = () =>{Debug.WriteLine($"有新用户连入：{socket.ConnectionInfo.ClientIpAddress}");};//断开时...socket.OnClose = () =>{Debug.WriteLine($"用户断开连接：{socket.ConnectionInfo.ClientIpAddress}");UserSockets.First(x => x.socket.ConnectionInfo.Id == socket.ConnectionInfo.Id).connected = false;};//收到string信息时...socket.OnMessage = message =>{socket.Send($"服务器收到消息 : {DateTime.Now.ToString()}");Debug.WriteLine($"收到一条消息，来自：{socket.ConnectionInfo.ClientIpAddress}");Debug.WriteLine(message);var cmd  = message.Split("#")[0];if (cmd == "name"){var userID = message.Split("#")[1];Debug.WriteLine($"收到一条消息，来自用户：{userID}  连接id：{socket.ConnectionInfo.Id}");UserSocket user = new UserSocket(){userID = userID,socket = socket,connected = true};UserSockets.Add(user);}};//收到二进制信息时...socket.OnBinary = bytes =>{var userName = UserSockets.First(x => x.socket.ConnectionInfo.Id == socket.ConnectionInfo.Id).userID;Debug.WriteLine($"收到二进制数据，长度为{bytes.Length}Bytes,来自ip:{socket.ConnectionInfo.ClientIpAddress},userID ={userName}");};});Debug.WriteLine("服务器已经启动！");hasStartedServer = true;
}

3、服务器与客户端建立的连接包含哪些信息

  public interface IWebSocketConnectionInfo{string SubProtocol { get; }string Origin { get; }string Host { get; }string Path { get; }string ClientIpAddress { get; }int ClientPort { get; }IDictionary<string, string> Cookies { get; }IDictionary<string, string> Headers { get; }Guid Id { get; }string NegotiatedSubProtocol { get; }}

每次建立的连接，Id号是唯一的。

4、服务器接收数据时是否会粘包？

经测试，同一连接连续向服务器发送数据时，每次OnBinary收到的消息是完整的。
还没瞻仰源码，后面有空看看，server端TCP接收数据时，应该是做了包的合并处理，接到一个整坨数据，才调用的OnBinary。

• Unity用户端代码
  连发50笔数据，每次发送1M bytes

 int i = 0;while (i < 50)  //连发50笔数据，每次发送1M bytes{var bytesArray = new byte[1048576];  // 1024 * 1024 = 1048576await websocket.Send(bytesArray);    //或者直接await，测试结果一样Debug.Log($"发送数据-{i}");i++;}

• C#服务端代码
  每当收到数据时，把收到的数据长度打印出来

socket.OnBinary = bytes =>{Debug.WriteLine($"收到二进制数据，长度为{bytes.Length}Bytes,来自{socket.ConnectionInfo.ClientIpAddress}");};

5、同一个ip上有两个应用同时发来信息，如何区分这些连接属于哪个用户？

简要思路：每个用户端启动的时候，需要用户名登录，建立连接时，告诉服务器这个socket是哪个userID的，凡是该用户建立连接，后台都把该连接绑定到user ID。

• 1、每次建立连接，connection的id是唯一的
  

• 2、服务器端维护一个【连接列表】：（string userID - > webSocket sockt），如下所示：

public class UserSocket
{/// <summary>/// 用户ID/// </summary>public string userID;/// <summary>/// socket对象/// </summary>public IWebSocketConnection socket;/// <summary>/// 状态：true-可用状态  false-断开状态/// </summary>public bool connected;
}

userID	socket	connected
guest	socket1	true
user1	socket2	true
user2	socket3	false
…	…	…
userN	socketM	true

客户端建立连接的时候，发送信息给服务器，告诉服务器该连接对应那个用户名。
服务器收到信息后，及时更新【连接列表】。

• 用户端在建立连接的时候，发送一个string命令，告诉服务器这个连接后面是哪个用户（user ID）

websocket.OnOpen += () =>
{Debug.Log("连接成功！！");   websocket.SendText($"name#user001"); //发送用户id
};

• 服务器收到信息的处理

 //收到二进制信息
socket.OnBinary = bytes =>
{var userName = UserSockets.First(x => x.socket.ConnectionInfo.Id == socket.ConnectionInfo.Id).userID;Debug.WriteLine($"收到二进制数据，长度为{bytes.Length}Bytes,来自ip:{socket.ConnectionInfo.ClientIpAddress},userID ={userName}");
};

收到信息，且识别了是哪个userID发来的

6、本文测试环境

Win10 + Unity2021.3.18 + VS2019(.NET 5.0)