ObjectDeliverer

对象传递者

UE市场

https://www.unrealengine.com/marketplace/ja/slug/objectdeliverer

描述

ObjectDeliverer是Unreal Engine（C++，Blueprint）的数据传输/接收库。

它具有以下特点。

• 通信协议、数据划分规则、串行化方法可通过部件更换进行切换。
• 适用于 C++ 和蓝图

分支与UE Engine版本的关系

master分支可使用UE5 5.0或更高版本构建； UE4 需要进行一些修改才能构建。

通讯协议

以下协议可与内置协议一起使用。您还可以添加自己的协议。

• TCP/IP服务器（可连接多个客户端）
• TCP/IP客户端
• UDP（发送方）
• UDP（接收方）
• 共享内存（仅限Windows）
• 日志文件编写器
• 日志文件阅读器

数据划分规则

以下规则可用于内置的发送和接收数据的分割规则。

• 固定尺寸
  例）固定1024字节的情况

• 标头（正文尺寸）+正文
  示例）当大小区域为 4 字节时
  

• 按端子符号分割
  示例）当 0x00 为结束时

序列化方法

• 字节数组
• UTF-8 字符串
• 对象（Json）

安装

• 请克隆此存储库
• 请将Plugins目录复制到项目文件夹中
• 启动编辑器后请从插件激活 ObjectDeliverer

快速入门

1. 创建一个ObjectDelivererManager
2. 创建一个 DeliveryBox（如果您希望发送和接收二进制以外的数据）
3. 设置发送/接收协议和PacketRule，然后启动ObjectDelivererManager

 void UMyClass::Start ()
{
    auto deliverer = UObjectDelivererManager::CreateObjectDelivererManager ();

    // bind connected event
    deliverer-> Connected . AddDynamic ( this , &UMyClass::OnConnect);
    // bind disconnected event
    deliverer-> Disconnected . AddDynamic ( this , &UMyClass::OnDisConnect);
    // bind receive event
    deliverer-> ReceiveData . AddDynamic ( this , &UMyClass::OnReceive);

    // start deliverer
    // + protocol : TCP/IP Server
    // + Data division rule : Header(BodySize) + Body
    // + Serialization method : Byte Array
    deliverer-> Start ( UProtocolFactory::CreateProtocolTcpIpServer ( 9099 ),
                     UPacketRuleFactory::CreatePacketRuleSizeBody ());
}

void UMyClass::OnConnect (UObjectDelivererProtocol* ClientSocket)
{
    // send data
    TArray<uint8> buffer;
    deliverer-> Send (buffer);
}

void UMyClass::OnDisConnect (UObjectDelivererProtocol* ClientSocket)
{
    // closed
    UE_LOG (LogTemp, Log, TEXT ( " closed " ));
}

void UMyClass::OnReceive (UObjectDelivererProtocol* ClientSocket, const TArray<uint8>& Buffer)
{
    // received data buffer
}

各功能的使用方法

查看维基 https://github.com/ayumax/ObjectDeliverer/wiki