Достижения и Таблицы лидеров

Таблицы лидеров

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

В этом разделе объясняется, как создать таблицу лидеров для новой или существующей игры. Максимальный лимит составляет 20, и каждый идентификатор таблицы лидеров должен быть уникальным в пределах одной игры.

Чтобы создать таблицу лидеров для вашей игры, перейдите на страницу управления GameRank, соответствующую вашей игре, выберите Расширения > Добавить и нажмите кнопку Создать таблицу лидеров.

Затем просто заполните необходимую информацию для этой таблицы лидеров.

Формат очков

• Числовые таблицы лидеров отображают очки в виде чисел. Эти очки могут отображаться как целые числа или числа с плавающей запятой, например, 3.14159, 3141.59 или 314159; обратите внимание, что значения не должны быть чрезмерно большими, в настоящее время поддерживается только одинарная точность.
• Временные таблицы лидеров отображают очки в формате часы/минуты/секунды/сотые доли секунды или в традиционном формате часов (например, ЧЧ:ММ:СС), например, 66032, 1:06:3.
• Форматированные очки отображают очки с использованием пользовательского формата. Отправляйте очки с денежными единицами, такими как $19.95. Например, $19.95.

Рекомендации по фоновому изображению

Фоновое изображение для таблицы лидеров должно быть создано в виде JPEG-файла размером 1024 x 1024 пикселя. Это опционально; если изображение не загружено, будет использоваться изображение по умолчанию платформы. Одно и то же фоновое изображение используется для всех языковых локалей, поэтому мы рекомендуем избегать любого текста или локализованного контента внутри изображения.

Настройка таблиц лидеров

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

• Удалить: Удалить текущие отображаемые данные игрока из таблицы лидеров.
• Добавить в черный список: Впоследствии лишить игрока права участвовать во всех таблицах лидеров текущей игры. После добавления в черный список список учетных записей в черном списке можно просмотреть в разделе «Все таблицы лидеров», где вы также можете удалить учетную запись игрока из черного списка.
• Редактировать данные: Нажмите, чтобы открыть страницу редактирования таблицы лидеров.
• Удалить таблицу лидеров: Нажмите, чтобы удалить указанный список таблицы лидеров.

Поля отправки данных таблицы лидеров

Если данные игрока в игре соответствуют определенной таблице лидеров, вы можете вызвать интерфейс отправки данных таблицы лидеров, чтобы отправить соответствующие данные таблицы лидеров в серверную службу Jogos. Затем игрок может открыть окно таблицы лидеров на платформе Jogos, чтобы просмотреть таблицы лидеров игры и свой собственный рейтинг.

Примечание: Название таблицы лидеров и тип данных в параметрах интерфейса должны строго соответствовать названию и типу данных, определенным в Центре разработчика.

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

• Числовой счет: number
• Временной счет: time
• Форматированный счет: custom

Отправляемые данные представляют собой пару ключ-значение, где значение может быть только числом, строкой или датой. Это должно соответствовать формату данных, настроенному в Центре разработчика.

Интерфейс отправки данных таблицы лидеров

Интерфейс отправки данных таблицы лидеров: JOGOS_SDK.game.commitRankingData

/**
 * Отправить данные таблицы лидеров
 *
 * @param rankingName ID таблицы лидеров
 * @param data Данные таблицы лидеров
 */
await window.JOGOS_SDK.game.commitRankingData(rankingName: string, data: { [key: string]: any });

Интерфейс открытия интерфейса таблицы лидеров:

Интерфейс открытия интерфейса таблицы лидеров: JOGOS_SDK.game.openRankingDialog Если вы хотите отобразить определенную таблицу лидеров (а не все таблицы лидеров), вы можете передать имя таблицы лидеров этому методу (оно должно совпадать с именем, созданным в серверной части разработчика);

/**
 * Открыть окно таблицы лидеров
 *
 * @param rankingName Название таблицы лидеров
 */
await window.JOGOS_SDK.game.openRankingDialog(rankingName: string);

Интеграция достижений

