← BalitaGabay · Flutter

Flutter In-App Purchases sa Android: Offer Token at Restore

Mga artikulo#Flutter#in_app_purchase#Google Play Billing#in-app purchases#Android#Dart#game dev

Sa larong Flutter, bihirang masira ang bilihan sa mismong button na «Bilhin». Sa mga gilid ito nasisira: kapag nagbalik ang Play ng produktong may listahan ng mga alok, kapag tumakbo ang restore nang walang Google account, kapag hindi kailanman naisara ang isang transaksyon. Lahat ng tatlo ay naranasan namin sa AI Inc: Tycoon: pagkatapos ng isang release, nagpakita ang Crashlytics ng crash na INVALID_OFFER_TOKEN sa isang tablet, mismo sa loob ng shop ng laro. Narito ang pitong hakbang sa pag-set up ng in_app_purchase para sa Android para hindi magsara ang laro, at ang apat na test na nagbabantay nito.

Sa madaling salita:

  • Iisang product ID: pareho sa console at sa laro.
  • Isang listener lang sa purchase stream para sa buong proseso, hindi isa kada pagbili.
  • Ang produktong may listahan ng mga alok ay binibili gamit ang offer token; kapag walang laman ang listahan, huwag bumili.
  • I-wrap ang buyNonConsumable sa try … on PlatformException at ang restorePurchases sa try … on Exception.
  • Ibigay ang karapatan bago isara ang transaksyon, at laging tawagin ang completePurchase.
  • Ihiwalay sa sariling function ang lohika ng pagpili ng mga parametro ng pagbili at i-test nang walang phone.

Hakbang 1. Gumamit ng iisang product ID

Dapat tumugma ang ID sa Play Console sa susi kung saan iniimbak ng laro ang nabili. Huwag gumawa ng pangalawang pangalan: ang anumang talahanayang «store → laro» ay nagiging pangalawang pinagmumulan ng katotohanan at lumilihis sa una sa susunod na bagong produkto. Saka magbabayad ang manlalaro para sa hindi niya natanggap. Sa proyekto namin, ito ang field na id ng catalog ng shop, at isang hiwalay na test ang nagsusuri kung tugma ang mga ID.

Pag-isipan din ang uri ng produkto. Lahat ng ibinebenta ng laro namin ay itsurang nananatili habambuhay, kaya non-consumable ang mga pagbili (buyNonConsumable). Ang consumable na produkto ay nangangahulugan ng pera sa laro, at wala kaming ganoon.

Hakbang 2. Mag-subscribe sa purchase stream nang isang beses lang

Ang purchaseStream ng plugin ay isa kada proseso at inihahatid nito ang lahat: ang kabibili lang, ang na-restore, at ang binayaran nang huli sa pagitan ng mga pagbubukas. Mag-subscribe sa simula at hawakan ang mga event ayon sa status.

_sub ??= _store.purchaseStream.listen(_onPurchases);

Dalawang beses hahawakan ng dalawang subscription ang isang pagbili, at hindi hinahayaan ng operator na ??= na magkaroon ng pangalawa. Sa laro, may onDone at onError din ang subscription; pinaikli ang mga ito rito.

Hakbang 3. Buuin ang parametro ng pagbili at huwag kalimutan ang token

Dito kami nahuli. Sinusuri ng package na in_app_purchase_android bersyon 0.5.x ang offer token sa launchBillingFlow: sa sandaling may listahang subscriptionOfferDetails ang isang produkto, humihingi ang plugin ng token, kahit isang beses lang ang bayad ng produkto at wala kang ginawang alok sa console. Binili namin ang produktong «Walang ad» nang walang token at nakuha namin ang INVALID_OFFER_TOKEN.

Ngayon, isang hiwalay na function ang bumubuo ng parametro:

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,
  );
}

Ganito ito basahin: walang nahanap ang store, kaya hindi bibili; walang listahan ng mga alok, karaniwang pagbili; may listahan pero walang laman, kaya hindi bibili (tatanggihan ng plugin ang anumang token); may listahan, kukunin ang token mula roon. Dahil sa ProductType at GooglePlayPurchaseParam, kinailangan naming idagdag ang package na in_app_purchase_android sa pubspec bilang direktang dependency.

Hakbang 4. I-wrap sa try ang mismong pagbili

Kahit tama ang token, puwedeng tumanggi ang store. Isinasara ng hindi nahawakang PlatformException ang laro mismo sa button, at ang nakikita lang ng manlalaro ay bumagsak ang app.

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;
}

Ang pagtanggi ay nagiging karaniwang «hindi gumana»: sinasabi ito ng laro sa manlalaro at walang nasisira. Dalawa pang maliliit na bagay: limitahan ang paghihintay ng sagot gamit ang timeout (tatlong minuto ang hinihintay namin) at tandaan na darating pa rin sa stream ang huling bayad.

