HaoYueNet/README.md

96 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2021-12-10 23:11:18 +08:00
# HaoYueNet
2024-01-22 16:39:29 +08:00
.Net 8 的自建基于IOCP的TCP的高性能网络库
使用Protobuff作为基础协议(网络库本身不依赖Protobuff仅上层示例依赖
网络库本身无依赖,可以用于任何数据通讯
2023-06-29 19:34:10 +08:00
包含服务端和客户端双端库,可直接用于各类.Net程序或Unity程序做TCP通讯底层库。
并包含心跳包等检测、连接管理、Protobuff解析优化后的高性能收发等等。
2023-07-06 14:47:20 +08:00
不用关心网络底层,直接引用或继承,即可便捷使用。
#使用基础事件回调即可:
2023-07-06 15:03:16 +08:00
2023-07-06 14:47:20 +08:00
OnClientNumberChange//连接数发生变化
2023-07-06 15:03:16 +08:00
2023-07-06 14:47:20 +08:00
OnDisconnected//断开连接
2023-07-06 15:03:16 +08:00
2023-07-06 14:47:20 +08:00
OnNetLog//来自网络库的日志信息
2023-07-06 15:03:16 +08:00
2023-07-06 14:47:20 +08:00
OnReceive//收到网络数据
#Simple目录下有实例客户端和实例服务端
2023-06-29 19:34:10 +08:00
示例中,使用本网络库,您可以继续示例项目写,也可以参照示例代码。
2023-07-06 14:47:20 +08:00
实现了:
2023-06-29 19:34:10 +08:00
事件机制,
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
客户端基本框架(连接管理,数据管理,消息收发,指定用户发送)
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
服务端基本框架(连接管理,用户管理,消息收发,指定用户发送,广播等)
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
简单无OAuth登录
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
用户列表,
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
基础的Protobuff设计
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
基础聊天功能,
2023-07-06 14:47:20 +08:00
2023-06-29 19:34:10 +08:00
整合Protobuff生成。
2023-07-06 14:47:20 +08:00
#最简接入示例(服务端和客户端)
2024-01-08 15:32:41 +08:00
若您的应用相对简单您甚至可以基于Sample增加功能快速达成目标.
2023-07-06 14:47:20 +08:00
Server:
2024-01-08 15:32:41 +08:00
```csharp
2023-07-06 14:47:20 +08:00
TcpSaeaServer Srv = new TcpSaeaServer(1024, 1024);//实例化,最大连接数和最大接收字节数
Srv.OnClientNumberChange += (int num, AsyncUserToken client) => { /* 连接数发生变化*/};
Srv.OnDisconnected += (AsyncUserToken client) => { /* 断开连接 */};
Srv.OnNetLog += (string msg) => { /* 来自网络库的日志信息 */};
Srv.OnReceive += (AsyncUserToken client, int CMDID, byte[] data) => {
/* 收到网络消息 CMDID和数据 */
Srv.SendMessage(client, new byte[1] { 0x00 });//给指定连接发送数据
};
Srv.Init();//初始化
Srv.Start(new IPEndPoint(IPAddress.Any.Address, 6000));//启动
```
Client:
2024-01-08 15:32:41 +08:00
```csharp
2023-07-06 14:47:20 +08:00
NetworkHelperCore network = new NetworkHelperCore();
network.OnClose += ()=> { /* 断开连接 */};
network.OnConnected += (bool IsConnect) => { /* 连接回到,成功或失败 */};
network.OnLogOut += (string msg) => { /* 来自网络库的日志信息 */};
//指定接收服务器数据事件
network.OnReceiveData += (int CMDID, int ERRCODE, byte[] data) => {
/* 收到网络消息 CMDID和数据 */
network.SendToServer(CMDID, new byte[1] { 0x00 });//给服务器发送数据
};
network.Init("127.0.0.1", 6000);//连接服务器
```
#引用姿势
方式1.直接解决方案引用项目
方式2.直接引用dll文件
服务端
HaoYueNet.ServerNetwork.dll
客户端
HaoYueNet.ClientNetwork.dll (.net7 推荐跨平台.net程序使用)
HaoYueNet.ClientNetworkNet4x.dll (传统.Net4.X版本,用于传统.NetFX程序或Unity游戏或Mono程序)