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