展示流程与付费墙 - Unity
如果你已经创建了流程或使用旧版付费墙编辑工具创建了付费墙,则无需在移动应用代码中手动处理其渲染逻辑来向用户展示。这类流程或付费墙本身已包含展示内容及展示方式的完整定义。
本指南介绍由 Adapty 渲染的流程和付费墙。自定义付费墙和 Observer 模式 的处理方式有所不同。
- 要展示自定义付费墙,请参阅展示自定义付费墙。
- 要在 Observer mode 下展示流程,请参阅在 Observer mode 下展示流程。
如需获取下方使用的 view 对象,请参阅获取流程与付费墙。
要显示流程或付费墙,请对由 CreateFlowView 方法创建的 view 调用 view.Present() 方法。默认情况下,关闭的视图会被销毁。若要再次显示该流程,请再次调用 CreateFlowView 创建新的 view 实例,或在关闭时保留该视图。
重复使用已销毁的 view 会导致错误。
view.Present((error) => {
// handle the error
});想查看 Adapty SDK 集成到移动应用的真实示例?请参阅我们的示例应用,其中演示了完整的配置流程,包括显示付费墙、发起购买以及其他基本功能。
保存视图以便再次呈现
保存视图功能从 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() 释放它。
如果你使用付费墙编辑工具自定义了付费墙,则无需在移动应用代码中手动处理其渲染逻辑来向用户展示它。这类付费墙已包含展示内容和展示方式的完整配置。
本指南适用于旧版付费墙编辑工具,需要 Adapty SDK 3.3.0 或更高版本。
要展示自定义付费墙,请参阅展示自定义付费墙。
要展示付费墙,请在由 CreatePaywallView 方法创建的 view 上调用 view.Present() 方法。每个 view 只能使用一次。如果需要再次展示付费墙,请再次调用 CreatePaywallView 创建一个新的 view 实例。
重复使用同一个 view 而不重新创建,可能会导致 AdaptyUIError.viewAlreadyPresented 错误。
view.Present((error) => {
// handle the error
});想查看 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
});