在 Android SDK 中以观察者模式呈现付费墙编辑工具创建的付费墙

如果你使用流程编辑工具或付费墙编辑工具创建了流程或付费墙，无需在移动端代码中手动处理渲染逻辑，即可将其展示给用户。这类流程或付费墙本身已包含展示内容和展示方式的完整定义。

本节仅适用于观察者模式。如果你不使用观察者模式，请参阅 Android - 展示流程与付费墙。

开始展示流程之前（点击展开）

完成 Adapty 与 Google Play 的初始集成。 2. 安装并配置 Adapty SDK，确保将 observerMode 参数设置为 true。请参阅我们针对特定框架的说明 Android 版。 3. 在 Adapty 看板中创建产品。 4. 在编辑工具中配置流程或付费墙，并为其分配产品。 5. 在 Adapty 看板中创建版位并为其分配流程或付费墙。 6. 在移动应用代码中获取流程及其配置。

实现 AdaptyUiObserverModeHandler。

当用户发起购买时，onPurchaseInitiated 事件会通知你。你可以在此回调中触发自定义的购买流程：

val observerModeHandler =
 AdaptyUiObserverModeHandler { product, flow, flowView, onStartPurchase, onFinishPurchase ->
    onStartPurchase()
    yourBillingClient.makePurchase(
        product,
        onSuccess = { purchase ->
            onFinishPurchase()
            //handle success
        },
        onError = {
            onFinishPurchase()
            //handle error
        },
        onCancel = {
            onFinishPurchase()
            //handle cancel
        }
    )
}

AdaptyUiObserverModeHandler observerModeHandler = (product, flow, flowView, onStartPurchase, onFinishPurchase) -> {
    onStartPurchase.invoke();
    yourBillingClient.makePurchase(
        product,
        purchase -> {
            onFinishPurchase.invoke();
            //handle success
        },
        error -> {
            onFinishPurchase.invoke();
            //handle error
        },
        () -> { //cancellation
            onFinishPurchase.invoke();
            //handle cancel
        }
    );
};

要在观察者模式下处理恢复操作，请重写 getRestoreHandler()。默认情况下它返回 null，此时会使用 Adapty 内置的 Adapty.restorePurchases() 流程。如需自定义恢复逻辑：

val observerModeHandler = object : AdaptyUiObserverModeHandler {
    // onPurchaseInitiated implementation (see above)

    override fun getRestoreHandler() =
        AdaptyUiObserverModeHandler.RestoreHandler { onStartRestore, onFinishRestore ->
            onStartRestore()
            yourBillingClient.restorePurchases(
                onSuccess = { restoredPurchases ->
                    onFinishRestore()
                    //handle successful restore
                },
                onError = {
                    onFinishRestore()
                    //handle error
                }
            )
        }
}

AdaptyUiObserverModeHandler observerModeHandler = new AdaptyUiObserverModeHandler() {
    // onPurchaseInitiated implementation (see above)

    @Override
    public RestoreHandler getRestoreHandler() {
        return (onStartRestore, onFinishRestore) -> {
            onStartRestore.invoke();
            yourBillingClient.restorePurchases(
                restoredPurchases -> {
                    onFinishRestore.invoke();
                    //handle successful restore
                },
                error -> {
                    onFinishRestore.invoke();
                    //handle error
                }
            );
        };
    }
};

记得调用以下回调函数，以便将购买或恢复流程的状态通知 AdaptyUI。这对于正确的流程行为（例如显示加载器）是必要的：

回调	描述
onStartPurchase()	应调用此回调以通知 AdaptyUI 购买已开始。
onFinishPurchase()	应调用此回调以通知 AdaptyUI 购买已完成。
onStartRestore()	可选。可调用此回调以通知 AdaptyUI 恢复已开始。
onFinishRestore()	可选。可调用此回调以通知 AdaptyUI 恢复已完成。

要在设备屏幕上显示可视化流程，必须先对其进行配置。

