SDK für Unity / Authentifizierung über das Startprogramm der Anwendung
  Alle Dokumentation

SDK für Unity

Authentifizierung über das Startprogramm der Anwendung

Wenn Sie Xsolla Launcher 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 Authentifizierung in der Anwendung über das Launcher ein

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.

Achtung

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

Das SDK verwendet die IGS API, um mit dem Online-Shop zu kommunizieren. Das Launcher verwendet seine eigene API, weshalb das SDK nicht mit dem Launcher Online-Shop kommunizieren kann.

So richten Sie eine End-to-End-Benutzerauthentifizierung ein:
  1. Implementieren Sie die Launcher Autorisierungslogik in Ihre Anwendung.
  2. Erstellen Sie einen Anwendungs-Build, und laden Sie sie in das Launcher hoch.
Hinweis
Ausführliche Informationen zu den Starprogramm-Einstellungen und zum Hochladen der Anwendungs-Build finden Sie in der Integrationsanleitung.

Logik für die Authentifizierung über das Launcher implementieren

Die Autorisierung in der Anwendung über das Launcher läuft folgt ab:

  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 die Benutzerparameter in der Befehlszeile. Der Autorisierungstoken wird im Parameter xsolla-login-token übermittelt.
  4. Die Anwendung verarbeitet die Befehlszeilenparameter und ruft einen Token ab.
  5. Die Anwendung validiert den empfangen Token.
  6. Die Anwendung autorisiert den Benutzer automatisch, ohne eine Autorisierungsseite anzuzeigen.

Nutzen Sie die SDK-Methode AuthViaXsollaLauncher, um die beschriebene Logik zu implementieren.

Beispielskript für die Authentifizierung über das Launcher:

Copy
Full screen
Small screen
using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Authorization
{
	public class AuthorizationViaXsollaLauncher : MonoBehaviour
	{
		private void Start()
		{
			// Start authorization via Xsolla Launcher
			// Pass callback functions for success and error cases
			XsollaAuth.AuthViaXsollaLauncher(OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Anwendungs-Build erstellen

  1. Wechseln Sie zu Ihrem Unity-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.

  1. Führen Sie die Benutzerautorisierungsszene aus, in der der Token verarbeitet wird.
  2. Klicken Sie im Hauptmenü auf File > Build settings und dann auf Add Open Scenes. Stellen Sie sicher, dass die Autorisierungsszene an erster Stelle in der Liste hinzugefügt wird.
  3. Klicken Sie auf Build.
  4. 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, Ihre Anwendung über die installierte Steam-Anwendung zu starten.

So richten Sie die native Authentifizierung ein:

  1. Konfigurieren Sie die stille Authentifizierung über Steam im Kundenportal.
  2. Konfigurieren Sie Ihr Unity-Projekt.
  3. Implementieren Sie die Logik für die Authentifizierung über Steam.
  4. Ermöglichen Sie die Authentifizierung über Steam.

Unity-Projekt konfigurieren

Hinweis
Das SDK nutzt Steamworks.NET, um mit Steam zu interagieren. Die Bibliothek umfasst das SDK und befindet sich im Verzeichnis Assets/Xsolla/ThirdParty/Steamworks.NET.
  1. Öffnen Sie die Datei steam_appid.txt, die sich im Stammordner des Unity-Projekts befindet.
  2. Geben Sie in der Datei Ihre Anwendungs-ID aus Steam an, und speichern Sie die Änderungen. Der Standardwert in der Datei ist 480, dabei handelt es sich um die ID des Steam-Testprojekts.
  3. Starten Sie den Unity-Editor neu, damit die Änderungen wirksam werden.

Logik für die Authentifizierung über Steam implementieren

Nutzen Sie die SDK-Methode SilentAuth und übermitteln Sie ihr die folgenden Parameter, um die Authentifizierung zu starten:

  • providerName – Publishing-Plattform der Anwendung. Übermitteln Sie steam als Wert.
  • appId – Ihre Anwendungs-ID in Steam. Der Wert muss mit dem in der Datei steam_appid.txt angegebenen Wert übereinstimmen.
  • sessionTicket – Steam-Session-Ticket. Rufen Sie die Methode SteamUtils.GetSteamSessionTicket() auf, um das Ticket abzurufen.
  • onSuccess – Rückruf bei erfolgreicher Benutzerauthentifizierung.
  • onError – Rückruf bei einem Fehler.

Beispielskript für die Authentifizierung über Steam:

Copy
Full screen
Small screen
using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Steam
{
	public class SteamNativeAuthorization : MonoBehaviour
	{
		private void Start()
		{
			// Get the steam session ticket from `SteamUtils` class
			var steamSessionTicket = SteamUtils.GetSteamSessionTicket();

			// Start silent authentication
			// Pass `steam` as `providerName` parameter
			// Pass your `Steam App ID` as `appId` parameter. We use `480` as an example
			// Pass `steamSessionTicket` variable as the `sessionTicket` parameter
			// Pass callback functions for success and error cases
			XsollaAuth.SilentAuth("steam", "480", steamSessionTicket, OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Authentifizierung über Steam ermöglichen

  1. Starten Sie Steam, und melden Sie sich an. Andernfalls wird die Rückruffunktion mitsamt der Fehlermeldung Requested steam session ticket is null. Please check your Steam settings aufgerufen.
  2. Erstellen Sie die Build Ihres Unity-Projekts für eine Stand-alone-Plattform, und führen Sie sie aus. Alternativ können Sie auch eine Szene im Unity-Editor starten. Wenn alles korrekt ist, werden Sie automatisch bei der Anwendung angemeldet.
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: 10. Oktober 2023

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!