4) Les classes existantes et données récupérables

Alors voila, je vais avoir le rôle de vous dressez toutes les valeurs qui existes, ce qui revient aussi un peu à parler de tout le flux XML, allez c'est parti ^^ .

Il existe actuellement 9 classes dans Xhordes :

error : Contient les erreurs liées au site de Hordes, par exemple : horde_attacking ou encore not_in_game.
headers : Contient les infos principales du site Hordes et des infos sur la ville.
city : Contient les infos de la ville, la gazette et les défenses.
bank : et bien il s'agit des objets en banque ;) .
expeditions : Liste des expéditions tracées
citizens : Liste des citoyens encore en vie.
cadavers : Liste des citoyens qui sont passé dans le camp des zombies.
map : Le désert et ses batiments.
upgrades : La liste des projets et leur évolution.
estimations : Estimation(s) donnée(s) par la tour de guet.

Petite explication avant de commencer, toutes les données vont être présentées sous forme de tableau afin d'avoir une meilleure lisibilité de la page.
Certaines données sont retournées sous formes d'array, afin de comprendre leur contenu je vous invite à utiliser cette méthode.

error

Description	Classe	Noeud	Variable
Il s'agit du code retourné par le site Valeur possible : missing_key : la clé doit être fournie user_not_found : la clé n'est pas valide not_in_game : le citoyen n'est pas dans une ville (mort) horde_attacking : la horde est en train d'attaquer	error	error	code
Indique si le site est ouvert ou pas (0 = ouvert, 1 = fermé).	error	status	open
Il s'agit d'un message accompagnant quand le site est fermé (exemple : pendant l'attaque, open est égal à 1 et le message indique que c'est l'attaque.	error	status	msg

headers

Description	Classe	Noeud	Variable
URL de Hordes.	headers	headers	link
URL des icones.	headers	headers	iconurl
Indique si on utilise le XML sécurisé (au passage Xhordes est fait pour un XML non sécurisé, il faudrait y ajouter la gestion des noeuds ajoutés lors d'un XML sécurisé, ce que je ne possède pas...).	headers	headers	secure
Auteur de Hordes, jusqu'à présent il s'agit de Motion-Twin ^^ .	headers	headers	author
Langue du XML	headers	headers	language
La version du XML, il peut être important de vérifier constament la version du XML via un script afin de ne pas avoir de surprise, car en général quand le flux XML change de version il faut réadapter certains de ses scripts (modification de noeuds, ajout ou suppression sont courants).	headers	headers	version
URL des avatars des joueurs.	headers	headers	avatarurl
Générateur du XML, Motion-Twin utilise le langage Haxe (qu'ils ont dévéloppés eux mêmes au passage :) ).	headers	headers	generator
Nombre de jour de la ville.	headers	game	days
Si la ville a été mise en quarantaine suite à un bug (0 si pas de quarantaine sinon 1) La quarantaine se traduit généralement par le faite qu'il n'y a pas eu d'attaque.	headers	game	quarantine
Date et heure actuelle.	headers	game	datetime
Id de la ville.	headers	game	id

city

Description	Classe	Noeud	Variable
Nom de la ville	city	city	name
Etat de la porte (1 = porte ouvert; 0 = porte fermée).	city	city	door
Quantité d'eau dans le puit de la ville.	city	city	water
Position de la ville.	city	city	x
Position de la ville.	city	city	y
Nombre de zombie de la précédente attaque.	city	news	zombie
Contenu de la Gazette.	city	news	content
Liste des batiments construits.	city	buildings	liste
Liste contenant les différentes défenses de la ville.	city	defense	liste

bank

Description	Classe	Noeud	Variable
Liste des objets en banque. (Sera retourné sous forme d'array)	bank	bank	items

expeditions

Description	Classe	Noeud	Variable
Liste des expéditions. (Sera retourné sous forme d'array)	expeditions	expeditions	liste

citizens

Description	Classe	Noeud	Variable
Liste des citoyens vivants. (Sera retourné sous forme d'array)	citizens	citizens	liste

cadavers

Description	Classe	Noeud	Variable
Liste des citoyens morts. (Sera retourné sous forme d'array)	cadavers	cadavers	liste

map

Description	Classe	Noeud	Variable
Hauteur de la map (en nombre de case).	map	map	height
Largeur de la map (en nombre de case).	map	map	width
Liste des zones de la map. (Sera retourné sous forme d'array)	map	map	zone

upgrades

Description	Classe	Noeud	Variable
Il s'agit du nombre de projet possible à augmenter.	upgrades	upgrades	total
Liste des projets (sous forme d'array).	upgrades	upgrades	liste

estimations

Description	Classe	Noeud	Variable
Liste des estimations (sous forme d'array). Estimations au pluriel car il peut y en avoir 2, celle d'aujourd'hui et celle de demain.	estimations	estimations	liste

Voila il s'agit des variables récupérables par GetVar, on peut remarquer que les choses les plus interessantes sont sous forme d'array, c'est juste du au faite qu'il y a beaucoup de données et donc c'est plus facile de tout organiser en tableau.
N'hésitez pas à pratiquer pour avoir Xhordes bien en main avant de vraiment coder votre site ;) .

Allez, c'est parti pour la dernière partie.

Précédent - Comment récupérés des données ? - Suivant - Utilisations avancées