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 . إنه قالب ASP.NET Core Web API الكلاسيكي مع إضافة خادم 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 } " ) ;
    }
}