HaoYueNet/README.md

97 lines
2.9 KiB
Markdown
Raw Normal View History

2021-12-10 23:11:18 +08:00
# HaoYueNet
2024-05-20 17:47:19 +08:00
.Net8/.NetStandard2.0 的,泛用形自建高性能网络库
2024-05-20 17:36:47 +08:00
基于IOCP进一步深度优化而来
2024-05-20 17:36:47 +08:00
网络库本身无依赖,可以用于任何数据通讯 (网络库本身不依赖Protobuff仅上层示例依赖
2023-06-29 19:34:10 +08:00
2024-05-20 17:36:47 +08:00
不用关心网络底层,直接引用或继承,即可便捷使用。
2023-06-29 19:34:10 +08:00
2024-05-20 17:36:47 +08:00
示例demo中包含服务端和客户端双端库可直接用于各类.Net版本程序或Unity程序做TCP通讯底层库。
2023-06-29 19:34:10 +08:00
2024-05-20 17:36:47 +08:00
并包含心跳包等检测、连接管理、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目录下有实例客户端和实例服务端
2024-05-20 17:36:47 +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
服务端基本框架(连接管理,用户管理,消息收发,指定用户发送,广播等)
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
客户端
2024-05-20 17:47:19 +08:00
HaoYueNet.ClientNetwork.dll (.net8 推荐跨平台.net程序使用)
2023-07-06 14:47:20 +08:00
2024-05-20 17:47:19 +08:00
HaoYueNet.ClientNetworkNet.Standard2.dll (.NetStandard 2.0标准的库,用于各种.Net运行时传统.Net4.X版本,用于传统.NetFX程序或Unity游戏或Mono程序)