SDK для Android / Управление пользователями
 На главную

SDK для Android

  • Библиотека Login

  • Библиотека Store

  • Библиотека Inventory

  • Библиотека Payments

  • Библиотека Subscriptions

  • Инструкции

  • Управление пользователями

    Узнайте о дополнительных настройках из наших инструкций.
    Notice
    Используйте эту инструкцию для работы с библиотекой Login.

    Как работать с атрибутами пользователя

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

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

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

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

    • XLogin.getUsersAttributesFromClient — возвращает перечень атрибутов конкретного пользователя.
    • XLogin.updateUsersAttributesFromClient — обновляет и создает атрибуты конкретного пользователя.

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

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

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

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Скрыть

    Как работать с личным кабинетом пользователя в вашем приложении

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

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

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

    Note
    В личном кабинете пользователя можно добавить управление списком друзей, если для приложения реализована система друзей.

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

    • XLogin.getCurrentUserDetails — получает данные пользователя.
    • XLogin.updateCurrentUserDetails — обновляет данные пользователя.

    Note
    Дата рождения пользователя указывается только один раз и впоследствии недоступна для изменения.

    • XLogin.getCurrentUserEmail — изменяет указанные данные пользователя.
    • XLogin.getCurrentUserPhone — обновляет локально кешированный email-адрес пользователя.
    • XLogin.updateCurrentUserPhone — изменяет номер телефона пользователя.
    • XLogin.deleteCurrentUserPhone — удаляет номер телефона пользователя.
    • XLogin.uploadCurrentUserAvatar — изменяет аватар пользователя.
    • XLogin.deleteCurrentUserAvatar — удаляет аватар пользователя.

    Примеры вызова методов приведены в демопроекте.

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Скрыть

    Как работать с системой друзей в вашем приложении

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

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

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

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

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

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

    Методы SDK

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

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

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

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

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

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

    • XLogin.startSocialAccountLinking — генерирует Intent для открытия окна авторизации в социальной сети для привязки аккаунта к учетной записи пользователя.

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

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

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

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

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

    1. Привяжите социальную сеть к учетной записи игрока с помощью метода XLogin.createSocialAccountLinkingIntent.

    Пример:

    Copy
    Full screen
    Small screen
    startActivityForResult(
             XLogin.createSocialAccountLinkingIntent(context, socialNetwork),
             RC_LINKING
     )

    1. Обновите список друзей с помощью метода XLogin.updateSocialFriends.
    2. Получите список друзей из привязанной социальной сети с помощью метода XLogin.getSocialFriends.

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Скрыть
    Последнее обновление: 17 июня 2021

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

    Сообщите о проблеме
    Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
    Укажите email-адрес, чтобы мы могли связаться с вами
    Спасибо за обратную связь!