SteamQueryNet

Steamquerynet

SteamqueryNet هو ملف C# لبروتوكول UDP لاستفسارات خادم Steam. إنها؛

• ضوء
• التبعية خالية
• مكتوب في .NET Standard 2.0 بحيث يعمل مع كل من .NET Framework 4.6+ و Core.

كيفية التثبيت؟

تحقق من steamquerynet على nuget.

كيف تستخدم؟

يأتي Steamquerynet مع كائن واحد يتيح لك الوصول إلى جميع بروتوكول API الخاص ببروتوكول Steam ؛

• معلومات الخادم (اسم الخادم ، السعة ، إلخ).
• اللاعبون المتزامنون.
• قواعد الخادم (FriendlyFire ، Roundttime وما إلى ذلك). تحذير: حاليًا لا يعمل بسبب مشكلة بروتوكول على API Steam Server Query. يمكن أن يستفيد استخدام ServerInfo.tags إذا كان مدراء الخادم لطيفًا بما يكفي لوضع القواعد كعلامات في الحقل.

إنشاء مثيل

للاستفادة من واجهة برمجة التطبيقات المذكورة أعلاه ، يجب إنشاء مثيل لـ ServerQuery .

 string serverIp = "127.0.0.1" ;
int serverPort = 27015 ;
IServerQuery serverQuery = new ServerQuery ( serverIp , serverPort ) ;

أو يمكنك استخدام حلول السلسلة كما أدناه:

    string myHostAndPort = "127.0.0.1:27015" ;
    // or
    myHostAndPort = "127.0.0.1,27015" ;
    // or
    myHostAndPort = "localhost:27015" ;
    // or
    myHostAndPort = "localhost,27015" ;
    // or
    myHostAndPort = "steam://connect/127.0.0.1:27015" ;
    // or
    myHostAndPort = "steam://connect/localhost:27015" ;

    IServerQuery serverQuery = new ServerQuery ( myHostAndPort ) ;

أيضًا ، من الممكن إنشاء كائن ServerQuery دون الاتصال كما يلي:

 IServerQuery serverQuery = new ServerQuery ( ) ;
serverQuery . Connect ( host , port ) ;

ملاحظة : تشبه عمليات التحميل الزائدة Connect مع منشئي ServerQuery غير الفارغة.

توفير udpclient مخصصة

يمكنك توفير عملاء UDP مخصصون من خلال تطبيق IUdpClient في مساحة الاسم SteamQueryNet.Interfaces .

انظر المثال أدناه:

 public class MyAmazingUdpClient : IUdpClient
    {
        public bool IsConnected { get ; }

        public void Close ( )
        {
            // client implementation
        }

        public void Connect ( IPEndPoint remoteIpEndpoint )
        {
            // client implementation
        }

        public void Dispose ( )
        {
            // client implementation
        }

        public Task < UdpReceiveResult > ReceiveAsync ( )
        {
            // client implementation
        }

        public Task < int > SendAsync ( byte [ ] datagram , int bytes )
        {
            // client implementation
        }
    }

    // Usage
    IPEndpoint remoteIpEndpoint = new IPEndPoint ( IPAddress . Parse ( remoteServerIp ) , remoteServerPort ) ;

    IUdpClient myUdpClient = new MyAmazingUdpClient ( ) ;
    IServerQuery serverQuery = new ServerQuery ( myUdpClient , remoteIpEndpoint ) ;

بمجرد إرجاع وظائفها التي تم إنشاؤها أدناه ، تُرجع المعلومات المطلوبة ،

ServerInfo

 ServerInfo serverInfo = serverQuery . GetServerInfo ( ) ;

اللاعبون

 List < Player > players = serverQuery . GetPlayers ( ) ;

قواعد

 List < Rule > rules = serverQuery . GetRules ( ) ;

على الرغم من عدم تشجيعها ، يمكنك سلسلة Connect Processor أو مُنشئين غير فارغ للحصول على معلومات في سطر واحد.

 ServerInfo serverInfo = new ServerQuery ( )
. Connect ( host , port )
. GetServerInfo ( ) ;

تودوس

• تمكين CI