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