Hiển thị flows & paywalls - Flutter

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 để hiển thị cho người dùng. Flow hoặc paywall như vậy đã chứa cả nội dung cần hiển thị lẫn cách hiển thị.

Warning

Hướng dẫn này dành cho các flow và paywall được render bởi Adapty. Để hiển thị custom paywall, xem Hiển thị custom paywall.

Adapty Flutter SDK cung cấp hai cách để hiển thị flow và paywall:

  • Màn hình độc lập

  • Widget nhúng

Hiển thị dưới dạng màn hình độc lập

Để hiển thị một flow hoặc paywall dưới dạng màn hình độc lập, hãy sử dụng phương thức view.present() trên view được tạo bởi phương thức createFlowView. Theo mặc định, khi đóng một view, nó sẽ được giải phóng khỏi bộ nhớ, vì vậy bạn không thể hiển thị lại nó. Nếu bạn cần hiển thị lại flow hoặc paywall, hãy gọi createFlowView thêm một lần nữa để tạo một view mới, hoặc đóng mà không giải phóng bộ nhớ trên SDK 4.1 trở lên.

try {
  await view.present();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Tip

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.

Đóng flow hoặc paywall

Khi cần đóng flow hoặc paywall theo cách lập trình, hãy dùng phương thức dismiss():

try {
  await view.dismiss();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Note

Đóng một view sẽ giải phóng nó khỏi bộ nhớ — view đã đóng không thể hiển thị lại. Hãy tạo view mới bằng createFlowView.

Từ SDK 4.1 trở đi, truyền destroy: false để giữ view trong bộ nhớ thay vì xóa đi:

await view.dismiss(destroy: false);

Hiển thị lại view đó và người dùng sẽ quay lại màn hình họ đã rời đi, với trạng thái mà flow đã xây dựng. Một view được giữ lại theo cách này sẽ ở trong bộ nhớ cho đến khi bạn giải phóng nó.

Từ SDK 4.3.0, khi bạn không còn cần một view đã giữ lại nữa, hãy giải phóng nó bằng destroy():

await view.dismiss(destroy: false);
// ...
await view.destroy();

destroy() cũng giải phóng view mà bạn đã tạo nhưng chưa hiển thị, và view dạng page-sheet mà người dùng vuốt xuống trên iOS. Đừng gọi nó sau khi đã dismiss() thông thường: view đó đã được giải phóng rồi, và lệnh gọi sẽ thất bại với lỗi wrongParam. Với các phiên bản SDK cũ hơn, hãy hiển thị lại view đang giữ và dismiss nó với destroy: true để giải phóng.

Hành động đóng mặc định sẽ gọi view.dismiss(), giải phóng view ngay cả khi bạn đã giữ nó trước đó bằng destroy: false. Để giữ lại view khi người dùng đóng nó, hãy override flowViewDidPerformAction và tự dismiss view trong đó. Phương thức này 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. Giữ lại case OpenUrlAction để đảm bảo việc mở URL vẫn hoạt động:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
  switch (action) {
    case const CloseAction():
      // keptView is the view your app stored to present again
      view.dismiss(destroy: view.id != keptView?.id);
      break;
    case OpenUrlAction(:final url, :final openIn):
      AdaptyUI().openUrl(url, openIn: openIn);
      break;
    default:
      break;
  }
}

Giữ lại view đã được 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(). Bất kỳ lệnh gọi view.dismiss() nào khác cũng giải phóng view, bao gồm cả lệnh gọi trong flowViewDidReceiveError. Sau khi xảy ra lỗi view, hãy tạo một view mới bằng createFlowView.

Hiển thị hộp thoại

Dùng phương thức này thay cho các hộp thoại alert thông thường khi hiển thị flow hoặc paywall view trên Android. Trên Android, các alert thông thường sẽ xuất hiện phía sau view, khiến người dùng không nhìn thấy. Phương thức này đảm bảo hộp thoại luôn hiển thị đúng phía trên flow hoặc paywall trên mọi nền tảng.

try {
  final action = await view.showDialog(
    title: 'Close paywall?',
    content: 'You will lose access to exclusive offers.',
    primaryActionTitle: 'Stay',
    secondaryActionTitle: 'Close',
  );
  
  if (action == AdaptyUIDialogActionType.secondary) {
    // User confirmed - close the paywall
    await view.dismiss();
  }
  // If primary - do nothing, user stays
} catch (e) {
  // handle error
}

Cấu hình kiểu trình bày trên iOS

Cấu hình cách hiển thị flow hoặc paywall 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.

try {
  await view.present(iosPresentationStyle: AdaptyUIIOSPresentationStyle.pageSheet);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Người dùng có thể vuốt xuống để đóng page sheet. Màn hình sẽ vẫn còn trong bộ nhớ mà không cần gọi dismiss(): có thể mở lại màn hình đó, hoặc với SDK 4.3.0 trở lên, giải phóng nó bằng destroy().

Nhúng vào cây widget

Để nhúng một flow hoặc paywall vào cây widget hiện có của bạn, hãy sử dụng trực tiếp widget AdaptyUIFlowPlatformView trong cây widget Flutter của bạn.

AdaptyUIFlowPlatformView(
  flow: flow, // The flow object you fetched
  locale: 'en', // The localization to render the flow with
  onDidAppear: (view) {
  },
  onDidDisappear: (view) {
  },
  onDidPerformAction: (view, action) {
  },
  onDidSelectProduct: (view, productId) {
  },
  onDidStartPurchase: (view, product) {
  },
  onDidFinishPurchase: (view, product, purchaseResult) {
  },
  onDidFailPurchase: (view, product, error) {
  },
  onDidStartRestore: (view) {
  },
  onDidFinishRestore: (view, profile) {
  },
  onDidFailRestore: (view, error) {
  },
  onDidReceiveError: (view, error) {
  },
  onDidFailLoadingProducts: (view, error) {
  },
  onDidFinishWebPaymentNavigation: (view, product, error) {
  },
)
Note

Để Android platform view hoạt động, hãy đảm bảo MainActivity của bạn kế thừa FlutterFragmentActivity:

class MainActivity : FlutterFragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}

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 di động để hiển thị cho người dùng. Paywall đó đã bao gồm cả nội dung hiển thị lẫn cách thức hiển thị.

Warning

Hướng dẫn này chỉ áp dụng cho các paywall được xây dựng trong Paywall Builder cũ dành cho Adapty SDK 3.x. Chúng yêu cầu SDK v3.2.0 trở lên. Cách hiển thị paywall được xây dựng cho SDK 2.x hoặc cũ hơn, hoặc paywall tùy chỉnh, sẽ khác đi.

Adapty Flutter SDK cung cấp hai cách để hiển thị paywall:

  • Màn hình độc lập

  • Widget nhúng

Hiển thị dưới dạng màn hình độc lập

Để hiển thị một paywall dưới dạng màn hình độc lập, hãy sử 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ể được sử 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.

Warning

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.

try {
  await view.present();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}
Tip

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.

Đóng paywall

Khi cần đóng paywall theo chương trình, sử dụng phương thức dismiss():

try {
  await view.dismiss();
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Hiển thị hộp thoại

Dùng phương thức này thay cho hộp thoại cảnh báo gốc khi paywall view đ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 paywall view, khiến người dùng không thể nhìn thấy. Phương thức này đảm bảo hộp thoại luôn hiển thị đúng vị trí phía trên paywall trên mọi nền tảng.

try {
  final action = await view.showDialog(
    title: 'Close paywall?',
    content: 'You will lose access to exclusive offers.',
    primaryActionTitle: 'Stay',
    secondaryActionTitle: 'Close',
  );
  
  if (action == AdaptyUIDialogActionType.secondary) {
    // User confirmed - close the paywall
    await view.dismiss();
  }
  // If primary - do nothing, user stays
} catch (e) {
  // handle error
}

Cấu hình kiểu hiển thị trên 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.

try {
  await view.present(iosPresentationStyle: AdaptyUIIOSPresentationStyle.pageSheet);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

Nhúng vào cây widget

Để nhúng paywall vào cây widget hiện có của bạn, hãy sử dụng widget AdaptyUIPaywallPlatformView trực tiếp trong cây widget Flutter của bạn.

AdaptyUIPaywallPlatformView(
  paywall: paywall, // The paywall object you fetched
  onDidAppear: (view) {
  },
  onDidDisappear: (view) {
  },
  onDidPerformAction: (view, action) {
  },
  onDidSelectProduct: (view, productId) {
  },
  onDidStartPurchase: (view, product) {
  },
  onDidFinishPurchase: (view, product, purchaseResult) {
  },
  onDidFailPurchase: (view, product, error) {
  },
  onDidStartRestore: (view) {
  },
  onDidFinishRestore: (view, profile) {
  },
  onDidFailRestore: (view, error) {
  },
  onDidFailRendering: (view, error) {
  },
  onDidFailLoadingProducts: (view, error) {
  },
  onDidFinishWebPaymentNavigation: (view, product, error) {
  },
)
Note

Để Android platform view hoạt động, hãy đảm bảo MainActivity của bạn extends FlutterFragmentActivity:

class MainActivity : FlutterFragmentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    }
}