Documentation:Protocole

From Gameforge Official Website

Contents 1 Présentation 2 Le message 3 Ouverture de connection 4 Reponse du client 5 Attente d'identification du compte 6 Reponse du serveur 7 Chargement de l'avatar 8 Chargement de l'avatars effectué

Présentation

Cet article présentera le protole qui sera utilisé entre le client et le serveur. Ce protocole est dit application et se basera sur TCP/IP.

Le message

Tout les messages qu'ils soient emis du client ou du serveur auront une même forme :

• 2 octets : pour le type de message
  • si le message est de taille constant pour son type alors :
    • n octets : le messages
  • sinon :
    • 2 octets : pour la taille totale du message
    • n octets : pour le message

Les données seront envoyé en little endian [1].

Ouverture de connection

Envoie d'un message de longueur constant : Gameforge server: Hello.

Le type du message sera : 0x0000.

Reponse du client

Envoie d'un message de longueur constant : Gameforge client: hello.

le type du message sera : 0x0001.

Attente d'identification du compte

Le client doit envoyer un message pour identifier (login + password) le compte.

Pour la version 0.0.1 :

• le login == pasword --> authentification reussite
• le login != pasword --> echec de l'authentification

Type du message : 0x0002

le message seront sous la forme :

• 1 octets : pour la taille du login
• n octets : pour le login
• n octets : pour le pwd

Reponse du serveur

Idf a échoué alors:

• Le serveur envoie un msg disant que auth a echoué (1)
• Retour a l'etape 3.

Idf est ok alors :

• Le serveur envoie un msg disant que auth est ok (1)
• Le serveur envoie un message pour lister les avatars pour ce compte (2) ce message peut etre envoyer plusieurs fois.

Message (1) dont le type est 0x0003

• 1 octets : pour dire si auth a reussi ou pas :
  • 0 --> echec
  • 1 --> reussi

Message (2) dont le type est 0x0004

• 1 octets : Nombre d'avatar dans ce message pour chaque avatar :
  • 1 octets : idf de l'avatars
  • 1 octets : longeur du nom de l'avatar
  • n octets : nom de avatar

Le message (1) est de type constant.

Chargement de l'avatar

le client envoie un message pour dir qu'el avatar est a charger.

Message dont le type est 0x0005 :

• 1 octets : idf de l'avatars a charger

Chargement de l'avatars effectué

Message dont le type est 0x0006 avec aucun message.