展示流程与付费墙 - Unity

展示流程与付费墙
✦
流程 在 Flow & Paywall Builder 中构建——在设备上原生渲染,无需 WebView
✦
旧版 Paywall Builder 付费墙 所有在旧版 Paywall Builder 中构建的内容

如果你已经创建了流程或使用旧版付费墙编辑工具创建了付费墙,则无需在移动应用代码中手动处理其渲染逻辑来向用户展示。这类流程或付费墙本身已包含展示内容及展示方式的完整定义。

Warning

本指南介绍由 Adapty 渲染的流程和付费墙。自定义付费墙和 Observer 模式 的处理方式有所不同。

如需获取下方使用的 view 对象,请参阅获取流程与付费墙。

要显示流程或付费墙,请对由 CreateFlowView 方法创建的 view 调用 view.Present() 方法。默认情况下,关闭的视图会被销毁。若要再次显示该流程,请再次调用 CreateFlowView 创建新的 view 实例,或在关闭时保留该视图。

Warning

重复使用已销毁的 view 会导致错误。

view.Present((error) => {
    // handle the error
});
Tip

想查看 Adapty SDK 集成到移动应用的真实示例?请参阅我们的示例应用,其中演示了完整的配置流程,包括显示付费墙、发起购买以及其他基本功能。

保存视图以便再次呈现

Info

保存视图功能从 SDK 4.3.0 版本开始支持。

view.Dismiss() 会将视图从内存中释放。如果想保留视图,请将 false 作为 destroy 参数传入:

view.Dismiss(false, (error) => {
    // handle the error
});

再次呈现该视图时,用户会回到离开时的界面,流程已积累的状态也会完整保留。视图的 Id 保持不变,因此其事件仍会以相同的 view.Id 传递给你的监听器。

保留的视图会一直占用内存,直到你主动释放它。当不再需要时,调用 view.Destroy():

view.Destroy((error) => {
    // handle the error
});

Destroy() 会先关闭仍在屏幕上显示的视图,再释放它。它同样适用于已创建但从未展示的视图,以及用户在 iOS 上向下滑动关闭的页面弹出式视图。不要在常规 Dismiss() 之后调用它:该视图已经被释放,再次调用会失败。

当用户点击 Close 按钮时,如需保留视图而不销毁它,请在 Close 动作处理器中使用 destroy: false 来关闭它。FlowViewDidPerformAction 方法会在应用中所有流程和付费墙上触发,因此需要通过对比 view.Id 来确定哪个视图是你打算再次展示的。在创建视图时将其存入一个字段,以便后续进行对比并重新展示:

private AdaptyUIFlowView keptView;

void CreateKeptView(AdaptyFlow flow) {
    AdaptyUI.CreateFlowView(flow, new AdaptyUICreateFlowViewParameters(), (view, error) => {
        if (error != null) {
            // handle the error
            return;
        }
        keptView = view;
    });
}

public void FlowViewDidPerformAction(
    AdaptyUIFlowView view,
    AdaptyUIUserAction action
) {
    switch (action.Type) {
        case AdaptyUIUserActionType.Close:
            view.Dismiss(view.Id != keptView?.Id, null);
            break;
        default:
            // handle other events
            break;
    }
}

保留好 view:你需要用它再次呈现流程或付费墙,并通过 Destroy() 释放它。调用 keptView.Destroy() 后,将 keptView 置为 null,这样上面的比较就不会匹配到已释放的视图。任何其他 view.Dismiss() 调用也会释放视图,包括 FlowViewDidReceiveError 中的调用。视图出错后,请使用 CreateFlowView 创建新视图。

显示对话框

在 Android 上展示流程或付费墙时,请使用此方法代替原生的 alert 对话框。在 Android 上,普通的 alert 会显示在流程视图的后面,导致用户无法看到。该方法可确保在所有平台上对话框都能正确显示在流程的上方。

var dialog = new AdaptyUIDialogConfiguration()
    .SetTitle("Close this screen?")
    .SetContent("You will lose access to exclusive offers.")
    .SetDefaultActionTitle("Stay")
    .SetSecondaryActionTitle("Close");

AdaptyUI.ShowDialog(view, dialog, (action, error) => {
    if (error == null) {
        if (action == AdaptyUIDialogActionType.Secondary) {
            // User confirmed - close the flow
            view.Dismiss((error) => {
                // handle the error
            });
        }
        // If primary - do nothing, user stays
    }
});

配置 iOS 呈现样式

通过向 Present() 方法传递 iosPresentationStyle 参数,可以配置流程或付费墙在 iOS 上的呈现方式。该参数接受 AdaptyUIIOSPresentationStyle.FullScreen(默认值)或 AdaptyUIIOSPresentationStyle.PageSheet。

view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
    // handle the error
});

用户可以通过向下滑动页面来关闭它。关闭后,视图仍保留在内存中,不会调用 Dismiss():可以再次显示,或者在 SDK 4.3.0 及更高版本中,使用 Destroy() 释放它。

如果你使用付费墙编辑工具自定义了付费墙,则无需在移动应用代码中手动处理其渲染逻辑来向用户展示它。这类付费墙已包含展示内容和展示方式的完整配置。

Warning

本指南适用于旧版付费墙编辑工具,需要 Adapty SDK 3.3.0 或更高版本。

要展示自定义付费墙,请参阅展示自定义付费墙。

要展示付费墙,请在由 CreatePaywallView 方法创建的 view 上调用 view.Present() 方法。每个 view 只能使用一次。如果需要再次展示付费墙,请再次调用 CreatePaywallView 创建一个新的 view 实例。

Warning

重复使用同一个 view 而不重新创建,可能会导致 AdaptyUIError.viewAlreadyPresented 错误。

view.Present((error) => {
  // handle the error
});
Tip

想查看 Adapty SDK 集成到移动应用的真实示例?请参阅我们的示例应用,其中演示了完整的配置流程,包括显示付费墙、发起购买以及其他基本功能。

显示对话框

当付费墙视图在 Android 上展示时,请使用此方法代替原生弹窗。在 Android 上,普通弹窗会显示在付费墙视图后方,导致用户看不到。该方法可确保在所有平台上对话框正确显示于付费墙之上。

var dialog = new AdaptyUIDialogConfiguration()
    .SetTitle("Close paywall?")
    .SetContent("You will lose access to exclusive offers.")
    .SetDefaultActionTitle("Stay")
    .SetSecondaryActionTitle("Close");

AdaptyUI.ShowDialog(view, dialog, (action, error) => {
    if (error == null) {
        if (action == AdaptyUIDialogActionType.Secondary) {
            // User confirmed - close the paywall
            view.Dismiss();
        }
        // If primary - do nothing, user stays
    }
});

配置 iOS 展示样式

通过向 Present() 方法传递 iosPresentationStyle 参数,配置付费墙在 iOS 上的展示方式。该参数接受 AdaptyUIIOSPresentationStyle.FullScreen(默认值)或 AdaptyUIIOSPresentationStyle.PageSheet。

view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
    // handle the error
});