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

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

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

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

• GetUserAttributes — возвращает перечень атрибутов пользователя. При этом используется метод API Get user’s attributes from client.
• UpdateUserAttributes — обновляет значения атрибутов пользователя. При этом используется метод API Update user’s attributes from client.
• RemoveUserAttributes — удаляет атрибуты пользователя с указанными идентификаторами. При этом используется метод API Update user’s attributes from client.

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

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

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

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

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

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

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

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

• UpdateUserInfo — изменяет указанные данные пользователя.
• GetUserPhoneNumber — обновляет локально кешированный email-адрес пользователя.
• ChangeUserPhoneNumber — изменяет номер телефона пользователя.
• DeleteUserPhoneNumber — удаляет номер телефона пользователя.
• UploadUserPicture — изменяет аватар пользователя.
• DeleteProfilePicture — удаляет аватар пользователя.

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

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

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

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

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

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

Методы SDK

В Login Unity SDK для работы с системой друзей реализованы следующие методы:

• GetUserFriends — обновляет локально кешированные данные о друзьях пользователя. При этом используется метод API Get user’s friends.

• UpdateUserFriends — обновляет статус социальных связей пользователя. При этом используется метод API Update user’s friends. К изменению социальных связей приводят следующие действия:
  • отправка/отзыв запроса на добавление в друзья;
  • принятие/отклонение запроса на добавление в друзья;
  • удаление пользователя из списка друзей;
  • блокировка/разблокировка пользователя.

• GetUserSocialFriends — обновляет локально кешированные данные друзей пользователя из социальной сети. При этом используется метод API Get social account friends.

• GetPublicInfo — получает информацию из публичного профиля пользователя. При этом используется метод API Get user public profile.

• SearchUsers — осуществляет поиск пользователя по никнейму. При этом используется метод API Search users by nickname.

• LinkSocialProvider — связывает учетную запись пользователя и социальную сеть, которую игрок использует для авторизации. При этом используется метод API Link social network to user’s account.

• GetLinkedSocialProviders — обновляет данные о социальных сетях пользователя. При этом используется метод API Get linked networks.

• GetSocialNetworkAuthUrl — получает URL-адрес для привязки социальной сети к учетной записи игрока. При этом используется метод API Get URL to link social network to account.

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

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

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

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

1. Привяжите социальную сеть к учетной записи игрока с помощью метода GetSocialNetworkAuthUrl. При этом используется метод API Get URL to link social network to account.
2. Обновите список друзей с помощью метода UpdateUserSocialFriends. При этом используется метод API Update social account friends.
3. Получите список друзей из привязанной социальной сети с помощью метода GetUserSocialFriends. При этом используется метод API Get social account friends.