Online Highscore
Dieses Tutorial soll demonstrieren, wie man eine Online-Highscore mit Hilfe von PHP und MySQL in DX Studio verwirklichen kann. Falls Du im Anschluss Fragen oder Verbesserungsvorschläge hast, kannst du diese gern im Forum hinterlassen.
1. Vorraussetzungen
Du benötigst:
- Webspace mit PHP und MySQL Unterstützung oder einen lokalen Server (XAMPP)
- das Online-Highscore „Hilfspaket“ (ooh.zip)
- Grundkenntnisse in PHP und MySQL währen von Vorteil, sind aber nicht unbedingt erforderlich
1.1 Das Paket
Das Paket enthält folgende Dateien:
- connect.php – das ist die Konfigurationsdatei mit den Zugangsdaten für die MySQL-Datenbank
- index.php – das ist die wichtigste Datei, sie enthält alle Funktionen zur Verwaltung der Highscore
- onlinehighscore.dxstudio – enthält den Beispielcode
- ooh.js – enthält alle Funktionen um Daten an die „index.php“ zu senden
- readmefirst.txt - Anleitung in englisch
2. Erste Schritte
2.1 Erstellen der MySql Tabelle
Öffne PHPMyAdmin, wähle die entsprechende Datenbank und erstelle eine neue Tabelle mit folgendem Code:
CREATE TABLE IF NOT EXISTS `scores` ( `ID` int(11) NOT NULL auto_increment, `Player_Name` varchar(255) NOT NULL, `Player_Score` int(11) NOT NULL, `Player_Date` timestamp NOT NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP, PRIMARY KEY (`ID`) );
2.2 Konfiguration
Öffne jetzt die „connect.php“ und passe Name, Passwort und Datenbank entsprechend an.
2.3 Hochladen
Jetzt ist auch schon alles soweit vorbereitet. Nun kannst du die connect.php und die index.php(kann nach Belieben umbenannt werden) auf deinen Webspace laden.
3. Die ooh.js
3.1 Inkludieren
Um die Funktionen der ooh.js nutzen zu können müssen wir diese entsprechend in unserem Script inkludieren. Dazu öffnen wir einfach das CodePad und machen einen Rechtsklick auf den „Dokument-Baum“→“Add include file“→“Browse“ →“ooh.js“.
3.2 Beispiel
Beispielanwendung
// include the ooh.js //@"ohh.js" function onInit() { // Neues “connection” Objekt erstellen var connection = new Connection('http://yoursitehere/ohh/index.php'); // Wenn die Verbindung erfolgreich ist, dann fügen wir einen Eintrag hinzu // danach laden wir alle vorhanden Einträge in ein Array namens “entries” if (connection.checkConnection() == true) { connection.addScore('dave', 54587502344); connection.getScore(); for (var i = 0; i < connection.entries.length; i++) { if (typeof connection.entries[i] !="undefined") { print(connection.entries[i]); } else { print("no Data"); } } } else { print("failure"); } }
3.3 Objekt Methoden
Die Objektmethoden:
- checkConnection() Prüft die Verbindung mit der angegebenen URL und gibt einen Wert vom Typ bool zurück
- getHighscore() Speicher die Highscore in einem Array namens entries
- addScore(string name, int score) Sendet name und score via POST zum PHP Script(über das PHP Script warden die Daten dann auch in die Datenbank eingetragen)