Hakbang 5. Ibigay ang karapatan bago isara ang transaksyon

Para sa bawat event mula sa stream, sundin ang ganitong pagkakasunod-sunod: suriin ang status, ibigay ang karapatan, isara ang transaksyon.

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);
}

Mahalaga ang pagkakasunod-sunod. Kung maputol ang laro sa pagitan ng pagsasara ng transaksyon at pagbibigay ng karapatan, maiiwan ang manlalaro na may bayad na pero nakakandadong bagay. At dapat laging isara ang pendingCompletePurchase, kung hindi, ituturing ng store na hindi pa tapos ang pagbili at ibabalik ito sa bawat pagbubukas. Bukod pa rito, ayon sa mga patakaran ng Play Billing, ibinabalik ng Google ang pera ng mga hindi kumpirmadong pagbili sa manlalaro pagkalipas ng ilang araw. Kaya isara ang bawat transaksyong hinihiling ng plugin na isara.

Hakbang 6. Dapat marunong manahimik ang restore

Magandang ideya ang tahimik na restore sa bawat simula ng laro, pero naghahagis ng exception ang restorePurchases kapag hindi sumagot ang Play: walang Google account, walang network o hindi pa handa ang Play. Kapag hindi hinawakan, nagiging «fatal» ito sa Crashlytics. Ni-wrap namin ang tawag at nagdagdag ng hiwalay na flag para matapat na masabi ng button na «Ibalik ang mga pagbili»: «Hindi sumasagot ang 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};

Ang dalawang segundong paghinto ay hindi depekto kundi bunga ng pagdating ng sagot sa stream, habang hindi kailanman sinasabi ng store na «wala nang darating pa». Ibinabalik namin ang nakaabot. Kung may kulang, puwedeng ulitin ang restore.

Hakbang 7. Sumulat ng apat na test

Dalisay ang function na pumipili ng mga parametro, kaya sinusuri ito ng karaniwang flutter test nang walang phone at walang Play. Sapat na sa amin ang apat na kaso:

  1. Ang karaniwang one-time na produkto ay binibili gaya ng dati, walang token.
  2. Ang produktong may listahan ng mga alok ay binibili gamit ang token mula sa listahan ng produktong iyon.
  3. Walang laman na listahan ng mga alok: huwag bumili.
  4. Walang nahanap ang store: huwag bumili.

Lumitaw ang mga test na ito pagkatapos ng totoong crash. Ngayon, makikita na namin sa mga test, hindi sa Crashlytics, ang kahalintulad na error.

Checklist

  • ✓ Pareho ang product ID sa console at sa laro.
  • ✓ Isang subscriber lang ang nakikinig sa purchaseStream.
  • ✓ Isang hiwalay na function ang bumubuo ng parametro ng pagbili, may mga test para sa token.
  • ✓ Naka-wrap sa try ang buyNonConsumable at restorePurchases.
  • ✓ Ibinibigay ang karapatan bago ang completePurchase, at laging tinatawag ang completePurchase.
  • ✓ May mensahe ang laro para sa kasong «hindi sumasagot ang Play».

Mga madalas itanong

Kailangan ba ng offer token sa one-time na produkto?

Kung ibinalik lang ng store ang produkto na may listahan ng mga alok. Kung null ang subscriptionOfferDetails, bumili nang walang token, gaya ng unang test namin.

Bakit naghihintay ng dalawang segundo ang «Ibalik ang mga pagbili»?

Inihahatid ng store ang sagot sa stream at hindi nito sinasabi kung alin ang huling bahagi. Pinapayagan ng maikling paghinto na makuha ang lahat ng dumating. Hindi ito napapansin ng manlalaro.

Bakit laging dapat isara ang transaksyon?

Hangga't hindi ito nasasara, ituturing ng store na hindi pa tapos ang pagbili at ibabalik ito sa bawat pagbubukas. Kaya isara ang bawat transaksyong hinihiling ng plugin na isara.

Kailangan bang idagdag nang hiwalay ang in_app_purchase_android?

Kung ginagamit mo ang mga type nito, gaya ng GooglePlayPurchaseParam o ProductType, oo: idagdag ito sa pubspec.yaml bilang direktang dependency sa halip na umasa na dadalhin ito ng in_app_purchase.


Kailangan mo ba ng pagbili, rewarded ads at restore sa mobile game na walang sorpresa sa release? Ise-set up namin ang mga ito nang buo, kasama ang mga test. Higit pang detalye sa pahina ng mga serbisyo. Para sa mga publisher at studio, may pakikipagtulungan sa mga kumpanya. At para malaman kung bakit Flutter ang pinili namin, basahin ang Flutter o Unity.