Hiển thị flows & paywalls - Unity
Nếu bạn đã tạo một flow, hoặc một paywall trong Paywall Builder cũ, bạn không cần lo lắng về việc render nó trong code ứng dụng di động để hiển thị cho người dùng. Flow hoặc paywall đó đã chứa cả nội dung cần hiển thị lẫn cách thức hiển thị.
Hướng dẫn này đề cập đến các flow và paywall được render bởi Adapty. Quy trình sẽ khác đối với paywall tùy chỉnh và Observer mode.
- Để hiển thị paywall tùy chỉnh, xem Hiển thị paywall tùy chỉnh.
- Để hiển thị flow trong Observer mode, xem Hiển thị flow trong Observer mode.
Để lấy đối tượng view được sử dụng bên dưới, xem Lấy flow & paywall.
Để hiển thị một flow hoặc paywall, hãy sử dụng phương thức view.Present() trên view được tạo bởi phương thức CreateFlowView. Mặc định, một view đã bị đóng sẽ bị hủy. Để hiển thị lại flow, hãy gọi CreateFlowView thêm một lần nữa để tạo một instance view mới, hoặc giữ lại view khi bạn đóng nó.
Việc tái sử dụng một view đã bị hủy sẽ dẫn đến lỗi.
view.Present((error) => {
// handle the error
});Bạn muốn xem ví dụ thực tế về cách tích hợp Adapty SDK vào ứng dụng di động? Hãy xem ứng dụng mẫu của chúng tôi, minh họa toàn bộ quá trình thiết lập, bao gồm hiển thị paywall, thực hiện mua hàng và các chức năng cơ bản khác.
Giữ lại view để hiển thị lại
Tính năng giữ lại view khả dụng từ SDK phiên bản 4.3.0 trở lên.
view.Dismiss() giải phóng view khỏi bộ nhớ. Để giữ lại view thay vì xóa, hãy truyền false làm tham số destroy:
view.Dismiss(false, (error) => {
// handle the error
});Hiển thị lại view đó và người dùng sẽ quay lại màn hình họ đã rời, với trạng thái mà flow đã tích lũy. View giữ nguyên Id của nó, vì vậy các sự kiện của nó vẫn được gửi đến listener của bạn với cùng view.Id.
Một view được giữ trong bộ nhớ cho đến khi bạn giải phóng nó. Khi không còn cần dùng nữa, hãy gọi view.Destroy():
view.Destroy((error) => {
// handle the error
});Destroy() sẽ ẩn view trước nếu nó vẫn đang hiển thị trên màn hình. Nó cũng giải phóng view mà bạn đã tạo nhưng chưa bao giờ hiển thị, cũng như view dạng page-sheet mà người dùng đã vuốt xuống trên iOS. Đừng gọi nó sau khi đã dùng Dismiss() thông thường: view đó đã được giải phóng rồi và lệnh gọi sẽ thất bại.
Để giữ lại view khi người dùng nhấn nút Close, hãy dismiss nó với destroy: false trong Close action handler của bạn. Phương thức FlowViewDidPerformAction chạy cho mọi flow và paywall trong ứng dụng, vì vậy hãy so sánh view.Id để chỉ giữ lại view mà bạn định hiển thị lại. Lưu view vào một field khi tạo, để bạn có thể so sánh và hiển thị lại sau:
private AdaptyUIFlowView keptView;
void CreateKeptView(AdaptyFlow flow) {
AdaptyUI.CreateFlowView(flow, new AdaptyUICreateFlowViewParameters(), (view, error) => {
if (error != null) {
// handle the error
return;
}
keptView = view;
});
}
public void FlowViewDidPerformAction(
AdaptyUIFlowView view,
AdaptyUIUserAction action
) {
switch (action.Type) {
case AdaptyUIUserActionType.Close:
view.Dismiss(view.Id != keptView?.Id, null);
break;
default:
// handle other events
break;
}
}Giữ lại view đã lưu: bạn cần nó để hiển thị lại flow hoặc paywall, và để giải phóng nó bằng Destroy(). Sau khi gọi keptView.Destroy(), hãy đặt keptView về null để phép so sánh ở trên không khớp với một view đã được giải phóng. Bất kỳ lời gọi view.Dismiss() nào khác cũng giải phóng view đó, bao gồm cả lời gọi trong FlowViewDidReceiveError. Sau khi xảy ra lỗi với view, hãy tạo một view mới bằng CreateFlowView.
Hiển thị hộp thoại
Sử dụng phương thức này thay cho các hộp thoại cảnh báo mặc định khi một flow hoặc paywall đang được hiển thị trên Android. Trên Android, các alert thông thường sẽ xuất hiện phía sau view của flow, khiến người dùng không thể nhìn thấy chúng. Phương thức này đảm bảo hộp thoại được hiển thị đúng cách phía trên flow trên tất cả các nền tảng.
var dialog = new AdaptyUIDialogConfiguration()
.SetTitle("Close this screen?")
.SetContent("You will lose access to exclusive offers.")
.SetDefaultActionTitle("Stay")
.SetSecondaryActionTitle("Close");
AdaptyUI.ShowDialog(view, dialog, (action, error) => {
if (error == null) {
if (action == AdaptyUIDialogActionType.Secondary) {
// User confirmed - close the flow
view.Dismiss((error) => {
// handle the error
});
}
// If primary - do nothing, user stays
}
});Cấu hình kiểu trình bày trên iOS
Cấu hình cách flow hoặc paywall đượ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
});Người dùng có thể vuốt xuống để đóng page sheet. View sau đó vẫn còn trong bộ nhớ mà không cần gọi Dismiss(): present lại nó, hoặc từ SDK 4.3.0 trở lên, giải phóng nó bằng Destroy().
Nếu bạn đã tùy chỉnh paywall bằng Paywall 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. Loại paywall này bao gồm cả nội dung hiển thị lẫn cách hiển thị.
Hướng dẫn này đề cập đến Paywall Builder cũ, yêu cầu Adapty SDK 3.3.0 trở lên.
Để hiển thị paywall tùy chỉnh, xem Hiển thị paywall tùy chỉnh.
Để hiển thị paywall, dùng phương thức view.Present() trên view được tạo bởi phương thức CreatePaywallView. 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 CreatePaywallView thêm một lần nữa để tạo instance view mới.
Việc 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((error) => {
// handle the error
});Bạn muốn xem ví dụ thực tế về cách tích hợp Adapty SDK vào ứng dụng di động? Hãy xem ứng dụng mẫu của chúng tôi, minh họa toàn bộ quá trình thiết lập, bao gồm hiển thị paywall, thực hiện mua hàng và các chức năng cơ bản khác.
Hiển thị hộp thoại
Sử dụng phương thức này thay vì các hộp thoại cảnh báo gốc khi một paywall view đang được hiển thị trên Android. Trên Android, các cảnh báo thông thường xuất hiện phía sau paywall view, khiến người dùng không nhìn thấy chúng. Phương thức này đảm bảo hộp thoại được hiển thị đúng cách phía trên paywall trên tất cả các nền tảng.
var dialog = new AdaptyUIDialogConfiguration()
.SetTitle("Close paywall?")
.SetContent("You will lose access to exclusive offers.")
.SetDefaultActionTitle("Stay")
.SetSecondaryActionTitle("Close");
AdaptyUI.ShowDialog(view, dialog, (action, error) => {
if (error == null) {
if (action == AdaptyUIDialogActionType.Secondary) {
// User confirmed - close the paywall
view.Dismiss();
}
// If primary - do nothing, user stays
}
});Cấu hình kiểu hiển thị iOS
Cấu hình cách paywall đượ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
});