Используйте 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 для текущего авторизованного игрока, поскольку он будет соответствовать идентификатору, который видят другие игроки.
Если расширенный список друзей не сохраняется (а используется только во время просмотра), то никаких дополнительных действий не требуется.
Предоставьте доступ к играм Grant Play Games
Если в вашей игре еще нет доступа к Play Games, подходящий момент для запроса согласия пользователей — это когда они просматривают список ваших друзей в игре. Например, вы можете добавить кнопку « Импортировать друзей из Play Games» , которая при нажатии запрашивает согласие пользователя. (Обязательно используйте логотип Play Games на любой кнопке, упоминающей этот сервис.)
Просмотреть профиль другого игрока
Вы можете разрешить авторизованному игроку просматривать профиль другого игрока в разделе «Играть в игры». Это позволит авторизованному игроку увидеть имя, которое он дал другому игроку, и узнать, являются ли они уже друзьями, что даст ему дополнительную информацию об отношениях. Если игроки еще не являются друзьями, авторизованный игрок увидит элементы управления дружбой в своем профиле. При создании дружбы внутри игры имена по умолчанию для двух игроков — это их внутриигровые имена (если указаны). Также отображается название игры, в которой была установлена дружба.
Социальные таблицы лидеров
API друзей также можно использовать для таблиц лидеров. Используйте эту функцию, чтобы отображать рейтинг текущего игрока среди его друзей в Play Games. Обратите внимание, что это применимо только к пользователям, которые решили поделиться этой информацией с вашим приложением, и если эти пользователи являются друзьями в Play Games. Для поддержки этой функции игра предоставляет пользователю элемент управления. Этот элемент управления использует аргумент collection для выбора социального отображения таблицы лидеров. Чтобы узнать больше, см. раздел о публичных и социальных таблицах лидеров .
Если вы используете коллекцию социальных таблиц лидеров, вызов для загрузки результатов таблицы лидеров может вернуть исключение, требующее подтверждения согласия, аналогичное исключению, возникающему при вызове метода loadFriends() . Если вы используете стандартный пользовательский интерфейс Play Games (например, getLeaderboardIntent() ), то эта проблема будет решена автоматически.
Следующие шаги
Прежде чем начать использовать API друзей, выполните следующие действия:
- Скачайте и просмотрите пример кода:
- Java
- Пример приложения Unity, использующего плагин Unity.
- Ознакомьтесь с рекомендациями, описанными в Контрольном списке качества .
- Реализуйте API друзей в Java-клиенте .