SteamQueryNet

SteamQueryNet

SteamQueryNet adalah pembungkus C# untuk Protokol UDP Steam Server. Dia;

• Lampu
• Bebas ketergantungan
• Ditulis dalam .NET Standard 2.0 sehingga berfungsi dengan .NET Framework 4.6+ dan Core.

Bagaimana cara menginstal?

Lihat SteamQueryNet di Nuget.

Bagaimana cara menggunakannya?

SteamQueryNet hadir dengan satu objek yang memberi Anda akses ke semua API dari protokol uap yang;

• Informasi server (nama server, kapasitas dll).
• Pemain bersamaan.
• Aturan server (friendlyfire, roundttime dll). PERINGATAN: Saat ini tidak berfungsi karena masalah protokol di Steam Server Query API. Penggunaan dapat menggunakan serverInfo.tags jika admin server cukup baik untuk menempatkan aturan sebagai tag di lapangan.

Membuat sebuah instance

Untuk memanfaatkan API yang tercantum di atas, contoh ServerQuery harus dibuat.

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

Atau Anda dapat menggunakan string resolvers seperti di bawah ini:

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

Juga, dimungkinkan untuk membuat objek ServerQuery tanpa menghubungkan seperti di bawah ini:

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

Catatan : Overload fungsi Connect mirip dengan konstruktor ServerQuery non-kosong.

Menyediakan udpclient khusus

Anda dapat memberikan klien UDP khusus dengan mengimplementasikan IUdpClient di SteamQueryNet.Interfaces namespace.

Lihat contoh di bawah ini:

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

Setelah fungsi yang dibuat di bawah ini mengembalikan informasi yang diinginkan,

ServerInfo

 ServerInfo serverInfo = serverQuery . GetServerInfo ( ) ;

Pemain

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

Aturan

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

Meskipun tidak dianjurkan , Anda dapat rantai fungsi Connect atau konstruktor yang tidak kosong untuk mendapatkan informasi dalam satu baris.

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

Todos

• Aktifkan CI