Integration von Xsolla-Servern

Bei dieser Integrationsart werden die folgenden Aufgaben aufseiten von Xsolla durchgeführt:
  • Katalogspeicherung und ‑verwaltung
  • Preisverwaltung
  • Speicherung von Daten über regionale Preise
  • Verwaltung regionaler Beschränkungen
  • Inventarverwaltung
  • Verwaltung von Werbekampagnen
  • Benutzerauthentifizierung
  • Benutzerzugriffsverwaltung
  • Transaktionsverarbeitung
Discord-Server
Treten Sie mit dem Xsolla-Team und Entwicklern, die Xsolla-Produkte nutzen, in Kontakt.
Für diese Aufgaben müssen Sie keine Konfiguration aufseiten Ihres Servers vornehmen.

Integrationsablauf

So erfolgt die Integration in die Xsolla-Server mithilfe des Game Commerce-Plug-ins:
  1. Installieren Sie das Plug-in.
  2. Konfigurieren Sie das Projekt im Kundenportal.
  3. Konfigurieren Sie Login oder implementieren Sie Ihr eigenes Autorisierungssystem mithilfe des Zugriffstokens der Bezahlstation.
  4. Konfigurieren Sie das Modul "Virtuelle Währung" (optional).
  5. Konfigurieren Sie das Modul "Virtuelle Gegenstände".
  6. Richten Sie Ihr UE4-Projekt ein.
Testen Sie den Zahlungsvorgang nach Abschluss der Integration.
Note
In diesem Leitfaden werden die minimalen Einstellungen beschrieben, die für den Schnellstart des Moduls erforderlich sind. Bei Fragen wenden Sie sich bitte an Ihren Account Manager.

Plug-in installieren

  1. Laden Sie den Epic Games Launcher herunter.
  2. Erstellen Sie ein neues UE4-Projekt.
  3. Laden Sie das Plug-in aus dem Unreal Engine Marketplace oder von GitHub herunter.

Starten Sie nach der Installation des Plug-ins die Demo-Maps aus dem Verzeichnis Content Browser > Xsolla Content > Maps. Demo-Maps veranschaulichen die Funktionen des Plug-ins und stellen eine Möglichkeit dar, die Anwendungslogik zu implementieren.

Für Demos-Maps existieren ein voreingestelltes Projekt und ein vollständig konfigurierter Ingame-Online-Shop im Kundenportal.

Standardwerte für Demo-Maps:

KeyValue
Login-ID026201e3-7e40-11ea-a85b-42010aa80004
Projekt-ID77640

Demo-Maps lassen sich auf zwei Wege nutzen:

  • als Beispiel
  • als erste Version bzw. als Ausgangspunkt für das Anmeldesystem, das Inventar und den Ingame-Shop, um zügig Ergebnisse zu erzielen und deren jeweilige Funktionen bei Bedarf zu erweitern

Projekt im Kundenportal einrichten

  1. Registrieren Sie sich im Kundenportal.
  2. Konfigurieren Sie das automatisch nach der Registrierung im Kundeportal erstellte Projekt:
    1. Wählen Sie im Abschnitt Projekte Ihr Projekt aus, und wechseln Sie in die Projekteinstellungen.
    2. Fügen Sie in der Registerkarte Allgemeine Einstellungen Folgendes hinzu:
      • Bild (optional)
      • Projektsprachen (Englisch ist voreingestellt)
      • Jeweiliger Projektname für alle ausgewählten Sprachen
      • Spiel-Website (optional)
      • Projektbeschreibung (optional)
    3. Klicken Sie auf Speichern.

Während des Integrationsprozesses benötigen Sie die folgenden Parameter:

  • Projekt-ID. Sie finden diese unter Projekteinstellungen > Projekt-ID.

Login einrichten

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie bei Login auf Verknüpfen. Wenn Sie im seitlichen Menü auf Login klicken, gelangen Sie zu den Login-Einstellungen.

  1. Navigieren Sie zu Login-Projekte, und klicken Sie auf Login einrichten.

  1. Geben Sie einen Namen an, und klicken Sie auf Erstellen.

  1. Navigieren Sie zu Allgemeine Einstellungen > URL, und geben Sie die Rückruf-URL ein, an die der Benutzer beim Bestätigen der E-Mail-Adresse oder beim Zurücksetzen des Passworts weitergeleitet wird.
  2. Wählen Sie unter Nutzerdatenspeicherung die Option Bei Xsolla aus.
  3. Konfigurieren Sie die OAuth 2.0-Autorisierung:

    1. Wechseln Sie zum Abschnitt Autorisierung.
    2. Klicken Sie unter OAuth 2.0-Authentifizierung auf Verbinden.
    3. Geben Sie die OAuth 2.0-URIs für die Weiterleitung an, und klicken Sie auf Verbinden.
    4. Kopieren und speichern Sie die Client-ID.

