获取流程与付费墙 - Unity

在设计好流程或付费墙编辑工具付费墙之后，您可以在移动应用中展示它。第一步是获取与版位关联的流程或付费墙及其视图配置，如下所述。

获取流程/付费墙

如果你已经使用流程编辑工具或付费墙编辑工具设计好了流程或付费墙，则无需在移动端代码中手动处理其渲染逻辑来向用户展示。这类流程或付费墙本身已包含展示内容和展示方式的完整配置。不过，你仍需通过版位获取其 ID 及视图配置，然后在移动应用中将其呈现出来。

为确保最佳性能，应尽早获取流程或付费墙及其视图配置，以便在向用户展示之前有足够的时间下载图片。

使用 GetFlow 方法获取流程或付费墙：

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

        // flow - the requested flow/paywall
    }
);

参数：

响应参数：

获取视图配置

获取流程或付费墙后，使用 CreateFlowView 方法一步完成视图配置的加载和视图的创建。无需单独检查任何标志：如果版位是在 Flow Builder（流程）或付费墙编辑工具（付费墙）中设计的，CreateFlowView 会返回可直接展示的视图。如果版位是没有编辑工具 UI 的自定义付费墙，CreateFlowView 将返回错误——将其作为远程配置付费墙处理。

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetPreloadProducts(true)
    .SetLoadTimeout(TimeSpan.FromSeconds(5));

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    if (error != null) {
        // the flow has no view configured, or view creation failed
        return;
    }

    // use view
});

加载完成后，展示流程或付费墙。

为默认目标受众获取流程或付费墙以加快加载速度

通常，流程和付费墙的加载几乎是即时的，无需担心速度问题。但如果您的目标受众和版位数量较多，且用户网络状况较差，加载流程或付费墙的时间可能会比预期更长。在这种情况下，您可能希望显示一个默认流程或付费墙，以确保用户体验流畅，而不是什么都不显示。

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

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

        // flow - the requested flow
    }
);

自定义资源

要自定义流程或付费墙中的图片和视频，请实现自定义资源。

主图片和视频具有预定义的 ID：hero_image 和 hero_video。在自定义资源包中，你通过这些 ID 定位对应元素并自定义其行为。

对于其他图片和视频，你需要在 Adapty 看板中设置自定义 ID。

例如，你可以：

• 向特定用户显示不同的图片或视频。
• 在远程主图片加载时，先显示本地预览图片。
• 在视频播放前显示预览图片。

以下是如何通过简单字典提供自定义资源的示例：

var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
    { "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
    { "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetCustomAssets(customAssets)
    .SetLoadTimeout(TimeSpan.FromSeconds(3));

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    // handle the result
});

设置开发者自定义计时器

要在 Unity 应用中使用自定义计时器，请将计时器 ID 及其结束日期的字典传入 SetCustomTimers 方法。示例如下：

var customTimers = new Dictionary<string, DateTime> {
    { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
    { "CUSTOM_TIMER_NY", new DateTime(2026, 1, 1) }
};

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetCustomTimers(customTimers)
    .SetLoadTimeout(TimeSpan.FromSeconds(3));

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    // handle the result
});

在此示例中，CUSTOM_TIMER_NY 和 CUSTOM_TIMER_6H 是您在 Adapty 看板中设置的开发者自定义计时器的 Timer ID。计时器解析器确保您的应用动态地为每个计时器更新正确的值。例如：

• CUSTOM_TIMER_NY：距计时器结束时间（如元旦）的剩余时间。
• CUSTOM_TIMER_6H：用户打开流程或付费墙时开始计算的 6 小时倒计时的剩余时间。

在 Adapty 看板中使用新版付费墙编辑工具完成付费墙的视觉设计后，你可以在移动应用中展示它。第一步是获取与版位关联的付费墙及其视图配置，具体步骤如下。

请注意，本主题针对使用付费墙编辑工具自定义的付费墙。如果您是手动实现付费墙，请参阅在移动应用中为远程配置付费墙获取付费墙和产品主题。

获取使用付费墙编辑工具设计的付费墙

如果你已经使用付费墙编辑工具设计了付费墙，则无需在移动应用代码中手动渲染并展示给用户。这类付费墙已包含展示内容和展示方式的完整配置。不过，你仍需通过版位获取其 ID 和视图配置，然后在移动应用中将其呈现出来。 为确保最佳性能，请尽早获取付费墙及其视图配置，以便在向用户展示之前留出足够时间完成图片下载。

使用 GetPaywall 方法获取付费墙：

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

参数：

获取使用付费墙编辑工具设计的付费墙视图配置

获取付费墙后，检查其是否包含 ViewConfiguration——该字段表明该付费墙是通过付费墙编辑工具创建的，并将指引你如何展示该付费墙。如果存在 ViewConfiguration，则将其视为付费墙编辑工具付费墙；如果不存在，则将其作为远程配置付费墙处理。 在 Unity SDK 中，直接调用 CreatePaywallView 方法，无需手动获取视图配置。

var parameters = new AdaptyUICreatePaywallViewParameters()
  .SetPreloadProducts(preloadProducts)
  .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
  // handle the result
});

参数：

获取视图后，展示付费墙。

自定义资源

要自定义付费墙中的图片和视频，请实现自定义资源。

主图和视频有预定义的 ID：hero_image 和 hero_video。在自定义资源包中，你通过这些 ID 来定位并自定义相应元素的行为。

对于其他图片和视频，你需要在 Adapty 看板中设置自定义 ID。

例如，你可以：

• 为部分用户展示不同的图片或视频。
• 在远程主图加载时显示本地预览图。
• 在播放视频前先显示预览图。

以下是如何通过简单字典提供自定义资源的示例：

var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
    { "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
    { "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};

var parameters = new AdaptyUICreatePaywallViewParameters()
    .SetCustomAssets(customAssets)
    .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
    // handle the result
});

设置开发者自定义计时器

要在 Unity 应用中使用自定义计时器，可以直接向 SetCustomTimers 方法传入一个包含计时器 ID 及其结束时间的字典。示例如下：

var customTimers = new Dictionary<string, DateTime> {
    { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
    { "CUSTOM_TIMER_NY", new DateTime(2025, 1, 1) }
};

var parameters = new AdaptyUICreatePaywallViewParameters()
    .SetCustomTimers(customTimers)
    .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
    // handle the result
});

在此示例中，CUSTOM_TIMER_NY 和 CUSTOM_TIMER_6H 是您在 Adapty 看板中设置的开发者自定义计时器的计时器 ID。计时器解析器确保您的应用为每个计时器动态更新正确的值。例如：

• CUSTOM_TIMER_NY：距计时器结束时间（如元旦）的剩余时间。
• CUSTOM_TIMER_6H：从用户打开付费墙时开始的 6 小时倒计时的剩余时间。

通过默认受众付费墙加速付费墙加载

通常情况下，付费墙的加载几乎是即时完成的，无需担心速度问题。但如果你配置了大量目标受众和付费墙，且用户的网络连接较差，付费墙的加载时间可能会超出预期。在这种情况下，你可能希望先展示一个默认付费墙，以保证流畅的用户体验，而不是让用户看到空白页面。 为解决这个问题，你可以使用 GetPaywallForDefaultAudience 方法，该方法会获取指定版位针对 All Users 目标受众的付费墙。但请务必了解，推荐的做法是使用 getPaywall 方法来获取付费墙，详见上方获取付费墙部分。

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

参数：