Hiển thị onboarding trong Android SDK

Bắt đầu từ SDK v4 (beta), bạn có thể tạo flow như một giải pháp thay thế mạnh mẽ hơn cho onboarding. Khác với onboarding chạy bên trong WebView, flow render trực tiếp trên thiết bị — mang lại animation mượt mà hơn, giao diện Android nhất quán, thời gian tải nhanh hơn và không phụ thuộc vào WebView runtime. Xem Lấy flow & paywall và Hiển thị flow & paywall để bắt đầu.

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

Bạn đã cài đặt Adapty Android SDK phiên bản 3.8.0 trở lên.
Bạn đã tạo một onboarding.
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 như vậy đã bao gồm cả nội dung cần hiển thị lẫn cách hiển thị nó. Để hiển thị onboarding trực quan trên màn hình thiết bị, bạn phải cấu hình nó trước. Để làm điều này, hã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ị.

Các tham số yêu cầu:

Tham số	Bắt buộc	Mô tả
viewConfig	bắt buộc	Cấu hình onboarding lấy từ `AdaptyUI.getOnboardingConfiguration()`
eventListener	bắt buộc	Một implementation của `AdaptyOnboardingEventListener` để xử lý các sự kiện onboarding. Xem Xử lý sự kiện onboarding để biết thêm chi tiết.

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 tiếp mượt mà giữa splash screen và onboarding

Mặc định, giữa splash screen và onboarding, bạn sẽ thấy màn hình loading cho đến khi onboarding tải xong. Tuy nhiên, nếu muốn quá trình chuyển tiếp mượt mà hơn, bạn có thể tùy chỉnh bằng cách 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 một placeholder (nội dung sẽ hiển thị trong khi onboarding đang tải) ở đó. Nếu bạn định nghĩa một placeholder, onboarding sẽ được tải trong nền và tự động hiển thị ngay khi sẵn sàng.

Vô hiệu hóa safe area paddings

Theo mặc định, màn hình onboarding sẽ tự động áp dụng safe area paddings để tránh các thành phần giao diện hệ thống như status bar và navigation bar. Tuy nhiên, nếu bạn muốn vô hiệu hóa hành vi này và kiểm soát toàn bộ layout, bạn có thể thực hiện 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 ở mức 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 toàn màn hình mà không có bất kỳ điều chỉnh padding tự động nào, 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 onboardings

Tính năng tùy chỉnh cách mở liên kết trong onboardings được hỗ trợ từ Adapty SDK v3.15.1 trở lên.

Theo mặc định, các liên kết trong onboardings sẽ mở trong trình duyệt nội bộ của ứng dụng. Đ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, giúp họ xem nội dung mà không cần chuyển sang ứng dụng khác.

Nếu bạn muốn mở liên kết bằng trình duyệt bên 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
);