Используйте API друзей, чтобы дополнить и улучшить существующую внутриигровую систему друзей и другие социальные системы, к которым может иметь доступ ваша игра. Это позволит игрокам:
Найдите их друзей в своей игре.
Сравните результаты с результатами друзей в таблицах лидеров.
Объедините список друзей в Play Games с существующими списками друзей в игре.
Идентифицируйте другого игрока с помощью всплывающего окна профиля в игре. В этом окне отображается никнейм, который текущий игрок дал своему другу, чтобы тот знал, с кем играет.
Основы
Эти API позволяют выполнять следующие действия:
- Загрузить друзей : вы можете проверить, разрешил ли игрок игре доступ к информации из списка друзей. Если доступ разрешён, вы можете получить список объектов Player, соответствующих друзьям аутентифицированного игрока.
- Откройте профиль другого игрока в Play Games : вы можете открыть этот профиль, чтобы увидеть имя, данное другому игроку аутентифицированным игроком. Этот профиль также позволяет управлять дружбой и не выводит игрока из игры.
- Предоставьте пользователю контроль : пользователь может управлять тем, как его профиль в Play Games отображается для друзей и как его список друзей отображается для игр. Для доступа к списку друзей пользователь может выбрать автоматическое предоставление доступа ко всем играм или индивидуальное разрешение доступа для каждой игры. Следовательно, при загрузке списка друзей может быть выполнен обратный вызов для отображения запроса на доступ.
Импорт списка друзей Play Games
Вы можете использовать API друзей, чтобы получить список друзей ваших игроков в Play Games и добавить их в свой игровой список друзей.
Новые пользователи получат стартовый список друзей для игры, а существующие пользователи смогут импортировать своих друзей из Play Games в любые игровые списки друзей. В результате ваши пользователи получат максимально возможный набор игроков, с которыми можно играть или с которыми можно соревноваться.
Добавьте друзей из Play Games в свою игру
Добавьте друзей из Play Games в любой существующий список друзей в игре, связав их идентификаторы Play Games с информацией об игроках во внутренней базе данных. Убедитесь, что рядом с этими друзьями есть кнопка со значком Play Games, при нажатии на которую отображается профиль другого игрока, чтобы ваши пользователи могли узнать, кто эти друзья.
При использовании списка друзей с внутреннего сервера загружайте его безопасно через REST API, а не передавайте результат через Android API. Обязательно используйте идентификатор игрока, возвращаемый методом players.get(me) в REST API для текущего аутентифицированного игрока, так как он будет соответствовать идентификатору, который видят другие игроки.
Если расширенный список друзей не сохраняется (а просто используется во время просмотра), то никаких дополнительных действий не требуется.
Предоставить доступ к Play Games
Если в вашей игре ещё нет доступа к Play Games, хорошим моментом для запроса согласия пользователей будет просмотр ими списка друзей в игре. Например, можно добавить кнопку « Импорт друзей из Play Games» , которая запрашивает согласие пользователя при нажатии. (Обязательно используйте логотип Play Games на всех кнопках с упоминанием сервиса.)
Посмотреть профиль другого игрока
Вы можете разрешить вашему аутентифицированному игроку просматривать профиль другого игрока в Play Games. Это позволит аутентифицированному игроку видеть имя, которое он дал другому игроку, и видеть, являются ли они уже друзьями, что даёт ему дополнительную информацию об отношениях. Если игроки ещё не дружат, аутентифицированный игрок увидит элементы управления дружбой в профиле. При создании дружеских отношений в игре, по умолчанию для двух игроков используются их игровые имена (если они указаны). Также отображается название игры, в которой была установлена дружба.
Социальные таблицы лидеров
API друзей также можно использовать для таблиц лидеров. Используйте эту функцию, чтобы отобразить рейтинг текущего игрока среди его друзей в Play Games. Обратите внимание, что это применимо только к пользователям, которые решили поделиться этой информацией с вашим приложением, и если пользователи являются друзьями в Play Games. Для поддержки этой функции игра предоставляет пользователю элемент управления. Этот элемент управления использует аргумент collection для выбора социального представления таблицы лидеров. Подробнее см. в разделе о публичных и социальных таблицах лидеров .
Если вы реализуете коллекцию социальных таблиц лидеров, вызов загрузки результатов таблицы лидеров может вернуть исключение, требующее согласия, аналогичное исключению loadFriends() . Если вы реализуете стандартный пользовательский интерфейс Play Games (например, getLeaderboardIntent() ), то это будет обработано автоматически.
Следующие шаги
Прежде чем начать использовать API друзей, выполните следующие действия:
- Загрузите и просмотрите пример кода:
- Ява
- Пример приложения Unity, использующего плагин Unity
- Ознакомьтесь с рекомендациями, описанными в Контрольном списке качества .
- Реализуйте API-интерфейсы Friends в клиенте Java .