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

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

1. Перейдите на Панель разработчика Meta Horizon⁠.
2. Выберите свое приложение.
3. В левой области навигации нажмите Взаимодействие >. Таблицы лидеров.
4. Выберите Создать таблицу лидеров и введите следующую информацию:
   • Имя API — это уникальная строка, которая позволит вам ссылаться на эту таблицу лидеров в коде приложения. В имени API учитывается регистр. Имя, которое вы определяете на панели, должно точно соответствовать имени, на которое вы ссылаетесь в коде.
   • Создайте локализации для своего заголовка с помощью раскрывающегося меню Язык. Вам нужно ввести локализованную строку для каждого выбранного языка.
   • Введите заголовок для своей таблицы лидеров, который будет отображаться для всех.
   • Порядок сортировки — существует два варианта сортировки в зависимости от сценария использования:
     • Чем выше, тем лучше — пользователи ранжируются в порядке убывания, от самого высокого до самого низкого балла.
     • Чем ниже, тем лучше — пользователи ранжируются в порядке возрастания, от самого низкого до самого высокого балла.
   • Выберите Правила создания записей, чтобы определить, как можно отправлять записи.
     • Авторитет клиента — записи могут подаваться с клиента или сервера. Это позволяет обновлять данные с указанием маркера доступа на стороне клиента, и обновления можно выполнять с помощью запроса POST.
     • Авторитет сервера — записи могут отправляться только с сервера. Это более безопасный метод, поскольку для обновления записей используется маркер доступа приложения.
   • Выберите Тип балла, чтобы определить, как будут отображаться баллы в таблице лидеров. Для этого берется необработанный балл и форматируется следующим образом (в качестве примера используется число 1 000).
     • Расстояние в футах — 1 000 футов
     • Расстояние в метрах — 1 000 м
     • Процент — 1 000 %
     • Очки — 1 000
     • Время в миллисекундах — 00:00:01.000
     • Время в секундах — 00:16:40 с
   • Наконец, чтобы включить социальные функции для таблицы лидеров, воспользуйтесь ползунками. Вы можете:
   • Добавить Место назначения глубокой ссылки. Это означает, что, когда пользователь нажимает таблицу лидеров, он попадает в указанное вами место назначения в приложении. Подробнее о местах назначения см. в статьях Места назначения и Групповое присутствие.
   • Выбрать, чтобы таблица лидеров была ориентирована на пользователя, т. е. пользователь, владеющий приложением, мог видеть свой рейтинг в таблице лидеров в приложении Meta Quest.
   • Если таблица лидеров ориентирована на пользователя, вы также можете включить уведомления Друг опередил вас. Это означает, что Meta Quest отправляет пользователю уведомления о том, что друг превысил его балл.
5. Закончив настройку, выберите Отправить, чтобы сохранить таблицу лидеров.
   Вы можете обновить настройки таблицы лидеров в любое время на панели разработчика. Также можно очистить результаты в таблице лидеров и сбросить баллы.

• Задайте удобный для пользователя заголовок таблицы лидеров в дополнение к названию API.
• Чтобы охватить более широкий рынок, предоставьте перевод вашего отображаемого заголовка.
• Убедитесь, что ваша таблица лидеров общедоступна. Для этого включите переключатель на странице таблицы лидеров, если вы хотите, чтобы гарнитура Meta Quest предоставляла уведомления и социальные истории для этой таблицы лидеров.
• Создайте место назначения для таблицы лидеров и свяжите его со своей таблицей лидеров. Если вы укажете место назначения, то сможете сделать глубокую ссылку на нужный уровень приложения, чтобы пользователи могли перейти к игре и попытаться превзойти результат друга в таблице лидеров, который они только что увидели на уровне платформы.

• Выберите Meta Horizon Developer Dashboard (Панель разработчика Meta Horizon)⁠> [ваше приложение] > Development (Разработка) на левой панели > All Platform Services (все сервисы платформы) > Leaderboards (Таблицы лидеров).
• Нажмите на многоточие (…) справа от таблицы лидеров, которую вы хотите отредактировать, и выберите Edit/View Entries (Отредактировать/Посмотреть заявки).
• Внесите необходимые изменения, например добавьте языки и локализованные заголовки или включите социальные функции.
• Нажмите Отправить, чтобы сохранить изменения.

• Получение и отображение таблиц лидеров — отображение текущего состояния таблиц лидеров перед началом игры. Для нативного приложения используйте ovr_Leaderboard_GetEntries(). Существуют и другие методы, которые можно использовать для получения подмножества записей в таблице лидеров на основе входных критериев.
• Обновление записей в таблице лидеров — запись результатов текущей игры в свою таблицу лидеров. Для нативного приложения используйте ovr_Leaderboard_WriteEntry(). Пользователь может иметь только одну запись в каждой таблице лидеров. Последующие записи будут заменять существующую запись в указанной таблице лидеров.

• Чтобы получить записи в таблице лидеров так, чтобы текущий пользователь был в центре, используйте перечисление LeaderboardStartAt, чтобы определить, где начинаются возвращаемые значения или какие находятся в центре. Чтобы получить данные только о текущем пользователе, поместите в центр того, кто просматривает таблицу лидеров, и ограничьте количество возвращаемых результатов до 1.
• Чтобы вернуть только друзей пользователя, можно определить возвращаемые результаты в перечислении LeaderboardFilterType.