Flutter SDK'da Observer mode ile flow'ları sunma
Observer mode kullanıyorsanız, satın alma mantığından siz sorumlusunuz. Ancak paywall arayüzünü Flow & Paywall Builder’a devredebilirsiniz.
Ekranı builder’da tasarlayın, Adapty SDK onu natively render eder. Metin, düzen ve fiyatlandırmayı istediğiniz zaman güncelleyin; uygulama güncellemesi gerekmez.
Bu kılavuz, bir flow’un nasıl sunulacağını ve satın alma callback’lerinin nasıl yönetileceğini gösterir. Adapty satın almaları sizin adınıza tamamlıyorsa, bunun yerine Flow ve paywall’ları görüntüleme bölümüne bakın.
Başlamadan önce
Şunlara ihtiyacınız var:
- Adapty Flutter SDK 4.0 veya üzeri: Eski sürümler flow’ları render edemez. Mevcut bir uygulamayı taşımak için migration kılavuzuna bakın.
observerModetrueolarak ayarlanmış: Flutter SDK kurulum kılavuzundaki Flutter SDK installation guide bölümüne bakın.- İlk mağaza entegrasyonu: Adapty’yi App Store ile ve Google Play ile kurun.
- Ürünleri olan yayımlanmış bir flow: Flow & Paywall Builder’da oluşturun ve ürünleri atayın.
- Bir flow placement’ı: Bir placement oluşturun ve flow’unuzu atayın.
- Uygulamanızda çekilen flow: Flow’u sunmadan önce flow’u ve yapılandırmasını alın.
Uygulama
Observer modunda SDK, satın alma işlemlerini sizin adınıza gerçekleştirmez. Bir kullanıcı Adapty tarafından render edilen bir flow’daki satın alma veya geri yükleme düğmesine dokunduğunda, SDK sizin AdaptyUIObserverModeResolver’ınızı çağırır — satın alma veya geri yükleme işlemini orada kendi kodunuzla gerçekleştirin.
-
AdaptyUIObserverModeResolver’ı uygulayın:class MyObserverModeResolver extends AdaptyUIObserverModeResolver { @override void observerModeDidInitiatePurchase( AdaptyUIFlowView view, AdaptyPaywallProduct product, void Function() onStartPurchase, void Function() onFinishPurchase, ) { onStartPurchase(); // the view shows its loading indicator // make the purchase with your own code, then: onFinishPurchase(); // the view hides the loading indicator } @override void observerModeDidInitiateRestore( AdaptyUIFlowView view, void Function() onStartRestore, void Function() onFinishRestore, ) { onStartRestore(); // restore purchases with your own code, then: onFinishRestore(); } }observerModeDidInitiatePurchasemetodu, kullanıcının bir satın alma işlemi başlattığını;observerModeDidInitiateRestoreise kullanıcının bir geri yükleme işlemi başlattığını size bildirir. Buna yanıt olarak özel satın alma veya geri yükleme flow’unuzu tetikleyin.Ayrıca, satın alma veya geri yükleme sürecini AdaptyUI’a bildirmek için aşağıdaki callback’leri çağırmayı unutmayın. Bu, yükleyiciyi göstermek gibi düzgün flow davranışı için gereklidir:
Callback Description onStartPurchase() Satın alma işleminin başladığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır. onFinishPurchase() Satın alma işleminin tamamlandığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır. onStartRestore() Geri yükleme işleminin başladığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır. onFinishRestore() Geri yükleme işleminin tamamlandığını AdaptyUI’ya bildirmek için bu callback çağrılmalıdır. onFinishPurchase()çağrısından sonra, flow; iptal edilmiş bir satın alma dahil ne olursa olsun aynı sonuç eylemlerini çalıştırır: iOS’ta When pending eylemleri, Android’de ise When succeeded eylemleri. Satın alma sonucuna bağlı olan herhangi bir ekranı (örneğin teşekkür ekranı) kendi kodunuzdan gösterin; zira sonucu yalnızca kodunuz bilir.onFinishRestore()çağrısından sonra ise flow, ne olursa olsun When restore completed eylemlerini çalıştırır. -
Herhangi bir ekran gösterilmeden önce resolver’ı kaydedin:
AdaptyUI().setObserverModeResolver(MyObserverModeResolver()); -
Flow görünümünü zamanki gibi oluşturun ve sunun: flow’u alın ve görünümünü oluşturun, ardından sunun. Ekstra parametre gerekmez — resolver kaydedildikten sonra Adapty tarafından render edilen her flow, satın almaları ve geri yüklemeleri bu resolver üzerinden yönlendirir.
İşlemi bildirmeyi ve paywall ile ilişkilendirmeyi unutmayın. Aksi takdirde Adapty işlemi tanımayacak ve satın alma işleminin kaynak paywall’ını belirleyemeyecektir.