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

Игроки могут покупать товары (пропуски в игре + расходуемые предметы) за Spark в вашей игре. Когда происходит покупка, 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 с ID товара.

BUY_DOUBLE_JUMP_ID :: "prod_double_jump";

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

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

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

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

ADMIN_PASS_ID :: "prod_admin";

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

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

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

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

product := Purchasing.get_product("prod_double_jump");
log_info("Товар % стоит % спарксов", {product.name, product.price});

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

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

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

Если ваша игра не определяет ao_purchase_handler, нерасходуемые товары выдаются автоматически, чтобы они работали с Purchasing.owns_product. Расходуемые товары по-прежнему требуют обработчика и без него помечаются как ошибка выдачи.

Вам следует:

• Проверять ID товара в switch
• Выдавать предмет/функцию
• Возвращать 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;
        }
    }

    // Неизвестный ID
    return false;
}

Сбои выдачи и повторные попытки

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

• Сбои выдачи отображаются в панели создателя
• Они автоматически повторяются, когда игрок заходит, пока не будут успешны
• Вы можете вручную повторно запустить обработчик покупки, пометив покупку как «невыданную» в UI данных игрока

См.:

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

Межигровое использование (hub + мини-игры)

Если вы используете родительские связи между играми, покупки можно разделять между вашими играми. См. Продукты/данные между играми.