为此，请调用 AdaptyUI.getFlowView() 方法，或直接创建 AdaptyFlowView：

   val flowView = AdaptyUI.getFlowView(
       activity,
       flowConfiguration,
       products,
       eventListener,
       insets,
       customAssets,
       tagResolver,
       timerResolver,
       observerModeHandler, 
   )

   val flowView =
        AdaptyFlowView(activity) // or retrieve it from xml
   ...
   with(flowView) {
       showFlow(
           flowConfiguration,
           products,
					 eventListener,
           insets,
           customAssets,
           tagResolver,
           timerResolver,
					 observerModeHandler,
       )
   }

AdaptyFlowView flowView = AdaptyUI.getFlowView(
        activity,
        flowConfiguration,
        products,
        eventListener,
        insets,
        customAssets,
        tagResolver,
        timerResolver,
        observerModeHandler
);

AdaptyFlowView flowView =
  new AdaptyFlowView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
flowView.showFlow(flowConfiguration, products, eventListener, insets, customAssets, tagResolver, timerResolver, observerModeHandler);

<com.adapty.ui.AdaptyFlowView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

视图成功创建后，即可将其添加到视图层级并显示。

使用以下可组合函数：

AdaptyFlowScreen(
    flowConfiguration,
    products,
    eventListener,
    insets,
    customAssets,
    tagResolver,
    timerResolver,
    observerModeHandler,
)

请求参数：

参数	是否必填	描述
flowConfiguration	必填	提供一个包含流程视觉详情的 `AdaptyUI.FlowConfiguration` 对象。使用 `AdaptyUI.getFlowConfiguration(flow)` 方法加载该对象。详情请参阅获取视图配置。
products	选填	提供一个 `AdaptyPaywallProduct` 数组，以优化产品在页面上的显示时机。若传入 `null`，AdaptyUI 将自动获取所需产品。
eventListener	选填	提供一个 `AdaptyFlowEventListener` 以监听流程事件。建议继承 `AdaptyFlowDefaultEventListener` 以简化使用。详情请参阅处理流程与付费墙事件。
insets	选填	Insets 是流程四周的空白区域，用于防止可点击元素被系统栏遮挡。默认值为 `Unspecified`，即由 Adapty 自动调整 insets。请参阅更改流程 insets。
customAssets	选填	传入一个 `AdaptyCustomAssets` 对象，以在运行时替换流程或付费墙中的图片和视频。详情请参阅自定义资源。
tagResolver	选填	使用 `AdaptyUiTagResolver` 解析流程文本中的自定义标签。该解析器接收标签参数并将其解析为对应的字符串。详情请参阅付费墙编辑工具中的自定义标签相关内容。
observerModeHandler	Observer 模式下必填	您在上一步中实现的 `AdaptyUiObserverModeHandler`。

不要忘记将付费墙与购买交易关联。否则，Adapty 将无法确定购买的来源流程。

开始展示付费墙之前（点击展开）

设置 Adapty 与 Google Play 和 App Store 的初始集成。
安装并配置 Adapty SDK。确保将 observerMode 参数设置为 true。请参阅我们针对 Android 的框架专属说明。
在 Adapty 看板中创建产品。
在 Adapty 看板中配置付费墙、为其分配产品，并使用付费墙编辑工具对其进行自定义。
在 Adapty 看板中创建版位并为其分配付费墙。
在移动应用代码中获取付费墙编辑工具创建的付费墙及其配置。

实现 AdaptyUiObserverModeHandler。

onPurchaseInitiated 事件将通知您用户已发起购买。您可以在此回调中触发自定义的购买流程：

val observerModeHandler =
 AdaptyUiObserverModeHandler { product, paywall, paywallView, onStartPurchase, onFinishPurchase ->
    onStartPurchase()
    yourBillingClient.makePurchase(
        product,
        onSuccess = { purchase ->
            onFinishPurchase()
            //handle success
        },
        onError = {
            onFinishPurchase()
            //handle error
        },
        onCancel = {
            onFinishPurchase()
            //handle cancel
        }
    )
}

AdaptyUiObserverModeHandler observerModeHandler = (product, paywall, paywallView, onStartPurchase, onFinishPurchase) -> {
    onStartPurchase.invoke();
    yourBillingClient.makePurchase(
        product,
        purchase -> {
            onFinishPurchase.invoke();
            //handle success
        },
        error -> {
            onFinishPurchase.invoke();
            //handle error
        },
        () -> { //cancellation
            onFinishPurchase.invoke();
            //handle cancel
        }
    );
};

