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

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

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
);