在 Unity SDK 中展示用户引导

如果你已经在编辑工具中自定义了用户引导,就不需要在 Unity 应用代码中另行处理渲染逻辑——该用户引导已经包含了展示内容和展示方式的完整配置。

开始之前,请确保:

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

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

在未重新创建 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 - 在设备的外部浏览器中打开链接