SDKs für Unreal Engine / Authentifizierung über das Startprogramm der Anwendung
 Alle Dokumentation

SDKs für Unreal Engine

  • Integrationsleitfaden

  • Demoprojekt

  • Authentifizierung

  • Katalog

  • Abonnements

  • Werbeaktionen

  • Artikelkauf

  • Spielerinventar

  • Benutzerkonto und ‑attribute

  • Leitfäden für Anwendungs-Builds


  • Authentifizierung über das Startprogramm der Anwendung

    Wenn Sie Xsolla-Startprogramm oder Steam nutzen, um Ihre Anwendung an Benutzer zu verteilen, können Sie den Benutzer automatisch anhand seiner Startprogramm-Anmeldedaten authentifizieren.

    Anleitungen

    Erfahren Sie mehr über erweiterte Einrichtungen in unseren Anleitungen.

    So richten Sie die Autorisierung in der Anwendung über das Startprogramm ein

    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.

    Achtung
    Um das Startprogramm verwenden zu können, muss Login konfiguriert sein. Die Nutzung eines anderen Autorisierungssystems wird nicht unterstützt.

    SDK und Startprogramm für das Zusammenspiel untereinander einrichten

    1. Konfigurieren Sie das Startprogramm im Kundenportal.

    Hinweis
    Es genügt, in der Datei config.json die Werte für folgende Objekte zu ändern:
    • launcher_project_id – geben Sie die Startprogramm-ID an. Diese finden Sie unter Kundenportal > Startprogramm > Allgemeine Einstellungen > Allgemeine Angaben
    • login_project_id – geben Sie die Login-ID an. Diese finden Sie unter Kundenportal > Startprogramm > Allgemeine Einstellungen > Authentifizierung

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

    Achtung
    Für die Integration von SDKs in Xsolla-Server kommen die Aufrufe der IGS & BB API zum Einsatz, daher wird der Startprogramm-Speicher nicht unterstützt.

    1. Implementieren Sie die Autorisierungslogik des Startprogramms in Ihrer Anwendung.
    2. Generieren Sie eine Startprogramm-Installationsdatei und ein Build-Archiv.
    3. Erstellen Sie eine Anwendungs-Build.
    4. 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.

    Hinweis
    Der erhaltene Token wird von SDK-Methoden genutzt, um einen Ingame-Shop zu öffnen, eine Zahlung vorzunehmen usw.

    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.

    1. Navigieren Sie zu Plugins > Xsolla Settings.
    2. Geben Sie im Feld Project ID die Projekt-ID an. Diese finden Sie unter Kundenportal > Projekteinstellungen > Projekt-ID.
    3. Geben Sie im Feld Login ID die Login-ID an. Diese finden Sie unter Kundenportal > Startprogramm > Allgemeine Einstellungen > Authentifizierung.
    4. 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.
    5. Geben Sie im Pop-up-Fenster den Pfad zu dem Verzeichnis an, in dem die fertige Build abzulegen ist.

    War dieser Artikel hilfreich?
    Vielen Dank!
    Gibt es etwas, das wir verbessern können? Nachricht
    Das tut uns leid
    Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
    Vielen Dank für Ihr Feedback!
    Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
    Ausblenden

    So richten Sie die native Authentifizierung über Steam ein

    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.

    Copy
    Full screen
    Small screen

      [/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"

      1. Öffnen Sie das Projekt in Unreal Editor.
      2. Navigieren Sie zu Settings > Plugins > Online Platform.
      3. 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.

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

      War dieser Artikel hilfreich?
      Vielen Dank!
      Gibt es etwas, das wir verbessern können? Nachricht
      Das tut uns leid
      Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
      Vielen Dank für Ihr Feedback!
      Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
      Ausblenden
      Letztmalig aktualisiert: 1. August 2022

      Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

      Problem melden
      Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
      Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
      Vielen Dank für Ihr Feedback!