API для покупок/продуктов

Игроки могут покупать продукты (пропуска игры + расходуемые предметы) за Sparks в вашей игре. Когда происходит покупка, All Out вызывает ваш обработчик покупок чтобы вы могли выдать предмет или функцию.

Для создания продуктов и просмотра аналитики см. Товары в игре.

Типы продуктов (краткий обзор)

• Пропуска игры: разовые, постоянные разблокировки (админ-пропуск, постоянная способность, владение домом)

• Расходуемые предметы: можно покупать несколько раз (зелье, временное усиление, одноразовый пакет монет)

Типы продуктов настраиваются в портале создателя. См. Товары в игре.

Справочник по API покупок

Product :: struct {
    id: string;
    name: string;
    description: string;
    price: s64;
    consumable: bool;
    icon: Texture_Asset;
}

Purchasing :: struct {
    prompt_purchase :: proc(player: Player, id: string);
    owns_product    :: proc(player: Player, id: string) -> bool;
    get_product     :: proc(id: string) -> Product;
}

Инициация покупки

Чтобы начать процесс покупки, вызовите Purchasing.prompt_purchase с идентификатором продукта.

BUY_DOUBLE_JUMP_ID :: "prod_double_jump";

try_prompt_double_jump :: proc(player: Player) {
    Purchasing.prompt_purchase(player, BUY_DOUBLE_JUMP_ID);
}

Идентификатор продукта отображается на странице монетизации/продуктов в портале создателя (вы можете нажать, чтобы скопировать его). См. Товары в игре.

Проверка, владеет ли игрок продуктом (пропуска игры)

Для пропусков игры вы можете ограничивать игровые функции, проверяя владение.

ADMIN_PASS_ID :: "prod_admin";

is_admin :: proc(player: Player) -> bool {
    return Purchasing.owns_product(player, ADMIN_PASS_ID);
}

Расходуемые предметы можно покупать несколько раз, поэтому owns_product не следует использовать для их выдачи. Расходуемые предметы обычно выдаются в вашем обработчике покупок (монеты, предметы, баффы и т. п.).

Чтение информации о продукте (название/цена/иконка)

Если вы хотите показать интерфейс «Купить» или записать информацию о продукте, получите определение продукта по идентификатору:

product := Purchasing.get_product("prod_double_jump");
log_info("Product % costs % sparks", {product.name, product.price});

Обработчик покупки (выдача)

Когда игрок покупает продукт в вашей игре, All Out вызывает:

ao_purchase_handler :: proc(player: Player, id: string) -> bool

Вам следует:

• Переключиться по идентификатору продукта

• Выдать предмет/функцию

• Вернуть true если выдача удалась

• Вернуть false если выдача не удалась (инвентарь полон, отсутствует предварительное условие и т. д.)

COIN_PACK_ID :: "prod_coin_pack_small";
DOUBLE_JUMP_ID :: "prod_double_jump";

ao_purchase_handler :: proc(player: Player, id: string) -> bool {
    switch id {
        case COIN_PACK_ID: {
            // Пример: выдать монеты (расходуемый предмет)
            Economy.deposit_currency(player, "Coins", 500);
            Notifier.notify(player, "Спасибо! +500 монет");
            return true;
        }
        case DOUBLE_JUMP_ID: {
            // Пример: разблокировка пропуска игры (постоянно)
            // Обычно вы просто включаете это через проверки owns_product() в других местах.
            // Тем не менее, верните true, чтобы покупка считалась выданной.
            Notifier.notify(player, "Двойной прыжок разблокирован!");
            return true;
        }
    }

    // Неизвестный идентификатор
    return false;
}

Ошибки выдачи и повторы

Если ваш обработчик покупок возвращает false, покупка отмечается как ошибка выдачи.

• Ошибки выдачи отображаются в портале создателя

• Они автоматически повторяются при присоединении игрока, пока не будут успешными

• Вы можете вручную повторно запустить обработчик покупки, пометив покупку как «не выданную» в интерфейсе данных игрока

См.:

• Товары в игре («Обработчики покупок / Ошибки выдачи»)

• Редактирование/просмотр данных игрока (раздел «Покупки»)

Кросс-игры (хаб + мини‑игры)

Если вы используете родительскую структуру игр, покупки могут быть общими между вашими играми. См. Кросс-игровые товары/данные.