GameLoop.Networking

GameLoop.Сеть

Сетевая библиотека UDP для игр, созданных в GameLoop! Он предлагает несколько уровней абстракции, начиная от простой UDP-оболочки низкого уровня и заканчивая уровнями более высокого уровня.

Использование низкоуровневой оболочки UDP

 // Spin up a socket listener. It listens for datagrams from any network address, on the specified port.
var peer = new NetworkSocket ( memoryPool ) ;
peer . Bind ( new IPEndPoint ( IPAddress . Any , port ) ) ; 

 // Send data. It sends data to the specified network address and port.
peer . SendTo ( new IPEndPoint ( IPAddress . Loopback , port ) ) ; 

 // Polling for data. It fetches a message from the receiving queue, if any. If nothing has been received, it just returns "false".
while ( peer . Poll ( out NetworkArrivedData message ) )
{
	var addressFrom = message . EndPoint ;
	var receivedData = message . Data

	// Execute your logic on received data.
} 

IMemoryPool и IMemoryAllocator

Библиотека не выделяет память напрямую. Вместо этого он делегирует эту ответственность двум интерфейсам: IMemoryPool и IMemoryAllocator. Реализуя эти интерфейсы, вы можете управлять распределением и управлением памятью в вашем приложении. Библиотека содержит тривиальный распределитель и тривиальный пул, который можно использовать для быстрого прототипирования.

 var memoryAllocator = new SimpleManagedAllocator ( ) ;
var memoryPool = new SimpleMemoryPool ( memoryAllocator ) ; 

Работа с буферами

Библиотека включает в себя несколько удобных структур для работы с буферами, помогающих пользователю писать/читать в них/из них.

 // Reading from a buffer.
byte [ ] buffer = message . Data ;

var reader = default ( NetworkReader ) ;
reader . Initialize ( ref buffer ) ;

int myInt = reader . ReadInt ( ) ;
long myLong = reader . ReadLong ( ) ;
float myFloat = reader . ReadFloat ( ) ;
string myString = reader . ReadString ( ) ;
// etc 

 // Writing to a buffer.
var writer = default ( NetworkWriter ) ;

// 1) You can manually manage the buffer:
/* 1) */ byte [ ] buffer = memoryPool . Rent ( size ) ;
/* 1) */ writer . Initialize ( ref buffer ) ;
// NOTE: in this way the writer will NOT expand the buffer if a Write call requires more space.

// OR

// 2) You can let the writer to manage internally the buffer:
/* 2) */ writer . Initialize ( memoryPool , initialSize ) ;
// NOTE: this will automatically expand the buffer if a Write call requires more space.

// OR

// 3) You can pass a buffer to copy its initial state, but let the writer to manage its own buffer internally:
/* 3) */ byte [ ] initialState = memoryPool . Rent ( size ) ;
/* 3) */ writer . Initialize ( memoryPool , ref initialState ) ;
// NOTE: this will automatically expand the buffer if a Write call requires more space.

writer . Write ( 12 ) ;
writer . Write ( 24f ) ;
writer . Write ( "36" ) ;
// etc