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:

• GetUserAttributes – ruft eine Liste der Benutzerattribute ab. Der API-Aufruf Get user’s attributes from client wird gemeinsam mit der SDK-Methode genutzt.
• UpdateUserAttributes – aktualisiert die Werte von Benutzerattributen. Der API-Aufruf Update user’s attributes from client wird gemeinsam mit der SDK-Methode genutzt.
• RemoveUserAttributes – entfernt Benutzerattribute mit den angegebenen IDs, Änderungen werden aufseiten des Servers vorgenommen. Der API-Aufruf Update user’s attributes from client wird gemeinsam mit der SDK-Methode genutzt.

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-Asset sind folgende Methoden implementiert:

• GetUserInfo – aktualisiert die lokal zwischengespeicherten Benutzerdaten.

• UpdateUserInfo – ändert die angegebenen Daten des Benutzers.
• GetUserPhoneNumber – aktualisiert die lokal zwischengespeicherte Telefonnummer des Benutzers.
• ChangeUserPhoneNumber – ändert die Telefonnummer des Benutzers.
• DeleteUserPhoneNumber – löscht die Telefonnummer des Benutzers.
• UploadUserPicture – ändert den Avatar des Benutzers.
• DeleteProfilePicture – 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

Das Login & Account System-Asset verfügt über folgende Methoden für die Arbeit mit dem Freundschaftssystem:

• GetUserFriends – aktualisiert die lokal zwischengespeicherten Daten der Freunde des Benutzers. Der API-Aufruf Get user’s friends wird gemeinsam mit der SDK-Methode genutzt.

• UpdateUserFriends – aktualisiert den Status des sozialen Kontaktes des Benutzers. Der API-Aufruf Update user’s friends wird gemeinsam mit der SDK-Methode genutzt. 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

• GetUserSocialFriends – aktualisiert die lokal zwischengespeicherten Daten der Freunde des Benutzers aus einem sozialen Netzwerk. Der API-Aufruf Get social account friends wird gemeinsam mit der SDK-Methode genutzt.

• GetPublicInfo – ruft die Daten aus dem öffentlichen Profil des Benutzers ab. Der API-Aufruf Get user public profile wird gemeinsam mit der SDK-Methode genutzt.

• SearchUsers – sucht nach dem Benutzer anhand des Nicknames. Der API-Aufruf Search users by nickname wird gemeinsam mit der SDK-Methode genutzt.

• LinkSocialProvider – verknüpft das Benutzerkonto mit einem sozialen Netzwerk, das der Spieler für die Authentifizierung nutzt. Der API-Aufruf Link social network to user’s account wird gemeinsam mit der SDK-Methode genutzt.

• GetLinkedSocialProviders – aktualisiert die Daten der sozialen Netzwerke des Benutzers. Der API-Aufruf Get linked networks wird gemeinsam mit der SDK-Methode genutzt.

• GetSocialNetworkAuthUrl – ruft die URL für das Verknüpfen des sozialen Netzwerks mit dem Konto des Spielers ab. Der API-Aufruf Get URL to link social network to account wird gemeinsam mit der SDK-Methode genutzt.

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 GetSocialNetworkAuthUrl. Der API-Aufruf Get URL to link social network to account wird gemeinsam mit der SDK-Methode genutzt.
2. Aktualisieren Sie die Freundesliste mithilfe der Methode UpdateUserSocialFriends. Der API-Aufruf Update social account friends wird gemeinsam mit der SDK-Methode genutzt.
3. Rufen Sie eine Liste der Freunde aus einem verknüpften sozialen Netzwerk mithilfe der Methode GetUserSocialFriends ab. Der API-Aufruf Get social account friends wird gemeinsam mit der SDK-Methode genutzt.