Если игрок достигает определенной цели, вы можете вызвать интерфейс отправки данных достижений игрока, чтобы отправить соответствующие данные в серверную службу Jogos. Затем игрок может открыть окно достижений игрока на платформе Jogos, чтобы просмотреть разблокированные достижения.

Примечание: Название достижения в параметрах интерфейса — это имя, определенное в Центре разработчика, и должно точно совпадать.

Для достижений, которые НЕ являются поэтапными (основанными на шагах):

• Отчет требуется только тогда, когда достижение фактически разблокировано (т.е. достижение не показывает прогресс; отчет подразумевает, что достижение разблокировано).
• Если достижение настроено как поэтапное (основанное на шагах): Прогресс progress должен соответствовать идентификатору шага, о котором сообщается. Например, сообщите progress = 2 после завершения шага 2.

Создание достижений

В серверной части разработчика, в сервисе GameService — на странице Достижения, выберите Создать достижение. На странице Добавить достижение заполните форму.

Каждое достижение имеет следующие связанные основные элементы:

• ID достижения: Поддерживает буквенно-цифровые комбинации. Используется для сопоставления отчетов игроков в игре и отображения достижения на веб-сайте. Это значение должно быть уникальным для одной игры.
• Название: Название достижения (например, «Pieman»).
• Условие разблокировки: Описание того, как разблокировать достижение. Обычно это значение сообщает игроку, как его достичь.
• Иконка: Квадратная иконка, связанная с вашим достижением. Вам нужно загрузить заблокированное и разблокированное изображения.
• Тип достижения (Achievement Types), поддерживает 3 типа, единичный выбор. Достижения отображаются в отдельных списках на фронтенде в соответствии с их порядком типов:
  • Достижения для начинающих (Beginner's Exploration Achievements), можно создать до 900.
  • Промежуточные испытательные достижения (Intermediate Challenge Achievements), можно создать до 50.
  • Продвинутые достижения славы (Advanced Glory Achievements), можно создать до 10.

Статус: Достижение может находиться в одном из трех различных состояний:

• Скрытые достижения означают, что details достижения будут скрыты от игрока. Службы игр Jogos предоставят общее описание-заполнитель и значок для достижений в скрытом состоянии. Мы рекомендуем установить достижение как скрытое, если оно содержит спойлеры игры, которые вы не хотите раскрывать prematurely (например, «Discover that you were a ghost all along!»).
• Раскрытые достижения указывают, что игрок знает о достижении, но еще не разблокировал его. Большинство достижений изначально находятся в раскрытом состоянии.
• Разблокированные достижения указывают, что игрок успешно достиг цели. Игроки могут разблокировать достижения в автономном режиме. Когда игра будет в сети, она синхронизируется со Службами игр Jogos для обновления статуса разблокировки достижений.

Поэтапные достижения

• Достижение можно обозначить как стандартное или поэтапное. Обычно поэтапное достижение — это то, над которым игрок работает для завершения в течение более длительного периода времени. По мере того как игрок прогрессирует в поэтапном достижении, вы можете сообщать о завершенном прогрессе в Службы игр Jogos.
• Службы Jogos отслеживают информацию о прогрессе, уведомляют игру, когда игрок удовлетворяет условиям, необходимым для разблокировки достижения, и сообщают игроку, насколько он близок к достижению цели.

Рекомендации по иконкам

Иконки должны быть созданы в виде файлов PNG, JPEG или JPG размером 512 x 512 пикселей. Вам нужно предоставить нам только иконку для разблокированного достижения. Мы рекомендуем включать цветные элементы в ваши иконки достижений, чтобы пользователи могли distinguish между отображаемыми и разблокированными достижениями. Одна и та же иконка используется для всех языковых локалей, поэтому мы рекомендуем избегать любого текста или локализованного контента внутри иконки.

Интерфейс отчетности достижений

/**
 * Отправить данные достижений игрока
 *
 * @param name ID достижения
 * @param progress Прогресс завершения
 * @param hidden Скрытый флаг
 */
await window.JOGOS_SDK.game.commitAchievementsData(name: string, progress: number, hidden: boolean);

Интерфейс открытия интерфейса достижений:

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

// Открыть окно достижений игрока
await window.JOGOS_SDK.game.openAchievementsDialog();