Mithilfe des Xsolla Launcher 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 Launcher ein, damit der Benutzername und das Passwort nicht erneut eingegeben werden müssen.

1. Implementieren Sie die Launcher Autorisierungslogik in Ihre Anwendung.
2. Erstellen Sie einen Anwendungs-Build, und laden Sie sie in das Launcher hoch.

Logik für Autorisierung über das Launcher implementieren

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

1. Der Benutzer autorisiert sich im Launcher.
2. Der Benutzer installiert die Anwendung und führt sie aus.
3. Das Launcher 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. Vergewissern Sie sich, dass in den SDK-Einstellungen die Login-Projekt-ID angezeigt wird, die im Kundenportal in den Launcher Einstellungen (Launcher > Allgemeine Einstellungen > Authentifizierung) angegeben ist.
3. Öffnen Sie im Content Browser die Benutzerautorisierungs-Map, in der der Token verarbeitet wird.
4. Navigieren Sie im Hauptmenü zu Edit > Project Settings.
5. Navigieren Sie zu Project > Maps & Modes, und wählen Sie im Feld Game Default Map die zuvor geöffnet Autorisierungs-Map aus.

6. 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.
7. 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.