SDK für Unity / So migrieren Sie zur SDK-Version 2.0.0 und neuer
  Alle Dokumentation

SDK für Unity

So migrieren Sie zur SDK-Version 2.0.0 und neuer

Strukturänderungen in Version 2.0.0

  • Abfragemethoden und ‑klassen wurden durch statische Methoden und Klassen ersetzt.
  • Die Projekt-ID wird nicht als Parameter an Methoden übermittelt. Das SDK verwendet den in den Projekteinstellungen angegebenen Wert.
  • Der Benutzerautorisierungstoken wird weder als Parameter an die Methoden übermittelt noch von Rückruffunktionen zurückgegeben. Das SDK ermittelt den Token anhand der vorherigen Benutzerauthentifizierung und übermittelt ihn an die Methoden zum Abrufen eines Katalogs, zum Kauf und zur Anzeige des Inventars.
  • Die Logik, ob es sich um ein Mobilgerät handelt oder nicht, wurde dem SDK hinzugefügt. Die Daten sind in einer DeviceInfo-Struktur gekapselt.

Die volllständige Liste der Änderungen können Sie im Änderungsprotokoll einsehen.

Upgrade der XsollaAuth-Klasse

  • Ersetzen Sie XsollaAuth.Instance- durch XsollaAuth-Aufrufe.
  • Ändern Sie die Signatur der beim Aufruf der Authentifizierungsmethode verwendeten Rückrufmethode onSuccess. Ersetzen Sie Action<string> durch Action.
  • Verzichten Sie darauf, den Parameter refreshToken beim Aufruf der Methode RefreshOAuthToken zu übermitteln.
  • Verzichten Sie darauf, den Parameter token beim Aufruf der Methode GetUserInfo zu übermitteln.
  • Ersetzen Sie den Aufruf XsollaAuth.Instace.OAuthLogout durch XsollaAuth.Logout, und verzichten Sie darauf, den Parameter token beim Aufruf der Methode zu übermitteln.
  • Verzichten Sie darauf, die Parameter deviceType, deviceId,device beim Aufruf der Methode AuthViaDeviceID zu übermitteln. Entfernen Sie die Logik, anhand der ermittelt wird, ob es sich um ein Mobilgerät handelt oder nicht.
  • Ändern Sie die Signatur der beim Aufruf der Methode Register verwendeten Rückrufmethode onSuccess. Ersetzen Sie Action<int>, Action, Action<LoginUrlResponse> durch Action<LoginLink>.
  • Verzichten Sie darauf, den Parameter rememberMe beim Aufruf der Methode SignIn zu übermitteln.
  • Ändern Sie die Signatur der beim Aufruf der Methoden StartAuthByEmail und StartAuthByPhoneNumber verwendeten Rückrufmethode onSuccess. Ersetzen Sie Action<string> durch Action<OperationId>.

Upgrade der XsollaCart-Klasse

  • Ersetzen Sie XsollaCart.Instance- durch XsollaCart-Aufrufe.
  • Ersetzen Sie XsollaCart.Instance.PurchaseCart- durch XsollaCart.CreateOrder-Aufrufe.
  • Verzichten Sie darauf, den Parameter projectId beim Aufruf der Klassenmethoden zu übermitteln.
  • Wenn Sie nur mit dem Warenkorb des aktuellen Benutzers arbeiten, verzichten Sie darauf, den Parameter cartId beim Aufruf der Klassenmethoden zu übermitteln.

Upgrade der XsollaOrders-Klasse

  • Ersetzen Sie XsollaOrders.Instance- durch XsollaOrders-Aufrufe.
  • Ändern Sie den Code für den Aufruf der Methode OpenPurchaseUI. Übermitteln Sie den Zahlungstoken als paymentToken-Parameter (der Parameter purhaseData wurde durch den Parameter paymentToken ersetzt).
  • Ändern Sie die Signatur der beim Aufruf der Methode OpenPurchaseUI verwendeten Rückrufmethode onBrowserClosed. Ersetzen Sie Action<bool> durch Action<BrowserCloseInfo>.
  • Verzichten Sie darauf, den Parameter projectId beim Aufruf der Klassenmethoden zu übermitteln.

Upgrade der XsollaUserAccount-Klasse

  • Ersetzen Sie XsollaUserAccount.Instance>- durch XsollaUserAccount-Aufrufe.
  • Verzichten Sie darauf, den Parameter token beim Aufruf der Klassenmethoden zu übermitteln.

Upgrade der XsollaSubscriptions-Klasse

  • Ersetzen Sie XsollaSubscriptions.Instance- durch XsollaSubscriptions-Aufrufe.
  • Verzichten Sie darauf, den Parameter projectId beim Aufruf der Klassenmethoden zu übermitteln.

Upgrade der XsollaInventory-Klasse

  • Ersetzen Sie XsollaInventory.Instance- durch XsollaInventory-Aufrufe.
  • Verzichten Sie darauf, den Parameter projectId beim Aufruf der Klassenmethoden zu übermitteln.

Upgrade der XsollaGameKeys-Klasse

  • Ersetzen Sie XsollaGameKeys.Instance- durch XsollaGameKeys-Aufrufe.
  • Verzichten Sie darauf, den Parameter projectId beim Aufruf der Klassenmethoden zu übermitteln.

Upgrade der Token-Klasse

  • Ersetzen Sie Token.Instance- durch XsollaToken-Aufrufe.
  • Ersetzen Sie Token.Instance.GetSteamUserID- durch SteamUItils.GetSteamUserId-Aufrufe.
  • Ändern Sie den Code, mit dem Sie den Wert der Zugriffs- und Aktualisierungstoken abrufen. Nutzen Sie die Eigenschaften XsollaToken.AccessToken und XsollaToken.RefreshToken.

Upgrade der Utility-Klassen

  • Ersetzen Sie die Nutzung der Klassen AndroidSDKSocialAuthHelper und IosSDKSocialAuthHelper durch den Aufruf XsollaAuth.AuthViaSocialNetwork.
  • Ersetzen Sie die Nutzung der Klassen AndroidSDKPaymentsHelper und IosSDKPaymentsHelper durch den Aufruf XsollaWebBrowser.OpenPurchaseUI.

Paketaustausch

  1. Öffnen Sie Ihr Unity-Projekt.
  2. Löschen Sie den Ordner Xsolla.
  3. Laden Sie das SDK oder das Demoprojekt-Paket herunter.
Hinweis
Wenn Sie Codeschnipsel oder eine Demoszenen-Benutzeroberfläche in Ihrem Projekt verwenden, laden Sie das Demoprojekt-Paket herunter, da es bereits die SDK-Dateien enthält. Wenn Sie ein Demoprojekt in Ihr Unity-Projekt eingebunden haben, müssen Sie das SDK nicht integrieren.
  1. Entpacken Sie das Paket.
  2. Navigieren Sie im Hauptmenü des Unity-Editors zu Assets > Import Package > Custom Package, und wählen Sie das SDK oder das Demoprojekt-Paket aus.
  3. Klicken Sie im Fenster mit der Abhängigkeitswarnmeldung auf Install/Upgrade. Daraufhin öffnet sich das Fenster Import Unity Package mit einer Liste von geprüften und installierbaren Dateien. Die Liste zeigt an, welche Dateien unverändert bleiben, welche hinzugefügt und welche ersetzt werden.
  4. Klicken Sie auf Import.
  5. Testen Sie Ihre Anwendung und nehmen Sie bei Bedarf Änderungen am Projektcode vor.
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.
Letztmalig aktualisiert: 22. Januar 2024

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!