Hiển thị onboardings trong Unity SDK

Onboarding đã bị deprecated trong SDK v4 và sẽ bị xóa trong một phiên bản tương lai. Chúng không còn nhận được các bản sửa lỗi hay cải tiến nữa. Hãy sử dụng flow thay thế: không giống như onboarding chạy trong WebView, flow render trực tiếp trên thiết bị — mang lại hoạt ảnh mượt mà hơn, giao diện native nhất quán, thời gian tải nhanh hơn và không phụ thuộc vào WebView. Xem Lấy flow & paywall và Hiển thị flow & paywall để bắt đầu.

Nếu bạn đã tùy chỉnh onboarding bằng builder, bạn không cần lo lắng về việc render nó trong code Unity app để 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ị.

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

Bạn đã cài đặt Adapty Unity SDK phiên bản 3.14.0 trở lên.
Bạn đã tạo một onboarding.
Bạn đã thêm onboarding vào một placement.

Để hiển thị onboarding, sử dụng phương thức view.Present() trên view được tạo bởi phương thức CreateOnboardingView. Mỗi view chỉ có thể dùng một lần. Nếu bạn cần hiển thị lại paywall, hãy gọi CreateOnboardingView thêm một lần nữa để tạo một view instance mới.

Tái sử dụng cùng một view mà không tạo lại có thể dẫn đến lỗi AdaptyUIError.viewAlreadyPresented.

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

Cấu hình kiểu hiển thị trên iOS

Cấu hình cách onboarding được hiển thị trên iOS bằng cách truyền tham số iosPresentationStyle vào phương thức Present(). Tham số này chấp nhận các giá trị AdaptyUIIOSPresentationStyle.FullScreen (mặc định) hoặc AdaptyUIIOSPresentationStyle.PageSheet.

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

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

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

Theo mặc định, các liên kết trong onboarding mở bằng trình duyệt trong ứng dụng, mang lại trải nghiệm liền mạch bằng cách hiển thị trang web ngay trong ứng dụng mà không cần chuyển sang ứng dụng khác.

Để mở liên kết bằng trình duyệt ngoài thay thế, hãy truyền AdaptyWebPresentation.ExternalBrowser vào phương thức CreateOnboardingView:

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

Các tùy chọn có sẵn:

AdaptyWebPresentation.InAppBrowser - Mở liên kết bằng trình duyệt trong ứng dụng (mặc định)
AdaptyWebPresentation.ExternalBrowser - Mở liên kết bằng trình duyệt ngoài của thiết bị