
Pembelian dalam Aplikasi Flutter di Android: Offer Token
Di game Flutter, pembelian jarang rusak di tombol «Beli» itu sendiri. Ia rusak di tepi-tepinya: saat Play mengembalikan produk dengan daftar penawaran, saat pemulihan berjalan tanpa akun Google, saat transaksi tidak pernah ditutup. Ketiganya pernah kami alami di AI Inc: Tycoon: setelah rilis, Crashlytics menunjukkan crash INVALID_OFFER_TOKEN di sebuah tablet, tepat di dalam toko game. Di bawah ada tujuh langkah memasang in_app_purchase untuk Android agar game tidak tertutup sendiri, beserta empat tes yang menjaganya.
Ringkasnya:
- Satu ID produk: sama di konsol dan di game.
- Satu pendengar aliran pembelian untuk seluruh proses, bukan satu per pembelian.
- Produk dengan daftar penawaran dibeli dengan offer token; daftar kosong berarti jangan dibeli.
- Bungkus
buyNonConsumabledengantry … on PlatformExceptiondanrestorePurchasesdengantry … on Exception. - Berikan hak sebelum transaksi ditutup, dan selalu panggil
completePurchase. - Pisahkan logika pemilihan parameter pembelian ke fungsi tersendiri dan uji tanpa ponsel.
Langkah 1. Pakai satu ID produk
ID di Play Console harus sama dengan kunci tempat game menyimpan hal yang dibeli. Jangan membuat nama kedua: tabel «toko → game» apa pun menjadi sumber kebenaran kedua dan menyimpang dari yang pertama pada produk baru berikutnya. Lalu pemain membayar untuk sesuatu yang tidak ia terima. Di proyek kami itu adalah kolom id katalog toko, dan sebuah tes terpisah memeriksa bahwa ID-nya cocok.
Tentukan juga jenis produk dengan sadar. Semua yang dijual game kami adalah tampilan yang tetap selamanya, jadi ini pembelian non-habis-pakai (buyNonConsumable). Produk habis-pakai berarti mata uang, dan game kami tidak punya mata uang.
Langkah 2. Berlangganan aliran pembelian sekali saja
purchaseStream milik plugin hanya satu per proses dan menyampaikan semuanya: yang baru dibeli, yang dipulihkan, dan yang dibayar belakangan di antara dua kali peluncuran. Berlanggananlah saat mulai dan tangani peristiwanya berdasarkan status.
_sub ??= _store.purchaseStream.listen(_onPurchases);
Dua langganan akan menangani satu pembelian dua kali, dan operator ??= tidak membiarkan langganan kedua muncul. Di game, langganan itu juga punya onDone dan onError; di sini keduanya diringkas.
Langkah 3. Susun parameter pembelian dan jangan lupa token
Di sinilah kami tertangkap. Paket in_app_purchase_android versi 0.5.x memeriksa offer token di launchBillingFlow: begitu sebuah produk punya daftar subscriptionOfferDetails, plugin menuntut token, meskipun produknya sekali beli dan di konsol kamu tidak pernah membuat penawaran apa pun. Kami membeli produk «Tanpa iklan» tanpa token dan mendapat INVALID_OFFER_TOKEN.
Sekarang parameternya disusun oleh fungsi tersendiri:
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,
);
}
Cara bacanya: toko tidak menemukan apa-apa, jadi tidak dibeli; tidak ada daftar penawaran, pembelian biasa; ada daftar tetapi kosong, jadi tidak dibeli (plugin akan menolak token apa pun); ada daftar, ambil token dari situ. Karena ProductType dan GooglePlayPurchaseParam, kami harus menambahkan paket in_app_purchase_android ke pubspec sebagai dependensi langsung.
Langkah 4. Bungkus pembelian itu sendiri dengan try
Bahkan dengan token yang benar, toko bisa menolak. PlatformException yang tidak ditangani menutup game tepat di tombolnya, dan pemain hanya melihat aplikasi yang crash.
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;
}
Penolakan menjadi sekadar «tidak berhasil»: game memberi tahu pemain dan tidak ada yang rusak. Dua hal kecil lagi: batasi waktu tunggu jawaban dengan timeout (kami menunggu tiga menit) dan ingat bahwa pembayaran yang terlambat tetap tiba lewat aliran.
Langkah 5. Berikan hak sebelum menutup transaksi
Untuk setiap peristiwa dari aliran, kerjakan dengan urutan ini: periksa status, berikan hak, tutup transaksi.
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);
}
Urutannya penting. Jika game terhenti di antara penutupan transaksi dan pemberian hak, pemain akan tertinggal dengan barang yang sudah dibayar tetapi terkunci. Dan pendingCompletePurchase harus selalu ditutup, kalau tidak toko menganggap pembelian belum selesai dan mengembalikannya di setiap peluncuran. Selain itu, menurut aturan Play Billing, Google mengembalikan uang pembelian yang tidak dikonfirmasi kepada pemain setelah beberapa hari. Jadi tutuplah setiap transaksi yang diminta plugin untuk ditutup.
Langkah 6. Pemulihan harus bisa diam
Pemulihan senyap di setiap awal game adalah ide bagus, tetapi restorePurchases melempar pengecualian saat Play tidak menjawab: tanpa akun Google, tanpa jaringan, atau Play belum siap. Jika tidak ditangani, ia menjadi «fatal» di Crashlytics. Kami membungkus pemanggilannya dan menambah penanda tersendiri agar tombol «Pulihkan pembelian» bisa jujur berkata «Google Play tidak merespons».
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};
Jeda dua detik bukan cacat, melainkan akibat jawaban datang lewat aliran, sedangkan toko tidak pernah berkata «tidak akan ada lagi». Kami mengembalikan apa yang sempat tiba. Jika ada yang kurang, pemulihan bisa diulang.
Langkah 7. Tulis empat tes
Fungsi pemilih parameter itu murni, jadi flutter test biasa memeriksanya tanpa ponsel dan tanpa Play. Empat kasus cukup bagi kami:
- Produk sekali beli yang biasa dibeli seperti sebelumnya, tanpa token.
- Produk dengan daftar penawaran dibeli dengan token dari daftar produk itu.
- Daftar penawaran kosong: jangan dibeli.
- Toko tidak menemukan apa-apa: jangan dibeli.
Tes-tes ini lahir setelah crash yang sungguhan. Sekarang kesalahan serupa akan terlihat di tes, bukan di Crashlytics.
Checklist
- ✓ ID produk sama di konsol dan di game.
- ✓ Satu pelanggan mendengarkan
purchaseStream. - ✓ Fungsi tersendiri menyusun parameter pembelian, dengan tes untuk token.
- ✓
buyNonConsumabledanrestorePurchasesdibungkustry. - ✓ Hak diberikan sebelum
completePurchase, dancompletePurchaseselalu dipanggil. - ✓ Game punya pesan untuk kasus «Play tidak merespons».
Pertanyaan yang sering diajukan
Apakah produk sekali beli butuh offer token?
Hanya jika toko mengembalikan produk dengan daftar penawaran. Jika subscriptionOfferDetails bernilai null, beli tanpa token, seperti di tes pertama kami.
Mengapa «Pulihkan pembelian» menunggu dua detik?
Toko menyampaikan jawaban lewat aliran dan tidak memberi tahu bagian mana yang terakhir. Jeda singkat memungkinkan kita mengumpulkan semua yang tiba. Pemain tidak merasakannya.
Mengapa transaksi harus selalu ditutup?
Selama belum ditutup, toko menganggap pembelian belum selesai dan mengembalikannya di setiap peluncuran. Jadi tutup setiap transaksi yang diminta plugin untuk ditutup.
Apakah in_app_purchase_android perlu ditambahkan terpisah?
Jika kamu memakai tipenya, seperti GooglePlayPurchaseParam atau ProductType, ya: tambahkan ke pubspec.yaml sebagai dependensi langsung, jangan berharap in_app_purchase yang membawanya.
Butuh pembelian, iklan berhadiah, dan pemulihan di game mobile tanpa kejutan saat rilis? Kami memasangnya dari awal sampai beres, lengkap dengan tes. Selengkapnya di halaman layanan. Untuk penerbit dan studio ada kerja sama dengan perusahaan. Dan untuk tahu mengapa kami memilih Flutter, baca Flutter atau Unity.