要在观察者模式下处理恢复操作，请重写 getRestoreHandler()。默认情况下它返回 null，此时会使用 Adapty 内置的 Adapty.restorePurchases() 流程。如需自定义恢复逻辑，请按以下方式实现：

val observerModeHandler = object : AdaptyUiObserverModeHandler {
    // onPurchaseInitiated implementation (see above)

    override fun getRestoreHandler() =
        AdaptyUiObserverModeHandler.RestoreHandler { onStartRestore, onFinishRestore ->
            onStartRestore()
            yourBillingClient.restorePurchases(
                onSuccess = { restoredPurchases ->
                    onFinishRestore()
                    //handle successful restore
                },
                onError = {
                    onFinishRestore()
                    //handle error
                }
            )
        }
}

AdaptyUiObserverModeHandler observerModeHandler = new AdaptyUiObserverModeHandler() {
    // onPurchaseInitiated implementation (see above)

    @Override
    public RestoreHandler getRestoreHandler() {
        return (onStartRestore, onFinishRestore) -> {
            onStartRestore.invoke();
            yourBillingClient.restorePurchases(
                restoredPurchases -> {
                    onFinishRestore.invoke();
                    //handle successful restore
                },
                error -> {
                    onFinishRestore.invoke();
                    //handle error
                }
            );
        };
    }
};

请记得调用以下回调以通知 AdaptyUI 购买或恢复流程。这对于正确的付费墙行为（例如显示加载动画）是必要的：

回调函数	说明
onStartPurchase()	调用此回调函数以通知 AdaptyUI 购买已开始。
onFinishPurchase()	调用此回调函数以通知 AdaptyUI 购买已完成。
onStartRestore()	可选。调用此回调函数以通知 AdaptyUI 恢复购买已开始。
onFinishRestore()	可选。调用此回调函数以通知 AdaptyUI 恢复购买已完成。

要在设备屏幕上显示可视化付费墙，您必须先对其进行配置。

为此，请调用 AdaptyUI.getPaywallView() 方法或直接创建 AdaptyPaywallView：

   val paywallView = AdaptyUI.getPaywallView(
       activity,
       viewConfiguration,
       products,
       eventListener,
       personalizedOfferResolver,
       tagResolver,
       timerResolver,
       observerModeHandler, 
   )

   val paywallView =
        AdaptyPaywallView(activity) // or retrieve it from xml
   ...
   with(paywallView) {
       showPaywall(
           viewConfiguration,
           products,
					 eventListener,
           personalizedOfferResolver,
           tagResolver,
           timerResolver,
					 observerModeHandler,
       )
   }

AdaptyPaywallView paywallView = AdaptyUI.getPaywallView(
        activity,
        viewConfiguration,
        products,
        eventListener,
        personalizedOfferResolver,
        tagResolver,
        timerResolver,
        observerModeHandler
);

AdaptyPaywallView paywallView =
  new AdaptyPaywallView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
paywallView.showPaywall(viewConfiguration, products, eventListener, personalizedOfferResolver, tagResolver, timerResolver, observerModeHandler);

<com.adapty.ui.AdaptyPaywallView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

视图成功创建后，您可以将其添加到视图层级中并显示。

使用以下可组合函数：

AdaptyPaywallScreen(
    viewConfiguration,
    products,
    eventListener,
    personalizedOfferResolver,
    tagResolver,
    timerResolver,
)

请求参数：

