
Покупки во Flutter на Android: offer token и восстановление
Покупка во Flutter-игре ломается не на самой кнопке «Купить», а на краях: когда Play возвращает товар со списком предложений, когда восстановление идёт без аккаунта Google, когда транзакцию забыли закрыть. Мы прошли все три в AI Inc: Tycoon: после релиза Crashlytics показал падение INVALID_OFFER_TOKEN на планшете, прямо в магазине игры. Ниже семь шагов, как подключить in_app_purchase для Android так, чтобы игра не закрывалась, и четыре теста, которые это удерживают.
Коротко:
- Один идентификатор товара: тот же в консоли и в игре.
- Один слушатель потока покупок на весь процесс, а не на каждую покупку.
- Товар со списком предложений покупайте с offer token; пустой список — не покупайте.
buyNonConsumableоборачивайте вtry … on PlatformException,restorePurchases— вtry … on Exception.- Право выдавайте до закрытия транзакции, а
completePurchaseвызывайте всегда. - Логику выбора параметров покупки выносите в отдельную функцию и тестируйте без телефона.
Шаг 1. Заведите один идентификатор товара
Идентификатор в Play Console должен совпадать с ключом, под которым игра хранит купленное. Второго имени не заводите: любая таблица «магазин → игра» становится вторым источником правды и расходится с первым на первом же новом товаре. Тогда игрок платит за то, чего не получил. В нашем проекте это поле id каталога магазина, а совпадение идентификаторов проверяет отдельный тест.
Тип товара тоже выбирайте осознанно. Всё, что продаёт наша игра, — внешний вид, который остаётся навсегда, поэтому это неисчерпаемые покупки (buyNonConsumable). Исчерпаемый товар означал бы валюту, а её в игре нет.
Шаг 2. Подпишитесь на поток покупок один раз
Поток purchaseStream у плагина один на процесс и отдаёт всё: только что купленное, восстановленное и то, что доплатилось между запусками. Подпишитесь на него при старте и разбирайте события по статусу.
_sub ??= _store.purchaseStream.listen(_onPurchases);
Две подписки дадут две обработки одной покупки, а оператор ??= не даёт создать вторую. В игре у подписки есть ещё onDone и onError, здесь они сокращены.
Шаг 3. Постройте параметр покупки и не забудьте токен
Здесь нас и поймали. Пакет in_app_purchase_android версии 0.5.x проверяет токен предложения в launchBillingFlow: как только у товара есть список subscriptionOfferDetails, плагин требует токен, даже если товар разовый и в консоли вы не создавали никаких предложений. Мы покупали товар «Без рекламы» без токена и получили INVALID_OFFER_TOKEN.
Теперь параметр строит отдельная функция:
PurchaseParam? purchaseParamFor(List<ProductDetails> found) {
if (found.isEmpty) return null;
final play = found.whereType<GooglePlayProductDetails>().toList();
if (play.isEmpty) return PurchaseParam(productDetails: found.first);
final d = play.firstWhere(
(p) => p.productDetails.productType == ProductType.inapp,
orElse: () => play.first,
);
final offers = d.productDetails.subscriptionOfferDetails;
if (offers == null) return PurchaseParam(productDetails: d);
if (offers.isEmpty) return null;
return GooglePlayPurchaseParam(
productDetails: d,
offerToken: d.offerToken ?? offers.first.offerIdToken,
);
}
Читается так: магазин ничего не нашёл — не покупаем; списка предложений нет — обычная покупка; список есть, но пустой — не покупаем (плагин отклонит любой токен); список есть — берём токен из него. Из-за ProductType и GooglePlayPurchaseParam пакет in_app_purchase_android пришлось подключить в pubspec прямой зависимостью.
Шаг 4. Оберните саму покупку в try
Даже с правильным токеном магазин может отказать. Необработанный PlatformException закрывает игру прямо на кнопке, а игрок видит лишь, что приложение упало.
bool started;
try {
started = await _store.buyNonConsumable(purchaseParam: param);
} on PlatformException catch (e) {
debugPrint('purchase $id: ${e.code}');
started = false;
}
if (!started) {
_waiting.remove(id);
return false;
}
Отказ становится обычным «не получилось»: игра говорит это игроку и ничего не ломает. Ещё две мелочи: ограничьте ожидание ответа тайм-аутом (мы ждём три минуты) и помните, что поздняя оплата всё равно придёт через поток.
Шаг 5. Выдавайте право до закрытия транзакции
Для каждого события из потока действуйте в таком порядке: проверьте статус, выдайте право, закройте транзакцию.
for (final p in list) {
final ok = p.status == PurchaseStatus.purchased ||
p.status == PurchaseStatus.restored;
if (ok) {
purchaseGranted?.call(
p.productID,
restored: p.status == PurchaseStatus.restored,
);
}
if (p.pendingCompletePurchase) await _store.completePurchase(p);
if (p.status == PurchaseStatus.pending) continue;
_waiting.remove(p.productID)?.complete(ok);
}
Порядок важен. Если бы игру прервали между закрытием транзакции и выдачей права, игрок остался бы с оплаченным, но заблокированным товаром. А закрывать pendingCompletePurchase нужно всегда: иначе магазин считает покупку незавершённой и возвращает её на каждом запуске. Кроме того, по правилам Play Billing Google возвращает игроку деньги за неподтверждённые покупки через несколько дней. Так что закрывайте каждую транзакцию, которую плагин просит закрыть.
Шаг 6. Восстановление должно уметь молчать
Тихое восстановление на каждом старте игры — хорошая идея, но restorePurchases бросает исключение, когда Play не ответил: нет аккаунта Google, сети или Play ещё не готов. Необработанное, оно становится «фатальным» в Crashlytics. Мы обернули вызов и добавили отдельный флаг, чтобы кнопка «Восстановить покупки» могла честно сказать «Google Play не отвечает».
try {
await _store.restorePurchases();
} on Exception catch (e) {
debugPrint('restore: $e');
_restoreFailed = true;
return {..._restored};
}
await Future<void>.delayed(const Duration(seconds: 2));
return {..._restored};
Пауза в две секунды — не изъян, а следствие того, что ответ приходит потоком, а «больше ничего не будет» магазин не говорит никогда. Мы отдаём то, что успело прийти. Если чего-то не хватило, восстановление можно повторить.
Шаг 7. Напишите четыре теста
Функция выбора параметров чистая, поэтому её проверяет обычный flutter test без телефона и без Play. Нам хватило четырёх случаев:
- Обычный разовый товар покупается как раньше, без токена.
- Товар со списком предложений покупается с токеном из списка этого товара.
- Пустой список предложений — не покупать.
- Магазин ничего не нашёл — не покупать.
Эти тесты появились после настоящего падения. Теперь похожую ошибку мы увидим в тестах, а не в Crashlytics.
Чеклист
- ✓ Идентификатор товара в консоли и в игре один.
- ✓ Поток
purchaseStreamслушает один подписчик. - ✓ Параметр покупки строит отдельная функция, есть тесты на токен.
- ✓
buyNonConsumableиrestorePurchasesобёрнуты вtry. - ✓ Право выдаётся до
completePurchase, аcompletePurchaseвызывается всегда. - ✓ В игре есть строка для случая «Play не отвечает».
Частые вопросы
Нужен ли токен предложения для разового товара?
Только если магазин вернул товар со списком предложений. Если subscriptionOfferDetails равен null, покупайте без токена, как в нашем первом тесте.
Почему «Восстановить покупки» ждёт две секунды?
Ответ магазин отдаёт потоком и не сообщает, какая часть последняя. Короткая пауза позволяет собрать всё, что пришло. Для игрока она незаметна.
Почему транзакцию нужно закрывать всегда?
Пока она не закрыта, магазин считает покупку незавершённой и возвращает её на каждом запуске. Поэтому закрывайте каждую транзакцию, которую плагин просит закрыть.
Нужно ли подключать in_app_purchase_android отдельно?
Если вы используете его типы, например GooglePlayPurchaseParam или ProductType, да: добавьте его в pubspec.yaml прямой зависимостью, а не надейтесь, что его притянет in_app_purchase.
Нужны покупки, реклама за награду и восстановление в мобильной игре без сюрпризов в релизе? Мы подключаем их под ключ вместе с тестами. Подробнее — на странице услуг. Для издателей и студий есть сотрудничество с компаниями. А почему мы выбрали Flutter, читайте в статье «Flutter или Unity».
