Mithilfe von Benutzerattributen lassen sich zusätzliche Benutzerinformationen über Ihre Anwendung verwalten. Benutzerattribute sind Schlüssel-Wert-Paare. Das SDK unterstützt die folgenden Attributtypen:

• Von Benutzern editierbare Attribute. Die Werte für diese Attributtypen werden von einem Benutzer eingegeben oder entsprechend der Ingame-Logik clientseitig festgelegt. Zum Beispiel: Name und Eigenschaften des Spielercharakters, Schwierigkeitsgrad des Spiels usw.

• Schreibgeschützte Attribute. Die Werte für diese Attributtypen werden aufseiten des Anwendungsservers eingegeben und bearbeitet. Wir empfehlen Ihnen, diese Attribute für die Konfiguration von Spielercharaktereigenschaften oder Benutzerparametern zu verwenden, die nicht so oft geändert werden sollen. Zum Beispiel: Wahrscheinlichkeit für das Erhalten einen Bonus, Schlüsselparameter von Spielercharakteren, Benutzerkategorien usw.

Nutzen Sie zum Verwalten von Benutzerattributen die folgenden SDK-Methoden:

• UpdateUserAttributes – aktualisiert die lokal zwischengespeicherte Liste der von Benutzern editierbaren Attribute.
• UpdateUserReadOnlyAttributes – aktualisiert die lokal zwischengespeicherte Liste der schreibgeschützten Attribute.
• ModifyUserAttributes – erstellt oder bearbeitet eine Liste von Benutzerattributen, Änderungen werden aufseiten des Servers vorgenommen.
• RemoveUserAttributes – entfernt Benutzerattribute mit den angegebenen IDs, Änderungen werden aufseiten des Servers vorgenommen.

Wenn Sie mit schreibgeschützten Attributen arbeiten, können Sie einen Server-Token oder einen Kundenportal-Token für die Autorisierung verwenden.

So rufen Sie den Kundenportal-Token ab:

1. Wechseln Sie ins Kundenportal.
2. Navigieren Sie über das Entwicklertool Ihres Browser zur Ansichtsseite für Cookie-Dateien.
3. Kopieren Sie den Wert des Parameters pa-v4-token, und fügen Sie ihn im Authorization-Header ein.

Benutzer können die folgenden Daten über ein Benutzerkonto konfigurieren:

• öffentliche Profildaten:
  • Avatar
  • Nickname

• persönliche Benutzerdaten:
  • Vor- und Nachname
  • Geburtsdatum
  • Geschlecht
  • Telefonnummer
  • E-Mail-Adresse

Sie können das Benutzerkonto über die API-Aufrufe verwalten. Im Login & Account System-Plug-in sind folgende Methoden implementiert:

• UpdateUserDetails – aktualisiert die lokal zwischengespeicherten Benutzerdaten.

• ModifyUserDetails – ändert die angegebenen Benutzerdaten.
• UpdateUserEmail – aktualisiert die lokal zwischengespeicherte E-Mail-Adresse des Benutzers.
• UpdateUserPhoneNumber – aktualisiert die lokal zwischengespeicherte Telefonnummer des Benutzers.
• ModifyUserPhoneNumber – ändert die Telefonnummer des Benutzers.
• RemoveUserPhoneNumber – löscht die Telefonnummer des Benutzers.
• ModifyUserProfilePicture – ändert den Avatar des Benutzers.
• RemoveProfilePicture – löscht den Avatar des Benutzers.

Das Freundschaftssystem ermöglicht es Ihren Benutzern, nach anderen zu suchen und soziale Kontakte zu knüpfen. Das SDK unterstützt die folgenden Funktionen:

• Nach Nickname suchen
• Liste der Freunde aus sozialen Netzwerken abrufen
• Freundesliste verwalten, Einladungen versenden, Freunde hinzufügen und entfernen, Benutzer blockieren usw.
• Persönliche Daten über das Benutzerkonto verwalten

Um das Freundschaftssystem zu implementieren, sollte Ihre Anwendung eine Benutzerkontofunktionalität aufweisen. Methoden für die Arbeit mit diesem System verwenden die folgenden Parameter aus dem Benutzerkonto:

• Benutzer-ID
• Avatar
• Nickname

Benutzer sollten ihren Nickname angeben, damit das Freundschaftssystem ordnungsgemäß funktioniert. Implementieren Sie folgende Logik für die Angabe der Nicknames:

• Verwenden Sie den Namen, der während der Registrierung per Benutzername und Passwort verwendet wurde, als Nickname.
• Implementieren Sie die Abfrage des Nicknames während der Authentifizierung über soziale Netzwerke oder Plattformkonten.

SDK-Methoden

Die Login & Account System-Plug-in verfügt über folgende Methoden für die Arbeit mit dem Freundschaftssystem:

• UpdateFriends – aktualisiert die lokal zwischengespeicherten Freundschaftsdaten des Benutzers.

• ModifyFriends – aktualisiert den Status des sozialen Kontaktes des Benutzers. Der Status des sozialen Kontakts wird durch folgende Aktionen beeinflusst:
  • Senden oder Zurückziehen einer Freundschaftsanfrage
  • Akzeptieren oder Ablehnen einer Freundschaftsanfrage
  • Löschen des Benutzers von der Freundesliste
  • Blockieren des Benutzers bzw. Aufheben der Blockierung

• UpdateSocialFriends – aktualisiert die lokal zwischengespeicherten Freundschaftsdaten des Benutzers aus einem sozialen Netzwerk.

• GetUserProfile – ruft die Daten aus dem öffentlichen Profil des Benutzers ab.

• SearchUsersByNickname – sucht nach dem Benutzer anhand des Nicknames.

• LinkSocialNetworkToUserAccount – verknüpft das Benutzerkonto mit einem sozialen Netzwerk, das der Spieler für die Authentifizierung verwendet.

• UpdateLinkedSocialNetworks – aktualisiert die Social-Media-Daten des Benutzers.

Implementieren eines Freundschaftssystems für soziale Netzwerke

Damit Benutzer in Ihrer Anwendung mit Freunden aus sozialen Netzwerken interagieren können, konfigurieren Sie die Speicherung von Freundesdaten aufseiten von Xsolla:

1. Wechseln Sie ins Kundenportal.
2. Klicken Sie im Block Login auf Öffnen, und navigieren Sie zu Login-Projekte.
3. Klicken Sie dort auf Öffnen und einrichten.
4. Navigieren Sie zu Allgemeine Einstellungen > Authentifizierung.
5. Stellen Sie den Umschalter Freunde aus sozialen Netzwerken speichern auf Ein.
6. Speichern Sie die Änderungen.

Implementieren Sie die folgende Logik in Ihre Anwendung, um dem Spieler in der Anwendung Freunde aus dem sozialen Netzwerk anzuzeigen:

1. Verknüpfen Sie ein soziales Netzwerk mit dem Konto eines Spielers mithilfe der Methode LinkSocialNetworkToUserAccount.
2. Aktualisieren Sie die Freundesliste mithilfe der Methode UpdateUsersFriends.
3. Rufen Sie eine Liste der Freunde aus einem verknüpften sozialen Netzwerk mithilfe der Methode UpdateSocialFriends ab.