Android SDKでのオンボーディングの表示

SDK v4（ベータ版）以降、オンボーディングのより強力な代替手段としてフローを構築できます。オンボーディングが WebView 内で動作するのとは異なり、フローはデバイス上でネイティブにレンダリングされるため、よりスムーズなアニメーション、一貫した Android のルック＆フィール、高速なロード時間、そして WebView ランタイムへの依存がなくなります。はじめるには、フロー＆ペイウォールの取得とフロー＆ペイウォールの表示をご覧ください。

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

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

オンボーディングビルダーを使ってオンボーディングをカスタマイズした場合、ユーザーに表示するためのレンダリングコードをアプリ側で実装する必要はありません。このようなオンボーディングには、表示する内容と表示方法の両方が含まれています。デバイス画面にビジュアルオンボーディングを表示するには、まず設定が必要です。AdaptyUI.getOnboardingView() メソッドを呼び出すか、OnboardingView を直接作成してください：

val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener
)

val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener
)

AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener
);

AdaptyOnboardingView onboardingView = new AdaptyOnboardingView(activity);
onboardingView.show(onboardingConfig, eventListener);

<com.adapty.ui.onboardings.AdaptyOnboardingView
        android:id="@+id/onboardingView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

ビューが正常に作成されたら、ビュー階層に追加してデバイス画面に表示できます。

リクエストパラメータ:

パラメーター	必須/任意	説明
viewConfig	必須	`AdaptyUI.getOnboardingConfiguration()` から取得したオンボーディング設定
eventListener	必須	オンボーディングイベントを処理するための `AdaptyOnboardingEventListener` の実装。詳細はオンボーディングイベントの処理を参照してください。

ローディングインジケーターの色を変更する

以下の方法でローディングインジケーターのデフォルトカラーをオーバーライドできます：


<style name="AppTheme" parent="android:Theme.Material.Light.NoActionBar">
    
    <item name="adapty_progressIndicatorColor">@color/yourColor</item>
</style>

スプラッシュ画面とオンボーディング間のスムーズなトランジションを追加する

デフォルトでは、スプラッシュ画面とオンボーディングの間に、オンボーディングが完全に読み込まれるまでローディング画面が表示されます。ただし、トランジションをよりスムーズにしたい場合は、スプラッシュ画面を延長するか、別のものを表示するかをカスタマイズできます。

これを行うには、res/layout に adapty_onboarding_placeholder_view.xml を作成し、そこにプレースホルダー（オンボーディングの読み込み中に表示する内容）を定義します。プレースホルダーを定義すると、オンボーディングはバックグラウンドで読み込まれ、準備が整い次第自動的に表示されます。

セーフエリアのパディングを無効にする

デフォルトでは、オンボーディングビューはステータスバーやナビゲーションバーなどのシステム UI 要素を避けるため、セーフエリアのパディングを自動的に適用します。ただし、この動作を無効にしてレイアウトを完全に制御したい場合は、safeAreaPaddings パラメータを false に設定することで対応できます。

val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener,
    safeAreaPaddings = false
)

val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener,
    safeAreaPaddings = false
)

AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener,
    false
);

AdaptyOnboardingView onboardingView = new AdaptyOnboardingView(activity);
onboardingView.show(onboardingConfig, eventListener, false);

または、アプリにブールリソースを追加することで、この動作をグローバルに制御することもできます：


<resources>
    <bool name="adapty_onboarding_enable_safe_area_paddings">false</bool>
</resources>

safeAreaPaddings を false に設定すると、オンボーディングは自動的なパディング調整なしにフルスクリーンに広がります。これによりレイアウトを完全に制御でき、オンボーディングのコンテンツが画面全体を使用できるようになります。

オンボーディングでのリンクの開き方をカスタマイズする

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

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

外部ブラウザでリンクを開くように変更したい場合は、externalUrlsPresentation パラメータを AdaptyWebPresentation.ExternalBrowser に設定することで、この動作をカスタマイズできます。

val onboardingConfig = AdaptyUI.getOnboardingConfiguration(
    onboarding = onboarding,
    externalUrlsPresentation = AdaptyWebPresentation.ExternalBrowser // default – InAppBrowser
)

AdaptyOnboardingConfiguration onboardingConfig = AdaptyUI.getOnboardingConfiguration(
    onboarding,
    AdaptyWebPresentation.ExternalBrowser // default – InAppBrowser
);