Вы можете использовать атрибуты для управления дополнительной информацией о пользователях вашего приложения. Атрибут пользователя представляет собой пару ключ-значение. SDK поддерживает следующие типы атрибутов:

• Клиентские атрибуты. Значения для таких атрибутов вводятся пользователем или задаются согласно внутриигровой логике в клиентской части вашего приложения. Примеры: имя и параметры внешнего вида игрового персонажа, уровень сложности игры.

• Серверные атрибуты. Значения для таких атрибутов задаются и редактируются только на серверной части вашего приложения. Серверные атрибуты рекомендуется использовать для управления характеристиками игрового персонажа или параметрами пользователя, которые важно защитить от лишних изменений. Примеры: шанс выпадения бонуса, ключевые параметры игрового персонажа, категория пользователя.

Управление атрибутами пользователя осуществляется с помощью следующих методов SDK:

• UpdateUserAttributes — обновляет кешированный локально перечень серверных атрибутов.
• UpdateUserReadOnlyAttributes — обновляет кешированный локально перечень клиентских атрибутов.
• ModifyUserAttributes — создает или редактирует перечень атрибутов пользователя, изменения вносятся на стороне сервера.
• RemoveUserAttributes — удаляет атрибуты пользователя с указанными идентификаторами, изменения вносятся на стороне сервера.

При работе с серверными атрибутами можно использовать для авторизации серверный токен или токен Личного кабинета.

Для получения токена Личного кабинета:

1. Авторизуйтесь в Личном кабинете.
2. Перейдите к просмотру файлов cookie с помощью инструментов разработчика в используемом браузере.
3. Скопируйте значение из параметра pa-v4-token в заголовок Authorization.

Личный кабинет позволяет пользователям вашего приложения управлять следующими данными:

• данные публичного профиля:
  • аватар;
  • никнейм;

• личные данные пользователя:
  • имя и фамилия;
  • дата рождения;
  • пол;
  • номер телефона;
  • email-адрес.

Управление личным кабинетом пользователя осуществляется с помощью методов API. В плагине Login & Account System реализованы следующие методы:

• UpdateUserDetails — обновляет локально кешированные данные пользователя.

• ModifyUserDetails — изменяет указанные данные пользователя.
• UpdateUserEmail — обновляет локально кешированный email-адрес пользователя.
• UpdateUserPhoneNumber — обновляет локально кешированный номер телефона пользователя.
• ModifyUserPhoneNumber — изменяет номер телефона пользователя.
• RemoveUserPhoneNumber — удаляет номер телефона пользователя.
• ModifyUserProfilePicture — изменяет аватар пользователя.
• RemoveProfilePicture — удаляет аватар пользователя.

Система друзей дает возможность пользователям вашего приложения легко находить друг друга и устанавливать социальные связи. С помощью SDK можно реализовать следующие функции:

• поиск друзей по никнейму;
• получение списка друзей из социальных сетей;
• управление списком друзей: отправка приглашений, добавление и удаление из друзей, блокировка пользователей и т. д.;
• управление личными данными через личный кабинет пользователя.

Для реализации системы друзей в приложении должна быть добавлена функциональность личного кабинета пользователя. Методы работы с системой друзей используют следующие параметры из личного кабинета:

• идентификатор пользователя;
• аватар;
• никнейм.

Для корректной работы системы друзей у пользователя должен быть указан никнейм. Рекомендуется реализовать следующую логику задания никнейма:

• В качестве никнейма указывать имя пользователя, введенное при регистрации по логину и паролю.
• Реализовать запрос никнейма при авторизации через социальные сети или с помощью платформенных аккаунтов.

Методы SDK

В плагине Login & Account System для работы с системой друзей реализованы следующие методы:

• UpdateFriends — обновляет локально кешированные данные о друзьях пользователя.

• ModifyFriends — обновляет статус социальных связей пользователя. К изменению социальных связей приводят следующие действия:
  • отправка/отзыв запроса на добавление в друзья;
  • принятие/отклонение запроса на добавление в друзья;
  • удаление пользователя из списка друзей;
  • блокировка/разблокировка пользователя.

• UpdateSocialFriends — обновляет локально кешированные данные друзей пользователя из социальной сети.

• GetUserProfile — получает информацию из публичного профиля пользователя.

• SearchUsersByNickname — осуществляет поиск пользователя по никнейму.

• LinkSocialNetworkToUserAccount — связывает учетную запись пользователя и социальную сеть, которую игрок использует для авторизации.

• UpdateLinkedSocialNetworks — обновляет данные о социальных сетях пользователя.

Реализация системы друзей для социальных сетей

Чтобы пользователи могли взаимодействовать с друзьями из социальных сетей в вашем приложении, настройте хранение данных о друзьях на стороне Иксоллы:

1. Перейдите к вашему проекту в Личном кабинете.
2. Нажмите Открыть в разделе Авторизация и перейдите на вкладку Варианты авторизации.
3. Нажмите Открыть и настроить в области с вариантом авторизации.
4. Перейдите в Общие настройки > Настройки аутентификации.
5. Установите переключатель Хранение друзей из социальных сетей в положение Вкл.
6. Сохраните изменения.

Чтобы в приложении игроку стали доступны друзья из социальной сети, реализуйте следующую логику в своем приложении:

1. Привяжите социальную сеть к учетной записи игрока с помощью метода LinkSocialNetworkToUserAccount.
2. Обновите список друзей с помощью метода UpdateUsersFriends.
3. Получите список друзей из привязанной социальной сети с помощью метода UpdateSocialFriends.