Hiển thị onboarding trong Android SDK

Trước khi bắt đầu, hãy đảm bảo rằng:

1. Bạn đã cài đặt Adapty Android SDK phiên bản 3.8.0 trở lên.
2. Bạn đã tạo onboarding.
3. Bạn đã thêm onboarding vào một placement.

Nếu bạn đã tùy chỉnh onboarding bằng Onboarding Builder, bạn không cần lo lắng về việc render nó trong code ứng dụng để hiển thị cho người dùng. Onboarding đó đã bao gồm cả nội dung hiển thị lẫn cách thức hiển thị.

Để hiển thị onboarding trực quan trên màn hình thiết bị, trước tiên bạn phải cấu hình nó. Để làm điều này, gọi phương thức AdaptyUI.getOnboardingView() hoặc tạo OnboardingView trực tiếp:

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" />

Sau khi view được tạo thành công, bạn có thể thêm nó vào view hierarchy và hiển thị trên màn hình thiết bị.

Tham số yêu cầu:

Thay đổi màu chỉ báo tải

Bạn có thể ghi đè màu mặc định của chỉ báo tải theo cách sau:

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

Thêm hiệu ứng chuyển màn hình mượt mà giữa splash screen và onboarding

Theo mặc định, giữa splash screen và onboarding, bạn sẽ thấy màn hình loading cho đến khi onboarding được tải xong. Tuy nhiên, nếu bạn muốn tạo hiệu ứng chuyển màn hình mượt mà hơn, bạn có thể tùy chỉnh để kéo dài splash screen hoặc hiển thị nội dung khác.

Để làm điều này, hãy tạo file adapty_onboarding_placeholder_view.xml trong thư mục res/layout và định nghĩa placeholder (nội dung sẽ được hiển thị trong khi onboarding đang tải) ở đó.

Nếu bạn định nghĩa một placeholder, onboarding sẽ được tải ở nền và tự động hiển thị khi sẵn sàng.

Tắt safe area padding

Theo mặc định, onboarding view tự động áp dụng safe area padding để tránh các thành phần UI hệ thống như status bar và navigation bar. Tuy nhiên, nếu bạn muốn tắt hành vi này và kiểm soát hoàn toàn bố cục, bạn có thể làm bằng cách đặt tham số safeAreaPaddings thành 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);

Ngoài ra, bạn có thể kiểm soát hành vi này toàn cục bằng cách thêm một boolean resource vào ứng dụng:

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

Khi safeAreaPaddings được đặt thành false, onboarding sẽ mở rộng ra toàn màn hình mà không có padding tự động, giúp bạn kiểm soát hoàn toàn bố cục và cho phép nội dung onboarding sử dụng toàn bộ không gian màn hình.

Tùy chỉnh cách mở liên kết trong onboarding

Theo mặc định, các liên kết trong onboarding mở trong trình duyệt in-app. Điều này mang lại trải nghiệm liền mạch cho người dùng bằng cách hiển thị trang web ngay trong ứng dụng, cho phép họ xem mà không cần chuyển sang ứng dụng khác.

Nếu bạn muốn mở liên kết trong trình duyệt ngoài thay thế, bạn có thể tùy chỉnh hành vi này bằng cách đặt tham số externalUrlsPresentation thành AdaptyWebPresentation.ExternalBrowser:

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

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