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