Note
OAuth 2.0 ist die empfohlene Authentifizierungsmethode und in den SDK-Einstellungen standardmäßig ausgewählt.

Modul "Virtuelle Währung" einrichten

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie bei Online-Shop auf Verknüpfen. Wenn Sie im links im Seitenmenü auf Online-Shop klicken, gelangen Sie zu den Ingame-Shop-Einstellungen.

  1. Klicken Sie bei Virtuelle Währung auf Verknüpfen.

  1. Erstellen Sie eine virtuelle Währung:
    1. Klicken Sie auf Virtuelle Währung erstellen.

    1. Geben Sie folgende Informationen an:
      • SKU
      • Name der Währung
      • Preis für eine Einheit der virtuellen Währung
      • Standard-Währung
      • Funktionen der Premiumwährung (optional)
      • Bild (optional)
    2. Klicken Sie auf Währung erstellen.

  1. Erstellen Sie ein Paket mit virtueller Währung:
    1. Wechseln Sie zu Pakete.
    2. Klicken Sie auf Paket erstellen.

    1. Geben Sie folgende Informationen an:
      • SKU
      • Paketname
      • kurze Beschreibung
      • virtuelle Währung
      • Menge der virtuellen Währung in einem Paket
      • Preis
      • Standard-Währung
      • Bild (optional)

    1. Stellen Sie die Option Im Online-Shop anzeigen auf Ein.
    2. Klicken Sie auf Paket erstellen.

Note
Das Plug-in unterstützt den Kauf von virtuellen Gegenständen gegen virtuelle Währung. Außerdem können Benutzer die virtuelle Währung gemäß der Ingame-Logik verwenden (Zugang zu einem Ort erhalten, im Level aufsteigen usw.). Die Benutzer geben virtuelle Währung aus, wenn sie eine ConsumeInventoryItem-SDK-Methode aufrufen.

Modul "Virtuelle Gegenstände" einrichten

Note
Die SDK-Methoden unterstützt die folgenden Artikeltypen:
  • Verbrauchsgegenstand - ein Gegenstand im Inventar, der wiederholt angehäuft oder gekauft werden kann und dessen Anzahl nach Gebrauch abnimmt. Der Gegenstandsbestand kann wieder aufgefüllt werden. Beispiel: Granaten und Geschosse zum Angriff auf den Gegner, Erste-Hilfe-Kästen usw.
  • Dauerhafter Gegenstand – Ein Gegenstand im Inventar, der einmal erworben oder gekauft werden kann und nicht aus dem Inventar verschwindet. Beispiel: Zugang zu einem Standort, Status usw.
  • Automatisch endende Abos – nur für einen begrenzten Zeitraum verfügbar. Wird auch nach dem Ablauf im Inventar angezeigt. Zum Beispiel: Premium-Zugang oder Season Pass. Weitere Einzelheiten finden Sie in der Ingame-Online-Shop-Dokumentation.

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie bei Online-Shop auf Verknüpfen. Wenn Sie im links im Seitenmenü auf Online-Shop klicken, gelangen Sie zu den Ingame-Shop-Einstellungen.

  1. Klicken Sie bei Virtuelle Gegenstände auf Verknüpfen.

  1. Klicken Sie auf Gruppe erstellen.

  1. Geben Sie den Gruppencode und den Gruppennamen an.
  2. Stellen Sie den Umschalter Gruppe im Online-Shop anzeigen auf Ein.
  3. Klicken Sie auf Gruppe erstellen.

  1. Erstellen Sie Gegenstände:
    1. Geben Sie dabei folgende Infos für jeden Gegenstand an:
      • eine oder mehrere Gruppen, zu denen der Gegenstand gehört
      • SKU
      • Name und kurze Beschreibung
      • Preise in echter und virtueller Währung
      • Bild (optional)

    1. Wählen Sie unter Einstellungen im Feld Gegenstandseigenschaften eine der folgenden Optionen aus:
      • Verbrauchsgegenstand
      • Dauerhaft
      • Automatisch endendes Abo
    2. Klicken Sie auf Gegenstand anlegen.

  1. Stellen Sie sicher, dass als Status der Gruppe Aktiviert angezeigt wird.

