Nahtlose Web-to-Game-Integration
So funktioniert's
Die nahtlose Web-to-Game-Integration ermöglicht es Ihnen, zu konfigurieren, welche Daten von Ihrer Website an das Spiel in den URL-Parametern gesendet werden. Sie können den Autorisierungstoken eines Nutzers, Marketingkampagnendaten oder beliebige andere Informationen übermitteln.
Ablauf für den Nutzer
Bei der Implementierung einer nahtlosen Web-to-Game-Integration gibt es die folgenden Benutzerszenarien:
- Klick auf einen Startprogramm-Link auf der Website
- Start des Spiels aus dem Startprogramm heraus
Klickt ein Nutzer auf einen Startprogramm-Link auf der Website, geschieht Folgendes:
- Der Nutzer öffnet die Website.
- Der Nutzer klickt auf den Startprogramm-Link.
- Das Startprogramm speichert den Wert des Parameters
payload
aus der URL. - Der Nutzer klickt im Startprogramm auf Spielen.
- Das Startprogramm prüft, ob der Parameter
payload
vorhanden und gültig ist:- Ist die Prüfung erfolgreich, startet das Startprogramm das Spiel mit den Argumenten aus dem
payload
-Parameter. - Bei einer erfolglosen Prüfung:
- Wenn in den Einstellungen des Kundenportals eine URL angegeben ist, leitet das Startprogramm den Nutzer zu dieser URL weiter.
- Ist keine URL in den Einstellungen des Kundenportals angegeben, startet das Startprogramm das Spiel.
- Ist die Prüfung erfolgreich, startet das Startprogramm das Spiel mit den Argumenten aus dem
Startet ein Nutzer ein Spiel aus dem Startprogramm heraus, geschieht Folgendes:
- Der Nutzer öffnet das Startprogramm.
- Der Nutzer klickt im Startprogramm auf Spielen.
- Das Startprogramm prüft, ob der Parameter
payload
vorhanden und gültig ist:- Ist die Prüfung erfolgreich, startet das Startprogramm das Spiel mit den Argumenten aus dem
payload
-Parameter, der beim letzten Start des Startprogramms über den Website-Link erhalten wurde. - Bei einer erfolglosen Prüfung:
- Wenn in den Einstellungen des Kundenportals eine URL angegeben ist, leitet das Startprogramm den Nutzer zu dieser URL weiter.
- Ist keine URL in den Einstellungen des Kundenportals angegeben, startet das Startprogramm das Spiel.
- Ist die Prüfung erfolgreich, startet das Startprogramm das Spiel mit den Argumenten aus dem
Wie komme ich dazu
So richten Sie die nahtlose Web-to-Game-Integration ein:
- Konfigurieren Sie die Einstellungen im Kundenportal.
- Fügen Sie der Website einen Link hinzu.
- Implementieren Sie die Verarbeitung der im Payload-Parameter empfangenen Daten aufseiten des Spiels.
Einstellungen im Kundenportal konfigurieren
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Startprogramm.
- Wählen Sie im Dashboard das gewünschte Startprogramm aus, und klicken Sie auf Startprogramm bearbeiten.
- Scrollen Sie zum Abschnitt Spiele, und klicken Sie rechts neben dem gewünschten Spiel auf Einrichten.
- Wählen Sie die Option Builds.
- Wechseln Sie zur Registerkarte Ausführbare Dateien.
- Geben Sie für jedes Betriebssystem im Feld Name der ausführbaren Datei das Argument
--x_payload_url
an. Übermitteln Sie als Argumentwert die URL der Website, auf der sich der Link bzw. die Schaltfläche befindet. Der Wert sollte mit Base64 kodiert sein.
Lautet beispielsweise der Name der ausführbaren Datei game.exe
und die URL der Spiel-Website http://example.com/start_play
, dann geben Sie game.exe --x_payload_url aHR0cDovL2V4YW1wbGUuY29tL3N0YXJ0X3BsYXk=
im Feld Name der ausführbaren Datei ein.
Website einen Link hinzufügen
Ergänzen Sie Ihre Website um einen Link oder eine Schaltfläche, die die URL im Format xl-<launcher-id>://game/<game-id>?payload=<payload>&expires_in=<expires_in>
öffnet, wobei:
<launcher-id>
und<game-id>
Kennungen des Startprogramms und des Spiels sind, die Sie in der URL im Kundenportal finden:https://publisher.xsolla.com/<merchant-id>/projects/<project-id>/new-launcher/<launcher-id>/game/<game-id>
.<payload>
die an das Spiel zu übermittelten Daten sind.
<expires_in>
die Verfallszeit der im Payload-Parameter übermittelten Daten im Unix-Zeitformat ist.
function getAuthToken() {
return 'YOUR DATA HERE';
}
function getDeeplink(launcherID, gameID) {
const encodedPayload = btoa(getAuthToken());
const expiresIn = new Date();
expiresIn.setHours(expiresIn.getHours() + 1); // Payload data will be fresh for 1 hour
return `xl-${launcherID}://game/${gameID}?payload=${encodedPayload}&expires_in=${expiresIn.getTime()}`;
}
// Put that `href` to button or link address
const href = getDeeplink(123, 4567);
Integration aufseiten des Spiels
Das Spiel empfängt Daten im Argument --xsolla-payload
. Implementieren Sie die Entschlüsselung der Daten durch das Spiel, je nach der von Ihnen gewählten Verschlüsselungsmethode.
Beispiel für den Start eines Spiels, wenn die Daten mit Base64 verschlüsselt sind:
game.exe --xsolla-payload WU9VUiBEQVRBIEhFUkU=
War dieser Artikel hilfreich?
Diese Seite bewerten
Jetzt nicht
Vielen Dank für Ihr Feedback!
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.