MHLab.AspNetCore.Enet

MHLab.AspNetCore.Enet

Расширение, которое позволяет вам использовать сервер Enet в вашем приложении ASP.NET Core. Он основан на потрясающей работе Станислава Денисова: ENet-CSharp.

Установить легко:

 public void ConfigureServices ( IServiceCollection services )
{
    // Your other code...

    services . AddEnet ( ( configuration ) =>
    {
        configuration
            /* Set the port your Enet Server will listen to. */
            . SetPort ( 7001 )
            /* Set the polling time, in milliseconds. */
            . SetPollingTimeout ( 15 ) ;

        /* Add your connection handlers to compose the pipeline. The order matters. */
        configuration
            . AddConnectionHandler < MyConnectionHandler1 > ( )
            . AddConnectionHandler < MyConnectionHandlerN > ( ) ;

        /* Add your disconnection handlers to compose the pipeline. The order matters. */
        configuration
            . AddDisconnectionHandler < MyDisconnectionHandler1 > ( )
            . AddDisconnectionHandler < MyDisconnectionHandlerN > ( ) ;

        /* Add your timeout handlers to compose the pipeline. The order matters. */
        configuration
            . AddTimeoutHandler < MyTimeoutHandler1 > ( )
            . AddTimeoutHandler < MyTimeoutHandlerN > ( ) ;

        /* Add your packet received handlers to compose the pipeline. The order matters. */
        configuration
            . AddPacketHandler < MyPacketHandler1 > ( )
            . AddPacketHandler < MyPacketHandlerN > ( ) ;
    } ) ;

    // Your other code...
} 

Образец

Пример использования можно найти в папке MHLab.AspNetCore.Enet.Sample . Это классический шаблон веб-API ASP.NET Core с добавлением сервера Enet.

Обработчики соединений

Обработчик соединения запускается при установке нового клиентского соединения. Вы можете создать обработчики соединений следующим образом:

 using ENet ;
using MHLab . AspNetCore . Enet . Handlers ;
using Microsoft . Extensions . Logging ;

public class ConnectionHandler : IConnectionHandler
{
    private readonly ILogger < ConnectionHandler > _logger ;

    public ConnectionHandler ( ILogger < ConnectionHandler > logger )
    {
        /* Here in the constructor you can take the full advantage of the 
        Microsoft Dependency Injection framework. */
        _logger = logger ;
    }

    public void OnConnectedPeer ( Peer peer )
    {
        _logger . LogDebug ( $ "Client connected - ID: { peer . ID } , IP: { peer . IP } " ) ;
    }
} 

Обработчики отключения

Обработчик отключения срабатывает, когда уже подключенный клиент корректно отключается. Вы можете создать свои обработчики отключения следующим образом:

 using ENet ;
using MHLab . AspNetCore . Enet . Handlers ;
using Microsoft . Extensions . Logging ;

public class DisconnectionHandler : IDisconnectionHandler
{
    private readonly ILogger < DisconnectionHandler > _logger ;

    public DisconnectionHandler ( ILogger < DisconnectionHandler > logger )
    {
        /* Here in the constructor you can take the full advantage of the 
        Microsoft Dependency Injection framework. */
        _logger = logger ;
    }

    public void OnDisconnectedPeer ( Peer peer )
    {
        _logger . Log ( LogLevel . Debug , $ "Client disconnected - ID: { peer . ID } , IP: { peer . IP } " ) ;
    }
} 

Обработчики тайм-аута

Обработчик тайм-аута срабатывает, когда уже подключенный клиент некорректно отключается. Вы можете создать обработчики тайм-аута следующим образом:

 using ENet ;
using MHLab . AspNetCore . Enet . Handlers ;
using Microsoft . Extensions . Logging ;

public class TimeoutHandler : ITimeoutHandler
{
    private readonly ILogger < TimeoutHandler > _logger ;

    public TimeoutHandler ( ILogger < TimeoutHandler > logger )
    {
        /* Here in the constructor you can take the full advantage of the 
        Microsoft Dependency Injection framework. */
        _logger = logger ;
    }

    public void OnTimeoutPeer ( Peer peer )
    {
        _logger . Log ( LogLevel . Debug , $ "Client timeout - ID: { peer . ID } , IP: { peer . IP } " ) ;
    }
} 

Обработчики пакетов

Обработчик пакетов срабатывает при получении сообщения от подключенного клиента. Вы можете создать свои обработчики пакетов следующим образом:

 using ENet ;
using MHLab . AspNetCore . Enet . Handlers ;
using Microsoft . Extensions . Logging ;

public class PacketHandler : IPacketHandler
{
    private readonly ILogger < PacketHandler > _logger ;

    public PacketHandler ( ILogger < PacketHandler > logger )
    {
        /* Here in the constructor you can take the full advantage of the 
        Microsoft Dependency Injection framework. */
        _logger = logger ;
    }

    public void OnPacketReceived ( Peer peer , byte channelId , Packet packet )
    {
        _logger . Log ( LogLevel . Debug , $ "Packet received from - ID: { peer . ID } , IP: { peer . IP } , Channel ID: { channelId } , Data length: { packet . Length } " ) ;
    }
}