Skip to content

README_RU.md

Latest commit

 

History

History
100 lines (76 loc) · 4.67 KB

README_RU.md

File metadata and controls

100 lines (76 loc) · 4.67 KB
Raw

AndroidIAPP Godot Plugin

AndroidIAPP — это плагин для Godot (Android), который делает работу с платежами Google Play (Billing Library 8.0) максимально простой. Он поддерживает разовые покупки, подписки с разными тарифами и — самое главное — офферы (скидки/предложения) для разовых товаров.

🚀 Быстрый старт

1. Установка

  1. Скачайте плагин и поместите папку androidiapp в res://addons/.
  2. Включите плагин в меню: Project -> Project Settings -> Plugins.
  3. Самое важное: Скопируйте файл examples/GooglePlayBilling.gd в свой проект (например, в папку scripts/).

2. Настройка в Godot

Добавьте скрипт GooglePlayBilling.gd в Autoload (Singleton) под именем Billing или просто создайте ноду с этим скриптом в вашей главной сцене.

3. Инициализация

В скрипте вашей игры:

func _ready():
    # Подключаем основные сигналы
    Billing.connected.connect(_on_connected)
    Billing.error_occurred.connect(_on_error)
    Billing.product_details_received.connect(_on_products_loaded)
    Billing.purchases_updated.connect(_on_purchases_updated)

    # Запускаем плагин
    Billing._initialize_plugin()

func _on_connected():
    print("Мы подключились к Google Play!")
    # Запрашиваем информацию о товарах (цены, описания)
    Billing.query_details(["gold_100", "no_ads"], Billing.TYPE_INAPP)

💰 Работа с покупками

Запрос товаров и цен

Данные придут в сигнал product_details_received.

func _on_products_loaded(products: Array, unfetched: Array, type: String):
    for p in products:
        print("Товар: ", p.title, " Цена: ", p.formatted_price)

Покупка (с поддержкой офферов)

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

# Простая покупка
Billing.buy_inapp("gold_100")

# Покупка со специфическим оффером (скидкой)
Billing.buy_inapp("gold_100", "your_offer_token_here")

Подписки

Для подписок нужно указать ID товара и ID базового плана (Base Plan).

Billing.subscribe("premium_sub", "monthly-plan")

✅ Подтверждение покупки (Обязательно!)

Google требует подтверждать покупки, иначе деньги вернутся пользователю через 3 дня.

  1. Расходники (золото, жизни) — нужно "потребить" (consume).
  2. Вечные товары (отключение рекламы) — нужно "подтвердить" (acknowledge).
func _on_purchases_updated(purchases: Array):
    for p in purchases:
        if p.purchase_state == Billing.PurchaseState.PURCHASED:
            if "gold_100" in p.products:
                Billing.consume(p.purchase_token) # Даем золото и потребляем
            else:
                if not p.is_acknowledged:
                    Billing.acknowledge(p.purchase_token) # Активируем вечный товар

🛠 Полезные сигналы GooglePlayBilling.gd

  • connected — можно начинать работу.
  • error_occurred(method, data) — что-то пошло не так (например, нет интернета).
  • product_details_received(products, ...) — пришли цены и описания.
  • purchases_updated(purchases) — сработал после покупки или при проверке активных товаров.
  • consumed_success(token) — товар успешно "съеден", можно начислить награду.

🔍 Отладка

Если что-то не работает, подключите телефон и смотрите логи через терминал:

adb logcat | grep IAPP

Совместимость: Godot 4.3+ (Android Export). Требуется включенное разрешение Billing в настройках экспорта.