Друзья

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

  • Найдите своих друзей в своей игре.

  • Сравните результаты со своими друзьями в таблицах лидеров.

  • Объедините список своих друзей в Play Играх с существующими списками друзей в игре.

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

Импортировать друзей

Основы

Эти API позволяют выполнять следующие действия:

  • Загрузить друзей : вы можете проверить, разрешил ли игрок игре доступ к информации списка друзей. Если доступ предоставлен, вы можете получить список объектов Player, соответствующих друзьям вошедшего в систему игрока.
  • Запустить просмотр профиля Play Games другого игрока . Вы можете открыть это представление, чтобы отобразить имя, данное другому игроку вошедшим в систему игроком. Этот вид также предлагает элементы управления дружбой и не выводит игрока из игры.
  • Предоставить пользовательские элементы управления . Пользователь может управлять тем, как его профиль Play Games виден друзьям, а его список друзей виден играм. Для доступа к списку друзей пользователь может выбрать автоматическое предоставление доступа ко всем играм или индивидуальное одобрение доступа для каждой игры. Следовательно, при загрузке списка друзей результатом может быть обратный вызов для отображения запроса на доступ.

Импортировать список друзей Play Games

Вы можете использовать API друзей, чтобы получить список друзей ваших игроков в Play Играх и добавить их в свой список друзей в игре.

У новых пользователей будет стартовый список друзей, с которыми можно играть, а существующие пользователи смогут импортировать своих друзей из Play Games в любые списки друзей в игре. В результате у ваших пользователей будет максимально широкий набор игроков, с которыми они смогут играть или соревноваться.

Добавьте друзей из Play Games в свою игру

Добавьте друзей из Play Games в любой существующий список друзей в игре, связав их идентификатор Play Games с соответствующей информацией об игроке в вашей внутренней базе данных. Убедитесь, что рядом с этими друзьями есть кнопка со значком «Play Игры», которая при нажатии показывает профиль другого игрока, чтобы ваши пользователи могли знать, кто их друзья.

При использовании списка друзей с внутреннего сервера загружайте его безопасно с помощью REST API, а не передавайте результат API Android. Обязательно используйте идентификатор игрока, возвращаемый players.get(me) в REST API для игрока, выполнившего вход в систему, поскольку он будет соответствовать идентификатору, который видят другие игроки.

Если расширенный список друзей не сохраняется (а просто используется в момент просмотра), то никаких дополнительных действий не требуется.

Предоставить доступ к Play Играм

Если у вашей игры еще нет доступа к Play Играм, самое время попросить пользователей дать согласие, когда они просматривают ваш список друзей в игре. Например, вы можете добавить кнопку « Импортировать друзей из Play Игр» , которая запрашивает у пользователя согласие при нажатии. (Обязательно используйте логотип Play Games на любой кнопке, где упоминается эта услуга.

Посмотреть профиль другого игрока

Вы можете разрешить вошедшему в систему игроку просматривать профиль другого игрока в Play Играх. Это позволяет вошедшему в систему игроку видеть имя, которое он дал другому игроку, а также то, являются ли они уже друзьями, что дает им дополнительный контекст об отношениях. Если игроки еще не являются друзьями, вошедший в систему игрок увидит элементы управления дружбой в представлении профиля. Когда дружеские отношения создаются в игре, имена двух игроков по умолчанию — это их игровые имена (если вы их указали). Также отображается название игры, в которой началась дружба.

Посмотреть профиль другого игрока

Социальные таблицы лидеров

API друзей также можно использовать для таблиц лидеров. Используйте эту функцию, чтобы показать рейтинг текущего игрока среди его друзей в Play Games. Обратите внимание, что это относится только к пользователям, которые решили поделиться этой информацией с вашим приложением, и если эти пользователи являются друзьями в Play Играх. Для поддержки этой функции игра предоставляет пользователю элемент управления. Этот элемент управления использует аргумент collection для выбора социального представления таблицы лидеров. Дополнительную информацию см. в разделе об публичных и социальных таблицах лидеров .

Друзья в таблице лидеров

Если вы реализуете коллекцию социальных таблиц лидеров, вызов для загрузки результатов таблицы лидеров может возвращать исключение разрешения, требующее согласия, аналогичное тому, которое из loadFriends() . Если вы реализуете пользовательский интерфейс Play Games по умолчанию (например, getLeaderboardIntent() ), то это обрабатывается автоматически.

Следующие шаги

Прежде чем начать использовать API друзей, выполните следующие действия: