在 Unity SDK 中展示用户引导

用户引导功能在 SDK v4 中已弃用，将在未来版本中移除。 该功能不再接受修复或改进。请改用流程：与在 WebView 中运行的用户引导不同，流程直接在设备上原生渲染，动画更流畅、原生外观一致、加载速度更快，且不依赖 WebView 运行时。请参阅获取流程与付费墙和展示流程与付费墙快速上手。

如果你已使用编辑工具自定义了用户引导，则无需在 Unity 应用代码中手动处理其渲染逻辑来向用户展示它。这类用户引导本身已包含展示内容与展示方式的完整定义。

在开始之前，请确保：

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

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

在未重新创建的情况下复用同一个 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
});

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

自定义用户引导中链接打开方式的功能从 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 - 在设备的外部浏览器中打开链接