Xử lý hành động nút trong Flutter SDK

Nếu bạn đang xây dựng flow hoặc paywall bằng Adapty builder, việc thiết lập các nút đúng cách là rất quan trọng:

1. Thêm nút trong builder và gán cho nút đó một action có sẵn hoặc tạo custom action ID.
2. Viết code trong ứng dụng để xử lý từng action bạn đã gán.

Hướng dẫn này trình bày cách xử lý các custom action và action có sẵn trong code của bạn.

Đóng flow và paywall

Để thêm nút đóng flow hoặc paywall, trong builder, hãy thêm một nút và gán cho nó hành động Close. Không cần viết code: implementation mặc định của flowViewDidPerformAction sẽ tự động đóng view khi nhận được CloseAction.

Ghi đè flowViewDidPerformAction nếu bạn cần hành vi tùy chỉnh — ví dụ: đóng view khi người dùng nhấn nút back của hệ thống Android, như trong v3:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
    switch (action) {
      case const CloseAction():
      case const AndroidSystemBackAction():
        view.dismiss();
        break;
      case OpenUrlAction(:final url, :final openIn):
        AdaptyUI().openUrl(url, openIn: openIn);
        break;
      default:
        break;
    }
}

Mở URL từ flow và paywall

Để thêm nút mở liên kết (ví dụ: Terms of use hoặc Privacy policy), trong builder, hãy thêm một nút, gán cho nó hành động Open URL, rồi nhập URL bạn muốn mở. Không cần viết code: phần triển khai mặc định của flowViewDidPerformAction sẽ mở URL theo cách native thông qua AdaptyUI().openUrl, tuân theo cài đặt mở trong trình duyệt trong ứng dụng hoặc trình duyệt ngoài từ dashboard.

Hành vi mặc định là đủ cho hầu hết các trường hợp. Nếu bạn vẫn muốn tự xử lý việc mở URL, hãy ghi đè handler:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
    switch (action) {
      case const CloseAction():
        view.dismiss();
        break;
      case OpenUrlAction(url: final url):
        // Open the URL in whatever way fits your app
        break;
      default:
        break;
    }
}

Đăng nhập vào ứng dụng

Để thêm nút cho phép người dùng đăng nhập vào ứng dụng:

1. Trong builder, thêm một nút và gán cho nó action Login.
2. Trong code ứng dụng, triển khai handler cho action login để xác định người dùng của bạn.

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
    switch (action) {
      case CustomAction(action: 'login'):
        // Navigate to your login screen in whatever way fits your app
        break;
      default:
        break;
    }
}

Xử lý các hành động tùy chỉnh

Để thêm nút xử lý các hành động khác:

1. Trong builder, thêm một nút, gán cho nó hành động Custom và đặt cho nó một ID.
2. Trong code của ứng dụng, triển khai một handler cho ID hành động bạn đã tạo.

Ví dụ: nếu bạn có một bộ ưu đãi gói đăng ký hoặc sản phẩm mua một lần khác, bạn có thể thêm một nút để hiển thị một flow hoặc paywall khác:

void flowViewDidPerformAction(AdaptyUIFlowView view, AdaptyUIAction action) {
   switch (action) {
     case CustomAction(action: 'openNewPaywall'):
       // Display another flow or paywall
       break;
     default:
       break;
   }
}

Nếu bạn đang xây dựng paywall bằng Adapty paywall builder, việc thiết lập các nút đúng cách là rất quan trọng:

1. Thêm một nút trong paywall builder và gán cho nó một hành động có sẵn hoặc tạo một ID hành động tùy chỉnh.
2. Viết code trong ứng dụng của bạn để xử lý từng hành động bạn đã gán. Hướng dẫn này chỉ cách xử lý các hành động tùy chỉnh và có sẵn trong code của bạn.

Đóng paywall

Để thêm nút đóng paywall:

1. Trong Paywall Builder, thêm một nút và gán cho nó hành động Close.
2. Trong code ứng dụng, triển khai handler cho các hành động CloseAction và AndroidSystemBackAction.

void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
    switch (action) {
      case const CloseAction():
      case const AndroidSystemBackAction():
        view.dismiss();
        break;
      default:
        break;
    }
}

Mở URL từ paywall

Để thêm một nút mở liên kết từ paywall của bạn (ví dụ: Terms of use hoặc Privacy policy):

1. Trong paywall builder, thêm một nút, gán cho nó hành động Open URL, và nhập URL bạn muốn mở.
2. Trong code ứng dụng của bạn, triển khai một handler cho hành động openUrl để mở URL nhận được trong trình duyệt.

// You have to install url_launcher plugin in order to handle urls:
// https://pub.dev/packages/url_launcher

void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
    switch (action) {
      case OpenUrlAction(url: final url):
        final Uri uri = Uri.parse(url);
        launchUrl(uri, mode: LaunchMode.inAppBrowserView);
        break;
      default:
        break;
    }
}

Đăng nhập vào ứng dụng

Để thêm nút cho phép người dùng đăng nhập vào ứng dụng:

1. Trong paywall builder, thêm một nút và gán cho nó hành động Login.
2. Trong code ứng dụng, triển khai một handler cho hành động login để xác định người dùng.

void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
    switch (action) {
      case CustomAction(action: 'login'):
        // Navigate to your login screen in whatever way fits your app
        break;
      default:
        break;
    }
}

Xử lý custom action

Để thêm nút xử lý bất kỳ hành động nào khác:

1. Trong Paywall Builder, thêm một nút, gán cho nó hành động Custom, và đặt cho nó một ID.
2. Trong code của ứng dụng, hãy triển khai handler cho action ID mà bạn đã tạo.

Ví dụ: nếu bạn có một bộ ưu đãi đăng ký hoặc sản phẩm mua một lần khác, bạn có thể thêm một nút để hiển thị paywall khác:

void paywallViewDidPerformAction(AdaptyUIPaywallView view, AdaptyUIAction action) {
   switch (action) {
     case CustomAction(action: 'openNewPaywall'):
       // Display another paywall
       break;
     default:
       break;
   }
}