参数	是否必填	描述
Products	可选	提供一个 `AdaptyPaywallProduct` 数组，以优化产品在屏幕上的展示时机。如果传入 `null`，AdaptyUI 将自动获取所需产品。
ViewConfiguration	必填	提供一个包含付费墙视觉详情的 `AdaptyViewConfiguration` 对象。使用 `Adapty.getViewConfiguration(paywall)` 方法加载该对象。详情请参阅获取付费墙的视觉配置。
EventListener	可选	提供一个 `AdaptyUiEventListener` 来监听付费墙事件。推荐继承 `AdaptyUiDefaultEventListener` 以简化使用。详情请参阅处理付费墙事件。
PersonalizedOfferResolver	可选	如需标识个性化定价（了解更多），请实现 `AdaptyUiPersonalizedOfferResolver`，并传入自定义逻辑：若产品价格为个性化定价则返回 true，否则返回 false。
TagResolver	可选	使用 `AdaptyUiTagResolver` 解析付费墙文本中的自定义标签。该解析器接收一个标签参数，并将其解析为对应的字符串。详情请参阅付费墙编辑工具中的自定义标签相关内容。
ObserverModeHandler	Observer 模式下必填	即你在上一步中实现的 `AdaptyUiObserverModeHandler`。
variationId	必填	实验变体的字符串标识符。可通过 `AdaptyPaywall` 对象的 `variationId` 属性获取。
transaction	必填	iOS，StoreKit 1：`SKPaymentTransaction` 对象。 iOS，StoreKit 2：Transaction 对象。 Android：购买的字符串标识符（`purchase.getOrderId()`），其中 purchase 是 billing library Purchase 类的实例。

开始呈现付费墙之前（点击展开）

设置 Adapty 与 Google Play 和 App Store 的初始集成。
安装并配置 Adapty SDK。确保将 observerMode 参数设置为 true。请参阅我们针对 Android、React Native、Flutter 和 Unity 的框架专属说明。
在 Adapty 看板中创建产品。
在 Adapty 看板中配置付费墙、为其分配产品，并使用付费墙编辑工具对其进行自定义。
在 Adapty 看板中创建版位并为其分配付费墙。
在移动应用代码中获取付费墙编辑工具创建的付费墙及其配置。

实现 AdaptyUiObserverModeHandler。AdaptyUiObserverModeHandler 的回调（onPurchaseInitiated）将在用户发起购买时通知您。您可以在此回调中触发自定义的购买流程：

val observerModeHandler =
AdaptyUiObserverModeHandler { product, paywall, paywallView, onStartPurchase, onFinishPurchase ->
    onStartPurchase()
    yourBillingClient.makePurchase(
        product,
        onSuccess = { purchase ->
            onFinishPurchase()
            //handle success
        },
        onError = {
            onFinishPurchase()
            //handle error
        },
        onCancel = {
            onFinishPurchase()
            //handle cancel
        }
    )
}

AdaptyUiObserverModeHandler observerModeHandler = (product, paywall, paywallView, onStartPurchase, onFinishPurchase) -> {
    onStartPurchase.invoke();
    yourBillingClient.makePurchase(
        product,
        purchase -> {
            onFinishPurchase.invoke();
            //handle success
        },
        error -> {
            onFinishPurchase.invoke();
            //handle error
        },
        () -> { //cancellation
            onFinishPurchase.invoke();
            //handle cancel
        }
    );
};

同时，请记得向 AdaptyUI 调用这些回调。这对于正确的付费墙行为（例如显示加载动画等）是必要的：

Kotlin 中的回调	Java 中的回调	描述
onStartPurchase()	onStartPurchase.invoke()	应调用此回调以通知 AdaptyUI 购买已开始。
onFinishPurchase()	onFinishPurchase.invoke()	应调用此回调以通知 AdaptyUI 购买已成功完成、失败或已取消。

要显示可视化付费墙，必须先对其进行初始化。为此，请调用 AdaptyUI.getPaywallView() 方法，或直接创建 AdaptyPaywallView：

val paywallView = AdaptyUI.getPaywallView(
    activity,
    viewConfiguration,
    products,
    AdaptyPaywallInsets.of(topInset, bottomInset),
    eventListener,
    personalizedOfferResolver,
    tagResolver,
    observerModeHandler,
)

//======= OR =======

val paywallView =
     AdaptyPaywallView(activity) // or retrieve it from xml
...
with(paywallView) {
    setEventListener(eventListener)
    setObserverModeHandler(observerModeHandler)
    showPaywall(
        viewConfiguration,
        products,
        AdaptyPaywallInsets.of(topInset, bottomInset),
        personalizedOfferResolver,
        tagResolver,
    )
}

AdaptyPaywallView paywallView = AdaptyUI.getPaywallView(
        activity,
        viewConfiguration,
        products,
        AdaptyPaywallInsets.of(topInset, bottomInset),
        eventListener,
        personalizedOfferResolver,
        tagResolver,
        observerModeHandler
);

//======= OR =======

