For the complete documentation index, see llms.txt. This page is also available as Markdown.

Товары в игре

Расходуемые предметы и игровые пропуски создаются похожим образом, но имеют немного разные сценарии использования!

Типы продуктов

Игровые пропуски

Используйте игровые пропуски для постоянных одноразовых покупок:

  • Разблокировка админ-пропусков

  • Постоянные усиления/способности

  • Покупка домов

Расходуемые товары

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

  • Зелья здоровья

  • Баффы, которые истекают со временем

  • Одноразовые покупки внутриигровой валюты

Создание продуктов

Add Product form in the Monetization tab
Чтобы создать продукт, нажмите кнопку "+ Add Product" на вкладке Monetization в Creator Portal вашей игры
Product form with the consumable option clear
Если флажок расходуемого предмета не установлен, это будет «Game Pass»

Понимание списка продуктов

Products list with sales, revenue estimate, ID, and grant failures

Список продуктов отображает названия всех ваших продуктов вместе с несколькими полезными сведениями:

  • Количество потраченных искр (а также общее число продаж при наведении на значок ?)

  • Примерная оценка суммы дохода, которую каждый из них принёс

  • ID продукта (можно нажать, чтобы скопировать в место в коде вашей игры для покупки)

  • Количество «сбоев при выдаче»

Обработчики покупок / Сбои при выдаче

Когда пользователь покупает продукт в вашей игре, мы запускаем ao_purchase_handler функцию, которую вы определили в коде своей игры.

Ваш обработчик покупок обычно выдаёт игроку предмет или функцию в зависимости от того, какой ID продукта он купил. Верните true только после успешной выдачи.

Если ваш обработчик покупок не сработает — например, если инвентарь был полон и вы не обработали этот сценарий, — верните false. Это будет считаться «сбоем при выдаче» и будет отображаться на странице Products в Creator Portal, чтобы вы могли исправить проблему.

Сбои при выдаче будут автоматически повторяться каждый раз, когда игрок присоединяется, пока они не будут успешными. Обработчики должны быть безопасны для повторного запуска и не должны частично выдавать награду перед возвратом false.

Если ваш обработчик покупок сработал успешно, но по какой-то причине пользователь потерял предмет из-за ошибки игры или по другой причине, вы можете повторно запустить обработчик покупок для этого пользователя, отметив покупку как невыданную в Редактирование/просмотр данных игрока разделе «Purchases». Сначала убедитесь, что повторный запуск обработчика не приведёт к дублированию награды.

Последнее обновление