Mithilfe des Xsolla-Startprogramms können Sie Ihre Anwendungen an Benutzer ausliefern und aktualisieren. Das Startprogramm verfügt über ein integriertes Autorisierungstool. Richten Sie die Autorisierung in Ihrer Anwendung über das Startprogramm ein, damit der Benutzername und das Passwort nicht erneut eingegeben werden müssen.

SDK und Startprogramm für das Zusammenspiel untereinander einrichten

1. Konfigurieren Sie das Startprogramm im Kundenportal.

2. Passen Sie die Benutzeroberfläche des Startprogramms an.

3. Implementieren Sie die Autorisierungslogik des Startprogramms in Ihrer Anwendung.
4. Generieren Sie eine Startprogramm-Installationsdatei und ein Build-Archiv.
5. Erstellen Sie eine Anwendungs-Build.
6. Laden Sie die Anwendungs-Build auf den Xsolla-Updateserver hoch.

Logik für Autorisierung über das Startprogramm implementieren

Der Ablauf für die Autorisierung in der Anwendung über das Startprogramm ist wie folgt:

1. Der Benutzer autorisiert sich im Startprogramm.
2. Der Benutzer installiert die Anwendung und führt sie aus.
3. Das Startprogramm führt die Anwendung aus und übermittelt Benutzerparameter in der Befehlszeile. Der Autorisierungstoken wird im Parameter xsolla-login-token übermittelt.
4. Die Anwendung verarbeitet die Befehlszeilenparameter und erhält einen Token.
5. Die Anwendung validiert den empfangen Token.
6. Die Anwendung autorisiert den Benutzer automatisch, ohne eine Autorisierungsseite anzuzeigen.

Eine beispielhafte Implementierung dieser Logik ist im W_LoginDemo-Blueprint des Demoprojekts verfügbar.

Anwendungs-Build erstellen

1. Wechseln Sie zu Ihrem Unreal Engine-Projekt.
2. Öffnen Sie im Content Browser die Benutzerautorisierungs-Map, in der der Token verarbeitet wird.
3. Navigieren Sie im Hauptmenü zu Edit > Project Settings.
4. Navigieren Sie zu Project > Maps & Modes, und wählen Sie im Feld Game Default Map die zuvor geöffnet Autorisierungs-Map aus.

5. Navigieren Sie zu Plugins > Xsolla Settings.
6. Geben Sie im Feld Project ID die Projekt-ID an. Diese finden Sie unter Kundenportal > Projekteinstellungen > Projekt-ID.
7. Geben Sie im Feld Login ID die Login-ID an. Diese finden Sie unter Kundenportal > Startprogramm > Allgemeine Einstellungen > Authentifizierung.
8. Navigieren Sie im Hauptmenü zu File > Package Project > Windows (64 bit) bzw. File > Package Project > Mac, je nachdem, für welche Plattform Sie die Build erstellen.
9. Geben Sie im Pop-up-Fenster den Pfad zu dem Verzeichnis an, in dem die fertige Build abzulegen ist.

Die native Authentifizierung ermöglicht es Spielern, über den installierten Steam-Client auf Ihre Anwendung zuzugreifen. Nachdem Sie die native Authentifizierung über Steam eingerichtet haben, können Sie innerhalb der Anwendung Zahlungen über Steam entgegennehmen.

So richten Sie die native Authentifizierung ein:

1. Konfigurieren Sie die stille Authentifizierung über Steam im Kundenportal.
2. Konfigurieren Sie Ihr Unreal Engine-Projekt.
3. Konfigurieren Sie die Ereignisverarbeitung.
4. Ermöglichen Sie die Authentifizierung über Steam.

Unreal Engine-Projekt konfigurieren

1. Wechseln Sie zum Config-Katalog Ihres Unreal Engine-Projekts.
2. Fügen Sie der Datei DefaultEngine.ini folgende Zeilen hinzu, und geben Sie Ihre App-ID aus Steam im Parameter SteamDevAppId an.

[/Script/Engine.GameEngine]
+NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="OnlineSubsystemSteam.SteamNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")

[OnlineSubsystem]
DefaultPlatformService=Steam

[OnlineSubsystemSteam]
bEnabled=true
SteamDevAppId=480

[/Script/OnlineSubsystemSteam.SteamNetDriver]
NetConnectionClassName="OnlineSubsystemSteam.SteamNetConnection"

3. Öffnen Sie das Projekt in Unreal Editor.
4. Navigieren Sie zu Settings > Plugins > Online Platform.
5. Aktivieren sie im Modul Online Subsystem Steam das Kontrollkästchen bei Enabled, und klicken Sie auf Restart Now, um die Einstellungen zu speichern und Unreal Editor neu zu laden.

Ereignisverarbeitung einrichten

1. Im folgende Bild wird gezeigt, wie man dem Projekt Knoten hinzufügt:

Für die Benutzerauthentifizierung über Steam sollten Sie ein session ticket über die Methode GetSessionTicket abrufen. Übermitteln Sie den empfangenen Wert beim Aufruf der Methode AuthenticateWithSessionTicket. Infolgedessen erhalten Sie den Token, welcher im Rahmen der API zum Einsatz kommt.

2. Fügen Sie für eine zusätzliche Tokenvalidierung den Methodenrückruf ValidateToken hinzu (optional).

Authentifizierung über Steam ermöglichen

1. Erstellen Sie die Build Ihres Unreal Engine-Projekts für eine eigenständige Plattform.
2. Starten Sie Steam und melden Sie sich an.
3. Starten Sie Ihre Anwendung. Wen alles in Ordnung ist, wird das Steam-Pop-up-Fenster angezeigt.