在观察者模式下展示流程 - Kotlin Multiplatform
如果你使用观察者模式,则需要自行处理购买逻辑。但你可以将付费墙 UI 委托给 Flow & 付费墙编辑工具。
在编辑工具中设计屏幕,Adapty SDK 将其原生渲染。随时更新文案、布局和定价,无需发布新版本。
本指南介绍如何展示流程并处理购买回调。如果由 Adapty 为您完成购买,请参阅展示流程与付费墙。
开始之前
你需要:
- Adapty Kotlin Multiplatform SDK 4.0(测试版)或更高版本:早期版本无法渲染流程。如需迁移现有应用,请参阅迁移指南。
- 在配置构建器中调用
withObserverMode(true):请参阅 Kotlin Multiplatform SDK 安装指南。 - 初始商店集成:完成 Adapty 与 App Store 和 Google Play 的集成配置。
- 已发布的含产品的流程:在流程与付费墙编辑工具中构建,并为其分配产品。
- 流程版位:创建一个版位并将你的流程分配给它。
- 在应用中获取流程:在展示流程之前,获取流程及其配置。
实现
在 Observer 模式下,SDK 不会代替你发起购买。当用户点击 Adapty 渲染的流程中的购买或恢复按钮时,SDK 会调用你的 AdaptyUIObserverModeResolver——请在其中用你自己的代码执行购买或恢复操作。
-
实现
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() } }observerModeDidInitiatePurchase方法会在用户发起购买时通知您,observerModeDidInitiateRestore则会在用户发起恢复购买时通知您。请在收到通知后触发您的自定义购买或恢复流程。
此外,请记得调用以下回调,以便将购买或恢复流程的进度通知给 AdaptyUI。这对于正确的流程行为(例如显示加载动画等)是必要的:
| 回调 | 描述 |
|---|---|
| onStartPurchase() | 调用此回调以通知 AdaptyUI 购买已开始。 |
| onFinishPurchase() | 调用此回调以通知 AdaptyUI 购买已完成。 |
| onStartRestore() | 调用此回调以通知 AdaptyUI 恢复已开始。 |
| onFinishRestore() | 调用此回调以通知 AdaptyUI 恢复已完成。 |
流程在您的代码运行期间保持打开状态。购买或恢复购买成功后,请自行关闭它。
After onFinishPurchase(), the flow runs the same outcome actions whatever happened, a canceled purchase included: the When pending actions on iOS and the When succeeded actions on Android. Show any screen that depends on the purchase result, such as a thank-you screen, from your code: only your code knows the result. After onFinishRestore(), the flow runs the When restore completed actions, whatever happened.
-
Register the resolver before presenting any screen:
import com.adapty.kmp.AdaptyUI AdaptyUI.setObserverModeResolver(MyObserverModeResolver())如果没有注册解析器,流程视图将无法把购买操作移交给您的代码,用户点击购买按钮时将不会有任何反应。
-
按常规方式创建并展示流程视图:获取流程并创建其视图,然后展示它。无需额外参数——一旦注册了解析器,所有 Adapty 渲染的流程都会通过该解析器处理购买和恢复操作。
不要忘记上报交易并将其与付费墙关联。否则,Adapty 将无法识别该交易,也无法确定购买来源的付费墙。