在 Kotlin Multiplatform SDK 中获取用户引导

在 Adapty 看板中使用编辑工具完成用户引导的视觉设计之后，您可以在 Kotlin Multiplatform 应用中展示它。第一步是获取与版位关联的用户引导及其视图配置，具体步骤如下所示。

开始之前，请确认：

1. 已安装 Adapty Kotlin Multiplatform SDK 3.15.0 或更高版本。
2. 已创建用户引导。
3. 已将用户引导添加到版位。

获取用户引导

当你使用我们的无代码编辑工具创建用户引导后，它会以容器的形式存储，其中包含应用需要获取并展示的配置信息。该容器负责管理整个体验——包括显示哪些内容、如何呈现，以及如何处理用户交互（如测验答案或表单输入）。容器还会自动追踪数据分析事件，无需单独实现视图追踪。

为了获得最佳性能，建议尽早获取用户引导配置，以便图片有足够的时间在展示给用户之前完成下载。

要获取用户引导，请使用 getOnboarding 方法：

Adapty.getOnboarding(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    // the requested paywall
}.onError { error ->
    // handle the error
}

参数：

响应参数：

使用默认目标受众用户引导加速获取用户引导

通常情况下，用户引导的获取几乎是即时完成的，无需担心速度问题。但当您配置了大量目标受众和用户引导，且用户网络连接较差时，获取用户引导可能会比预期花费更长时间。在这种情况下，您可能希望展示一个默认用户引导，以确保流畅的用户体验，而不是什么都不显示。

要解决这个问题，您可以使用 getOnboardingForDefaultAudience 方法，该方法会获取指定版位中针对 All Users 目标受众的用户引导。但请务必了解，推荐的方式是通过 getOnboarding 方法来获取用户引导，详见上文的获取用户引导章节。

Adapty.getOnboardingForDefaultAudience(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
).onSuccess { paywall ->
    // the requested paywall
}.onError { error ->
    // handle the error
}

参数：