Observer modunda flow'ları sunma - Kotlin Multiplatform

Observer modu kullanıyorsanız, kendi satın alma mantığınızdan siz sorumlusunuz. Ancak paywall arayüzünü Flow & Paywall Builder’a devredebilirsiniz.

Ekranı builder’da tasarlayın, Adapty SDK onu native olarak render eder. Metin, düzen ve fiyatlandırmayı istediğiniz zaman güncelleyin, uygulama güncellemesine gerek yok.

Bu kılavuz, bir flow’u nasıl sunacağınızı ve satın alma callback’lerini nasıl yöneteceğinizi gösterir. Adapty satın alma işlemlerini sizin için tamamlıyorsa bunun yerine Flow’ları ve paywall’ları görüntüleme bölümüne bakın.

Başlamadan önce

You need:

Uygulama

Observer modunda SDK, sizin adınıza satın alma işlemi gerçekleştirmez. Kullanıcı, Adapty tarafından render edilen bir flow içindeki satın alma veya geri yükleme düğmesine dokunduğunda, SDK AdaptyUIObserverModeResolver metodunuzu çağırır — satın alma veya geri yükleme işlemini burada kendi kodunuzla gerçekleştirin.

  1. AdaptyUIObserverModeResolver arayüzünü uygulayın:

    import com.adapty.kmp.AdaptyUIObserverModeResolver
    import com.adapty.kmp.models.AdaptyPaywallProduct
    import com.adapty.kmp.models.AdaptyUIFlowView
    
    class MyObserverModeResolver : AdaptyUIObserverModeResolver {
        override fun observerModeDidInitiatePurchase(
            view: AdaptyUIFlowView,
            product: AdaptyPaywallProduct,
            onStartPurchase: () -> Unit,
            onFinishPurchase: () -> Unit
        ) {
            onStartPurchase() // the view shows its loading indicator
            // make the purchase with your own code,
            // then report the transaction to Adapty and call:
            onFinishPurchase() // the view hides the loading indicator
        }
    
        override fun observerModeDidInitiateRestore(
            view: AdaptyUIFlowView,
            onStartRestore: () -> Unit,
            onFinishRestore: () -> Unit
        ) {
            onStartRestore()
            // restore purchases with your own code, then:
            onFinishRestore()
        }
    }

    observerModeDidInitiatePurchase metodu kullanıcının bir satın alma başlattığını, observerModeDidInitiateRestore ise kullanıcının geri yükleme başlattığını size bildirir. Buna karşılık olarak kendi özel satın alma veya geri yükleme flow’unuzu tetikleyin.

Ayrıca, satın alma veya geri yükleme sürecini AdaptyUI’ya 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:

CallbackDescription
onStartPurchase()Satın alma başladığında AdaptyUI’ı bilgilendirmek için bu callback çağrılmalıdır.
onFinishPurchase()Satın alma tamamlandığında AdaptyUI’ı bilgilendirmek için bu callback çağrılmalıdır.
onStartRestore()Geri yükleme başladığında AdaptyUI’ı bilgilendirmek için bu callback çağrılmalıdır.
onFinishRestore()Geri yükleme tamamlandığında AdaptyUI’ı bilgilendirmek için bu callback çağrılmalıdır.

Flow, kodunuz çalışırken açık kalır. Bir satın alma veya satın alma geri yükleme işlemi başarılı olduğunda onu kendiniz kapatın.

onFinishPurchase() çağrısından sonra flow, ne olursa olsun (iptal edilen satın alma dahil) aynı sonuç eylemlerini çalıştırır: iOS’ta When pending eylemleri, Android’de When succeeded eylemleri. Satın alma sonucuna bağlı ekranları (örneğin bir teşekkür ekranı) kendi kodunuzdan gösterin; sonucu yalnızca sizin kodunuz bilir. onFinishRestore() çağrısından sonra ise flow, ne olursa olsun When restore completed eylemlerini çalıştırır.

  1. Herhangi bir ekran göstermeden önce resolver’ı kaydedin:

    import com.adapty.kmp.AdaptyUI
    
    AdaptyUI.setObserverModeResolver(MyObserverModeResolver())

    Kayıtlı bir resolver olmadan, flow view’ın satın alma işlemini kodunuza iletmesinin bir yolu yoktur ve kullanıcı satın alma düğmesine dokunduğunda hiçbir şey olmaz.

  2. Flow view’ı her zamanki gibi oluşturun ve gösterin: flow’u alın ve view’ını oluşturun, ardından gösterin. Ekstra parametre gerekmez — resolver kaydedildiğinde, Adapty tarafından render edilen her flow, satın alma ve geri yükleme işlemlerini onun üzerinden yönlendirir.

Warning

İşlemi raporlamayı ve paywall ile ilişkilendirmeyi unutmayın. Aksi takdirde Adapty işlemi tanımayacak ve satın almanın kaynak paywall’ını belirleyemeyecektir.