UE4-Projekt einrichten

  1. Öffnen Sie das UE4-Projekt in Unreal Editor.
  2. Gehen Sie bei Blueprint-Projekten wie folgt vor:
    1. Kompilieren Sie das UE4-Projekt.
    2. Rufen Sie den Content Browser auf und fügen Sie eine New C++ Class mit None als Elternknoten hinzu.
  3. Navigieren Sie zu Settings > Plugins > Installed > Xsolla Store SDK. Aktivieren Sie das Kontrollkästchen bei Enabled, und klicken Sie auf die Schaltfläche Restart Now, um die Einstellungen zu speichern und Unreal Editor neu zu laden.

  1. Geben Sie die Projektparameter an:
    1. Navigieren Sie zu Settings > Project Settings > Plugins > Xsolla Login, und geben Sie folgende Parameter an:

      1. Geben Sie in den Feldern Login IDDemo Login IDdie Login-ID aus dem Kundenportal an.
      2. Geben Sie in den Feldern Project ID und Demo Project ID die Projekt-ID aus dem Kundenportal an.
      3. Aktivieren Sie die Option Use OAuth 2.0.
      4. Geben Sie im Feld Client ID die bei der OAuth 2.0-Einrichtung im Kundenportal erhaltene Client-ID an

Note
Wenn Sie Ihr eigenes Autorisierungssystem verwenden, können Sie die Felder Login ID und Demo Login ID leer lassen.

    1. Navigieren Sie zu Settings > Project Settings > Plugins > Xsolla Store, und geben Sie die Projekt-ID in den Feldern Project ID und Demo Project ID an.

    1. Navigieren Sie zu Settings > Project Settings > Plugins > Xsolla Inventory, und geben Sie die Projekt-ID in den Feldern Project ID und Demo Project ID an.

Daraufhin wird Ihr Projekt im Kundenportal mit den Demo-Maps verknüpft.

  1. Navigieren Sie zu Content Browser > View Options, und aktivieren Sie die Kontrollkästchen bei Show Engine Content und Show Plugin Content.

  1. Navigieren Sie zu Content Browser > Xsolla Content > Maps, und starten Sie die Demo_Store-Map des Spiels.
  2. Gestalten Sie eine Benutzeroberfläche für das Anmeldesystem, den Ingame-Shop und sonstige Seiten Ihrer Anwendung.

Note
Sie können Ihre eigene Lösung erstellen, befolgen Sie dazu die UMG UI-Dokumentation. Alternativ können Sie die Demoszene als Vorlage verwenden. Um die Benutzeroberfläche der Demoszene an Ihre Anwendung anzupassen, verwenden Sie den Benutzeroberflächen-Baukasten.

  1. Richten Sie die Ereignisbehandlung entsprechend Ihrer Anwendungslogik mithilfe der SDK-Methoden ein. In den Tutorials werden die grundlegenden SDK-Funktionen Schritt für Schritt erläutert.

Note
Befolgen Sie die Anleitung für die SDK-Modifizierung, um das SDK für Ihre Anwendung zu modifizieren.

Zahlungsvorgang testen

Nach erfolgreicher Konfiguration des Plug-ins können Sie den Zahlungsvorgang testen. Standardmäßig werden alle Zahlungen für sämtliche Benutzer in der Testumgebung bzw. im Sandbox-Modus abgewickelt. Sie können eine Testbankkarte nutzen, um einen erfolgreichen Zahlungsvorgang zu simulieren.

So testen Sie den Zahlungsvorgang durch das Abwickeln echter Zahlungen:

  1. Stellen Sie sicher, dass Sie einen Vertrag mit Xsolla geschlossen haben.
  2. Deaktivieren Sie in Ihrem UE4-Projekt das Kontrollkästchen Sandbox unter Settings > Project Settings > Plugins > Xsolla Store.

Note
Nachdem die erste echte Zahlung erfolgt ist, tritt eine strenge Sandbox-Zahlungsrichtlinie in Kraft. Eine Zahlung in der Testumgebung bzw. im Sandbox-Modus ist nur für Benutzer verfügbar, die unter Kundenportal > Firmeneinstellungen > Nutzer angegeben sind.
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.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!

Weitere Informationen

Letztmalig aktualisiert: 1. September 2021

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!