GServer

GServer

Über GServer

• Was ist GServer?
• Was ist zuverlässiges UDP?
• Warum zuverlässiges UDP besser ist als TCP

Verwendung

Klassen

• Gastgeber
• Nachricht
• Datenspeicher
• Plugins

Beispiele

• Server wird gestartet
• Umgang mit Nachrichten
• Plugins hinzufügen

Was ist GServer?

GServer ist eine zuverlässige UDP-Netzwerkbibliothek, die für Spiele entwickelt wurde. Seine Hauptvorteile sind:

• Zuverlässiges UDP-Protokoll
• Plugin-Architektur, die hohe Flexibilität bietet
• Es ist äußerst einfach zu bedienen

Was ist zuverlässiges UDP?

Reliable udp (RUDP) ist ein Transportschichtprotokoll, das für Situationen entwickelt wurde, in denen TCP zu viel Overhead verursacht, wir aber dennoch eine Paketzustellung in garantierter Reihenfolge benötigen.

RUDP-Mods

RUDP unterstützt 3 Mods und deren Kombinationen. GServer implementiert einige der nützlichsten davon:

• Kein Modus – funktioniert wie Standard-UDP
• Zuverlässig – bietet Lieferkontrolle und garantiert, dass alle Pakete zugestellt werden
• Zuverlässige Reihenfolge – garantiert, dass alle gelieferten Pakete in der richtigen Reihenfolge verarbeitet werden, es wird jedoch nicht davon ausgegangen, dass alle Pakete zugestellt werden
• Zuverlässig bestellt – garantiert, dass alle Pakete zugestellt und in der richtigen Reihenfolge bearbeitet werden

Warum zuverlässiges UDP besser ist als TCP

• Zuverlässiges UDP bietet aufgrund seiner Modi mehr Flexibilität als UDP
• Der zuverlässige geordnete Modus simuliert das TCP-Verhalten, arbeitet jedoch schneller, da nicht auf verlorene Pakete gewartet werden muss.

Klassen

Gastgeber

Host ist die Hauptklasse in GServer . Es bietet Methoden zum Empfangen, Senden und Verarbeiten von Nachrichten. Nachrichten werden automatisch im Listen-Thread akzeptiert.

Nachrichten werden mit der Methode „Send“ gesendet und mit Handlern verarbeitet, die vom Benutzer mit der Methode „AddHandler“ registriert werden. Siehe Beispiele.

Nachricht

Nachrichten werden verwendet, um Daten von einem Host an einen anderen zu senden. Es hat 3 Parameter:

• Typ: kurz – Nachrichtentyp, der zum Hinzufügen eines Handlers zu bestimmten Nachrichten verwendet wird.
• mode: Modus – zuverlässiger Modus (siehe RUDP-Mods)
• body: byte[] – serialisierte Daten in einem Byte-Array

Datenspeicher

DataStorage wird verwendet, um Daten in ein Byte-Array zu serialisieren. Es gibt 2 Mods:

• Der Aufruf des Konstruktors ohne Parameter aktiviert den Nur-Schreibmodus .
• Durch Aufrufen des Konstruktors mit dem Parameter „byte[]“ oder „MemoryStream“ wird der schreibgeschützte Modus aktiviert.

Im schreibgeschützten Modus können Sie nur Lesemethoden verwenden, die Daten aus dem Puffer lesen. Im Nur-Schreib -Modus können Sie nur Schreibmethoden verwenden, die Daten in den Puffer schreiben.

Plugins

In Bearbeitung ...

Beispiele

Server starten

Server

 Host host = new Host ( portNumber ) ; //instantiate host on portNumber port
host . StartListen ( numberOfThreads ) ; //StartListen on numberOfThreads threads

Timer timer = new Timer ( o => host . Tick ( ) ) ;
timer . Change ( 10 , 10 ) ; // enables timer tick every 10 milliseconds

Kunde

 Host host = new Host ( portNumber ) ; //instantiate host on portNumber port
host . StartListen ( numberOfThreads ) ; //StartListen on numberOfThreads threads

Timer timer = new Timer ( o => host . Tick ( ) ) ;
timer . Change ( 10 , 10 ) ; // enables timer tick every 10 milliseconds

host . OnConnect = ( ) => Console . WriteLine ( "Connected" ) ; // connect handler 

host . BeginConnect ( serverEndpoint ) ; // connecting to server endpoint 

Umgang mit Nachrichten

 /* host inicialization here */

//add handler to message with id == messageId
//when message with that id will arrive callback will be invoked
//connection - connection associated with sender
host . AddHanlder ( messageId , ( message , connection ) => 
{
    /* deserialize message buffer */
    /* process message buffer */
    /* send response if needed */
} ) ; 

Datenspeicher

 class SimpleClass : ISerializable , IDeserializable 
{
     public int IntField { get ; set ; }
     public byte [ ] ByteArray { get ; set } // arraySize = IntField
     public byte [ ] Serialize ( ) 
     {
          var ds = DataStorage . CreateForWrite ( ) ;
          ds . Push ( IntField ) ;
          ds . Push ( ByteArray ) ;
          return ds . Serialize ( ) ;
     }
     public void FillDeserialize ( byte [ ] buffer )
     {
          var ds = DataStorage . CreateForRead ( buffer ) ;
          IntField = ds . ReadInt32 ( ) ;
          ByteArray = ds . ReadBytes ( IntField ) ;
     }
}