MHLab.AspNetCore.Enet

MHLab.AspNetCore.Enet

ASP.NET Core 애플리케이션에서 Enet 서버를 회전시킬 수 있는 확장입니다. Stanislav Denisov의 멋진 작품인 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 폴더에서 사용 샘플을 찾을 수 있습니다. 이는 Enet 서버가 추가된 클래식 ASP.NET Core 웹 API 템플릿입니다.

연결 처리기

새 클라이언트 연결이 설정되면 연결 처리기가 트리거됩니다. 다음과 같이 연결 핸들러를 구축할 수 있습니다.

 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 } " ) ;
    }
}