Presentar flows en modo Observer - Kotlin Multiplatform

Si usas el modo Observer, tú eres responsable de tu propia lógica de compras. Pero puedes delegar la UI del paywall al Flow & Paywall Builder.

Diseña la pantalla en el builder, y el SDK de Adapty la renderiza de forma nativa. Actualiza el texto, el diseño y los precios cuando quieras, sin necesidad de publicar una nueva versión de la app.

Esta guía muestra cómo presentar un flow y gestionar los callbacks de compra. Si Adapty gestiona las compras por ti, consulta Mostrar flows y paywalls en su lugar.

Antes de empezar

Necesitas:

Implementación

En el modo Observer, el SDK no realiza compras por ti. Cuando un usuario pulsa el botón de compra o restauración en un flow renderizado por Adapty, el SDK llama a tu AdaptyUIObserverModeResolver en su lugar — realiza la compra o restauración con tu propio código allí.

  1. Implementa la interfaz AdaptyUIObserverModeResolver:

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

    El método observerModeDidInitiatePurchase te informa de que el usuario ha iniciado una compra, y observerModeDidInitiateRestore, de que el usuario ha iniciado una restauración. Activa tu flow de compra o restauración personalizado en respuesta.

    Además, recuerda invocar los siguientes callbacks para notificar a AdaptyUI sobre el proceso de compra o restauración. Esto es necesario para el comportamiento correcto del flow, como mostrar el indicador de carga, entre otras cosas:

    CallbackDescription
    onStartPurchase()Este callback debe invocarse para notificar a AdaptyUI que la compra ha comenzado.
    onFinishPurchase()Este callback debe invocarse para notificar a AdaptyUI que la compra ha finalizado.
    onStartRestore()Este callback debe invocarse para notificar a AdaptyUI que la restauración ha comenzado.
    onFinishRestore()Este callback debe invocarse para notificar a AdaptyUI que la restauración ha finalizado.

    El flow permanece abierto mientras se ejecuta tu código. Ciérralo tú mismo una vez que una compra o una restauración de compra se complete con éxito.

    Después de onFinishPurchase(), el flow ejecuta las mismas acciones de resultado independientemente de lo que haya ocurrido, incluida una compra cancelada: las acciones When pending en iOS y las acciones When succeeded en Android. Muestra cualquier pantalla que dependa del resultado de la compra desde tu código: solo tu código conoce el resultado. Después de onFinishRestore(), el flow ejecuta las acciones When restore completed, independientemente de lo que haya ocurrido.

  2. Registra el resolver antes de mostrar cualquier pantalla:

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

    Sin un resolver registrado, la vista del flow no tiene forma de transferir la compra a tu código y no ocurre nada cuando el usuario pulsa el botón de compra.

  3. Crea y presenta la vista del flow como de costumbre: obtén el flow y crea su vista y, después, preséntala. No se necesitan parámetros adicionales: una vez registrado el resolver, todo flow renderizado por Adapty enruta las compras y restauraciones a través de él.

Warning

No olvides informar la transacción y asociarla con el paywall. De lo contrario, Adapty no reconocerá la transacción y no podrá determinar el paywall de origen de la compra.