AdaptyPaywallView paywallView =
  new AdaptyPaywallView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
paywallView.setEventListener(eventListener);
paywallView.setObserverModeHandler(observerModeHandler);
paywallView.showPaywall(viewConfiguration, products, AdaptyPaywallInsets.of(topInset, bottomInset), personalizedOfferResolver);

<com.adapty.ui.AdaptyPaywallView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

视图成功创建后，您可以将其添加到视图层级并显示。

请求参数：

参数	是否必填	描述
Products	可选	提供一个 `AdaptyPaywallProduct` 数组，以优化产品在屏幕上的显示时机。如果传入 `null`，AdaptyUI 将自动获取所需产品。
ViewConfiguration	必填	提供一个包含付费墙视觉详情的 `AdaptyViewConfiguration` 对象。使用 `Adapty.getViewConfiguration(paywall)` 方法加载该对象。详情请参阅获取付费墙的视觉配置。
Insets	必填	定义一个 `AdaptyPaywallInsets` 对象，包含系统栏遮挡区域的信息，用于为内容创建垂直边距。如果状态栏和导航栏都不遮挡 `AdaptyPaywallView`，则传入 `AdaptyPaywallInsets.NONE`。在系统栏覆盖部分 UI 的全屏模式下，请按表格下方的说明获取 insets。
EventListener	可选	提供一个 `AdaptyUiEventListener` 以监听付费墙事件。建议继承 `AdaptyUiDefaultEventListener` 以简化使用。详情请参阅处理付费墙事件。
PersonalizedOfferResolver	可选	如需标记个性化定价（了解更多），请实现 `AdaptyUiPersonalizedOfferResolver`，并传入自定义逻辑：若某产品的价格为个性化定价则返回 true，否则返回 false。
TagResolver	可选	使用 `AdaptyUiTagResolver` 解析付费墙文本中的自定义标签。该解析器接收标签参数并将其解析为对应字符串。详情请参阅付费墙编辑工具中的自定义标签相关文档。
ObserverModeHandler	Observer 模式下必填	您在上一步骤中实现的 `AdaptyUiObserverModeHandler`。
variationId	必填	实验变体的字符串标识符。可通过 `AdaptyPaywall` 对象的 `variationId` 属性获取。
transaction	必填	iOS，StoreKit 1：`SKPaymentTransaction` 对象。 iOS，StoreKit 2：Transaction 对象。 Android：购买记录的字符串标识符（`purchase.getOrderId()`），其中 purchase 是计费库 Purchase 类的实例。
对于全屏模式下系统状态栏遮挡部分界面的情况，请通过以下方式获取插入值：

import androidx.core.graphics.Insets
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat

//create extension function
fun View.onReceiveSystemBarsInsets(action: (insets: Insets) -> Unit) {
    ViewCompat.setOnApplyWindowInsetsListener(this) { _, insets ->
        val systemBarInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        ViewCompat.setOnApplyWindowInsetsListener(this, null)
        action(systemBarInsets)
        insets
    }
}
//and then use it with the view
paywallView.onReceiveSystemBarsInsets { insets ->
    val paywallInsets = AdaptyPaywallInsets.of(insets.top, insets.bottom)
    paywallView.setEventListener(eventListener)
    paywallView.setObserverModeHandler(observerModeHandler)
    paywallView.showPaywall(viewConfig, products, paywallInsets, personalizedOfferResolver, tagResolver)
}

import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;

...

ViewCompat.setOnApplyWindowInsetsListener(paywallView, (view, insets) -> {
    Insets systemBarInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    ViewCompat.setOnApplyWindowInsetsListener(paywallView, null);
  
    AdaptyPaywallInsets paywallInsets =
                 AdaptyPaywallInsets.of(systemBarInsets.top, systemBarInsets.bottom);
    paywallView.setEventListener(eventListener);
    paywallView.setObserverModeHandler(observerModeHandler);
    paywallView.showPaywall(viewConfiguration, products, paywallInsets, personalizedOfferResolver, tagResolver);
            
    return insets;
});

返回值：

对象	说明
`AdaptyPaywallView`	代表所请求付费墙界面的对象。

不要忘记将付费墙关联到购买交易。否则，Adapty 将无法确定购买来源的付费墙。