在 Flutter SDK 中获取旧版付费墙编辑工具付费墙
在 Adapty 看板中使用付费墙编辑工具完成付费墙的视觉设计后,您可以在 Flutter 应用中展示它。此过程的第一步是获取与版位关联的付费墙及其视图配置,具体如下所述。
本指南仅适用于旧版付费墙编辑工具付费墙,需要 SDK v2.x 或更早版本。获取付费墙的流程因付费墙设计版本及远程配置付费墙的不同而有所差异。
- 如需获取新版付费墙编辑工具付费墙,请参阅获取新版付费墙编辑工具付费墙及其配置。
- 如需获取远程配置付费墙,请参阅获取远程配置付费墙的付费墙和产品。
在 Flutter 应用中展示付费墙之前(点击展开)
- 在 Adapty 看板中创建产品。
- 在 Adapty 看板中创建付费墙并将产品添加到其中。
- 在 Adapty 看板中创建版位并将付费墙添加到其中。
- 在 Flutter 应用中安装 Adapty SDK 和 AdaptyUI SDK。
获取使用付费墙编辑工具设计的付费墙
如果您已使用付费墙编辑工具设计了付费墙,则无需在 Flutter 应用代码中手动渲染即可向用户展示。此类付费墙包含展示内容及展示方式的完整信息。不过,您仍需通过版位获取其 ID、视图配置,然后在 Flutter 应用中进行展示。
为确保最佳性能,请务必尽早获取付费墙及其视图配置,以便在向用户展示之前留出足够时间完成图片下载。
使用 getPaywall 方法获取付费墙:
try {
final paywall = await Adapty().getPaywall(id: "YOUR_PLACEMENT_ID", locale: "en");
// the requested paywall
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}
| 参数 | 是否必填 | 描述 |
|---|---|---|
| placementId | 必填 | 目标版位的标识符。这是您在 Adapty 看板中创建版位时指定的值。 |
| locale | 可选 默认值: | 付费墙本地化的标识符。此参数应为由一个或两个子标签组成的语言代码,子标签之间用连字符(-)分隔。第一个子标签表示语言,第二个子标签表示地区。 示例: 有关语言区域代码及推荐使用方式的更多信息,请参阅本地化与语言区域代码。 |
请勿硬编码产品 ID。 唯一需要硬编码的 ID 是版位 ID。付费墙通过远程配置进行管理,因此产品数量和可用优惠随时可能发生变化。您的应用必须动态处理这些变化——如果付费墙今天返回两个产品,明天返回三个,应在无需修改代码的情况下全部展示。
响应参数:
| 参数 | 描述 |
|---|---|
| Paywall | 一个 AdaptyPaywall 对象,包含产品 ID 列表、付费墙标识符、远程配置及其他若干属性。 |
获取使用付费墙编辑工具设计的付费墙视图配置
获取付费墙后,请检查其是否包含 viewConfiguration,该字段的存在表明此付费墙是通过付费墙编辑工具创建的。这将指导您如何展示付费墙。如果存在 viewConfiguration,请将其作为付费墙编辑工具付费墙处理;如果不存在,则将其作为远程配置付费墙处理。
对于 Flutter,当您使用 AdaptyUI.showPaywall() 方法展示付费墙时,视图配置将自动处理。