在 Unity SDK 中展示用户引导

Warning

从 Adapty SDK v4 开始，用户引导功能已弃用。 请改用流程：与运行在 WebView 中的用户引导不同，流程直接在设备上原生渲染——动画更流畅、外观更统一、加载更快，且无需依赖 WebView 运行时。

如果你已经使用编辑工具自定义了用户引导，就无需在 Unity 应用代码中单独处理其渲染逻辑来向用户展示它。这类用户引导已经包含了应展示的内容以及展示方式的完整配置。

开始之前，请确保：

已安装 Adapty Unity SDK 3.14.0 或更高版本。
已创建用户引导。
已将用户引导添加到版位。

要显示用户引导，请对 CreateOnboardingView 方法创建的 view 调用 view.Present() 方法。每个 view 只能使用一次。如需再次显示付费墙，请再次调用 CreateOnboardingView 创建新的 view 实例。

Warning

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

view.Present((presentError) => {
    if (presentError != null) {
        // handle the error
    }
};

配置 iOS 展示样式

通过将 iosPresentationStyle 参数传递给 Present() 方法，可配置用户引导在 iOS 上的展示方式。该参数接受 AdaptyUIIOSPresentationStyle.FullScreen（默认值）或 AdaptyUIIOSPresentationStyle.PageSheet 值。

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

自定义用户引导中链接的打开方式

Important

自定义用户引导中链接打开方式的功能从 Adapty SDK v3.15 开始支持。

默认情况下，用户引导中的链接会在应用内浏览器中打开，让用户无需切换应用即可直接查看网页内容，体验更加流畅。

如需改为在外部浏览器中打开链接，请将 AdaptyWebPresentation.ExternalBrowser 传入 CreateOnboardingView 方法：

AdaptyUI.CreateOnboardingView(
    onboarding,
    AdaptyWebPresentation.ExternalBrowser, // default — InAppBrowser
    (view, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // present the onboarding view
        view.Present((presentError) => {
            if (presentError != null) {
                // handle the error
            }
        });
    }
);

可用选项：

AdaptyWebPresentation.InAppBrowser - 在应用内浏览器中打开链接（默认）
AdaptyWebPresentation.ExternalBrowser - 在设备的外部浏览器中打开链接