在 Unity SDK 中获取远程配置付费墙的付费墙和产品

在展示远程配置和自定义付费墙之前，您需要先获取相关信息。请注意，本主题涉及远程配置和自定义付费墙。如需了解如何获取在 Flow Builder 或 Paywall Builder 中自定义的流程或付费墙，请参阅获取流程与付费墙。

获取流程信息

在 Adapty 中，产品作为 App Store 和 Google Play 产品的组合。这些跨平台产品被整合到流程和付费墙中，让你能够在移动应用的特定版位中展示它们。

要展示产品，你需要通过 GetFlow 方法从某个版位获取 AdaptyFlow。

Adapty.GetFlow(
    "YOUR_PLACEMENT_ID",
    AdaptyPlacementFetchPolicy.Default,
    TimeSpan.FromSeconds(5),
    (flow, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // flow - the requested flow
    }
);

不要硬编码产品 ID！由于流程是远程配置的，可用产品的数量以及特殊优惠（如免费试用）都可能随时间变化。请确保你的代码能够处理这些情况。

例如，如果你最初获取到 2 个产品，应用应显示这 2 个产品；但如果之后获取到 3 个产品，应用无需修改任何代码即可显示全部 3 个产品。唯一需要硬编码的是版位 ID。

返回参数：

获取产品

获取流程后，您可以查询与其对应的产品数组：

Adapty.GetPaywallProducts(flow, (products, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    // products - the requested products array
});

响应参数：

在实现自定义流程设计时，你可能需要访问 AdaptyPaywallProduct 对象中的这些属性。下面列出了最常用的属性。

使用默认目标受众流程加快流程获取速度

通常情况下，流程的获取几乎是即时完成的，无需担心速度问题。但是，当你的版位和目标受众数量较多，且用户网络连接较弱时，流程获取可能会比预期更慢。在这种情况下，你可能希望展示一个默认流程，以确保良好的用户体验，而不是什么都不显示。

要解决这个问题，您可以使用 GetFlowForDefaultAudience 方法，该方法会获取指定版位中 All Users 目标受众的流程。但请务必了解，推荐的方式是通过 GetFlow 方法来获取流程，详见上方的获取流程信息章节。

Adapty.GetFlowForDefaultAudience(
    "YOUR_PLACEMENT_ID",
    AdaptyPlacementFetchPolicy.Default,
    (flow, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // flow - the requested flow
    }
);

在展示远程配置和自定义付费墙之前，您需要先获取相关信息。请注意，本主题涉及远程配置和自定义付费墙。如需了解如何获取付费墙编辑工具自定义的付费墙，请参阅获取付费墙编辑工具的付费墙及其配置。

获取付费墙信息

在 Adapty 中，产品是 App Store 和 Google Play 产品的组合。这些跨平台产品被集成到付费墙中，使您能够在特定的移动应用版位中展示它们。

要展示产品，您需要使用 getPaywall 方法从某个版位中获取付费墙。

Adapty.GetPaywall("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

不要硬编码产品 ID！由于付费墙是远程配置的，可用产品、产品数量以及特殊优惠（如免费试用）可能随时发生变化。请确保您的代码能够处理这些情况。
例如，如果您最初获取到 2 个产品，您的应用应显示这 2 个产品。但如果您后来获取到 3 个产品，您的应用应显示所有 3 个产品，而无需修改任何代码。唯一需要硬编码的是版位 ID。

响应参数：

获取产品

获取付费墙后，您可以查询与之对应的产品数组：

Adapty.GetPaywallProducts(paywall, (products, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // products - the requested products array
});

响应参数：

在实现自定义付费墙设计时，您可能需要访问 AdaptyPaywallProduct 对象中的这些属性。以下列出了最常用的属性，但请参阅链接文档以获取所有可用属性的完整详情。

使用默认目标受众付费墙加速付费墙获取

通常情况下，付费墙几乎可以即时获取，因此您无需担心加速此过程。但是，如果您拥有大量目标受众和付费墙，且用户的网络连接较弱，获取付费墙可能需要比预期更长的时间。在这种情况下，您可能希望显示默认付费墙，以确保流畅的用户体验，而不是完全不显示付费墙。

要解决此问题，您可以使用 GetPaywallForDefaultAudience 方法，该方法会获取指定版位中 All Users 目标受众的付费墙。但请务必了解，推荐的方式是通过 getPaywall 方法获取付费墙，详见上方获取付费墙章节。

Adapty.GetPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

参数：