Unity SDKでオンボーディングを表示する

Warning

オンボーディングは Adapty SDK v4 以降で非推奨となりました。 代わりにフローを構築してください。オンボーディングは WebView 内で動作しますが、フローはデバイス上でネイティブにレンダリングされるため、アニメーションがスムーズで、一貫したネイティブの外観と操作感、高速な読み込み、そして WebView ランタイムへの依存がありません。

ビルダーを使ってオンボーディングをカスタマイズした場合、Unity アプリのコード内でレンダリング処理を実装しなくても、ユーザーに表示できます。そのようなオンボーディングには、表示する内容と表示方法の両方が含まれています。

始める前に、以下を確認してください:

  1. Adapty Unity SDK 3.14.0 以降をインストール済みであること。
  2. オンボーディングを作成済みであること。
  3. オンボーディングをプレースメントに追加済みであること。

オンボーディングを表示するには、CreateOnboardingView メソッドで作成した view に対して view.Present() メソッドを使用します。各 view は一度しか使用できません。ペイウォールを再度表示する必要がある場合は、CreateOnboardingView をもう一度呼び出して新しい view インスタンスを作成してください。

Warning

同じviewを再利用すると(再作成せずに)、AdaptyUIError.viewAlreadyPresentedエラーが発生する場合があります。

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

iOS表示スタイルの設定

Present()メソッドにiosPresentationStyleパラメーターを渡すことで、iOSでのオンボーディングの表示方法を設定できます。パラメーターにはAdaptyUIIOSPresentationStyle.FullScreen(デフォルト)またはAdaptyUIIOSPresentationStyle.PageSheetを指定できます。

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

オンボーディングでのリンクの開き方のカスタマイズは、Adapty SDK v3.15以降でサポートされています。

デフォルトでは、オンボーディング内のリンクはアプリ内ブラウザで開かれ、アプリを切り替えることなくウェブページをアプリ内で表示できるシームレスな体験を提供します。

代わりに外部ブラウザでリンクを開くには、CreateOnboardingViewメソッドにAdaptyWebPresentation.ExternalBrowserを渡してください。

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 - デバイスの外部ブラウザでリンクを開く