在 iOS SDK 中获取付费墙编辑工具付费墙及其配置

在 Adapty 控制台中使用新版付费墙编辑工具设计好付费墙的视觉部分后，您可以在移动应用中展示它。此流程的第一步是获取与版位关联的付费墙及其视图配置，具体如下所述。

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

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

如果您已使用付费墙编辑工具设计了付费墙，则无需在移动应用代码中手动处理渲染逻辑来向用户展示它。此类付费墙同时包含应展示的内容及展示方式。尽管如此，您仍需通过版位获取其 ID、获取视图配置，然后在移动应用中进行展示。

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

使用 getPaywall 方法获取付费墙：

do {
    let paywall = try await Adapty.getPaywall("YOUR_PLACEMENT_ID")
    // the requested paywall
} catch {
    // handle the error
}

Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID", locale: "en") { result in
    switch result {
        case let .success(paywall):
            // the requested paywall
        case let .failure(error):
            // handle the error
    }
}

参数：

响应参数：

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

获取付费墙后，检查其是否包含视图配置——这表明它是使用付费墙编辑工具创建的。这将指导您如何展示该付费墙。如果存在视图配置，将其作为付费墙编辑工具付费墙处理；否则，将其作为远程配置付费墙处理。

使用 getPaywallConfiguration 方法加载视图配置。

import Adapty
import AdaptyUI

guard paywall.hasViewConfiguration else {
    //  use your custom logic
    return
}

do {
    let paywallConfiguration = try await AdaptyUI.getPaywallConfiguration(
            forPaywall: paywall,
            products: products
    )
    // use loaded configuration
} catch {
    // handle the error
}

参数：

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

获取默认目标受众的付费墙以加速获取

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

为解决此问题，您可以使用 getPaywallForDefaultAudience 方法，该方法获取指定版位针对 All Users 目标受众的付费墙。但请务必理解，推荐的方式是使用 getPaywall 方法获取付费墙，详见上方的获取付费墙信息部分。

Adapty.getPaywallForDefaultAudience(placementId: "YOUR_PLACEMENT_ID", locale: "en") { result in
    switch result {
        case let .success(paywall):
            // the requested paywall
        case let .failure(error):
            // handle the error
    }
}

自定义资源

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

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

对于其他图片和视频，您需要在 Adapty 控制台中设置自定义 ID。

例如，您可以：

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

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

let customAssets: [String: AdaptyCustomAsset] = [
    // Show a local image using a custom ID
    "custom_image": .image(
        .uiImage(value: UIImage(named: "image_name")!)
    ),

    // Show a local preview image while a remote main image is loading
    "hero_image": .image(
        .remote(
            url: URL(string: "https://example.com/image.jpg")!,
            preview: UIImage(named: "preview_image")
        )
    ),

    // Show a local video with a preview image
    "hero_video": .video(
        .file(
            url: Bundle.main.url(forResource: "custom_video", withExtension: "mp4")!,
            preview: .uiImage(value: UIImage(named: "video_preview")!)
        )
    ),
]

let paywallConfig = try await AdaptyUI.getPaywallConfiguration(
    forPaywall: paywall,
    assetsResolver: customAssets
)

设置开发者定义的计时器

要在移动应用中使用自定义计时器，请创建一个遵循 AdaptyTimerResolver 协议的对象。该对象定义每个自定义计时器的渲染方式。如果您愿意，也可以直接使用 [String: Date] 字典，因为它已经符合该协议。以下是一个示例：

@MainActor
struct AdaptyTimerResolverImpl: AdaptyTimerResolver {
    func timerEndAtDate(for timerId: String) -> Date {
        switch timerId {
        case "CUSTOM_TIMER_6H":
            Date(timeIntervalSinceNow: 3600.0 * 6.0) // 6 hours
        case "CUSTOM_TIMER_NY":
            Calendar.current.date(from: DateComponents(year: 2025, month: 1, day: 1)) ?? Date(timeIntervalSinceNow: 3600.0)
        default:
            Date(timeIntervalSinceNow: 3600.0) // 1 hour
        }
    }
}

在此示例中，CUSTOM_TIMER_NY 和 CUSTOM_TIMER_6H 是您在 Adapty 控制台中设置的开发者定义计时器的 Timer ID。timerResolver 确保您的应用使用正确的值动态更新每个计时器。例如：

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