ÿÿ Hiển thị Flow trong Observer Mode | Tài liệu Adapty

Hiển thị flow trong Observer mode trong Flutter SDK

Nếu bạn đã tùy chỉnh flow hoặc paywall bằng 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. Flow hoặc paywall như vậy đã bao gồm cả ná»™i dung hiển thị lẫn cách hiển thị.

Phần này chỉ áp dụng cho Observer mode. Nếu bạn không làm việc ở Observer mode, hãy tham khảo chủ đỠHiển thị flows & paywalls.

Tính năng này yêu cầu Adapty Flutter SDK 4.0 trở lên — trước đây chỉ có trong các SDK gốc iOS và Android. Xem hướng dẫn migration để nâng cấp.

Trước khi bắt đầu hiển thị flow (Nhấp để mở rộng)
  1. Thiết lập tích hợp ban đầu cá»§a Adapty vá»›i App Store và vá»›i Google Play. 2. Cài đặt và cấu hình Adapty SDK. Äảm bảo đặt tham số observerMode thành true. Tham khảo hướng dẫn cài đặt Flutter SDK. 3. Tạo sản phẩm trong Adapty Dashboard. 4. Cấu hình flow hoặc paywall trong các builder và gán sản phẩm vào chúng. 5. Tạo placement và gán flow hoặc paywall vào chúng. 6. Lấy flow và cấu hình cá»§a chúng trong code ứng dụng di động cá»§a bạn.

Trong Observer mode, SDK không thá»±c hiện giao dịch mua hàng thay cho bạn. Khi ngưá»i dùng nhấn nút mua hàng hoặc khôi phục trong má»™t flow hoặc paywall do Adapty hiển thị, SDK sẽ gá»i AdaptyUIObserverModeResolver cá»§a bạn — hãy thá»±c hiện việc mua hàng hoặc khôi phục bằng code cá»§a chính bạn tại đó.

  1. Implement AdaptyUIObserverModeResolver:
    class MyObserverModeResolver extends AdaptyUIObserverModeResolver {
      @override
      void observerModeDidInitiatePurchase(
        AdaptyUIFlowView view,
        AdaptyPaywallProduct product,
        void Function() onStartPurchase,
        void Function() onFinishPurchase,
      ) {
        onStartPurchase(); // the view shows its loading indicator
        // make the purchase with your own code, then:
        onFinishPurchase(); // the view hides the loading indicator
      }
    
      @override
      void observerModeDidInitiateRestore(
        AdaptyUIFlowView view,
        void Function() onStartRestore,
        void Function() onFinishRestore,
      ) {
        onStartRestore();
        // restore purchases with your own code, then:
        onFinishRestore();
      }
    }

observerModeDidInitiatePurchase thông báo cho bạn biết rằng ngưá»i dùng đã khởi tạo má»™t giao dịch mua, và observerModeDidInitiateRestore — rằng ngưá»i dùng đã khởi tạo thao tác khôi phục. Hãy kích hoạt flow mua hàng hoặc khôi phục tùy chỉnh cá»§a bạn để phản hồi.

Ngoài ra, hãy nhá»› gá»i các callback sau để thông báo cho AdaptyUI vá» quá trình mua hàng hoặc khôi phục. Äiá»u này cần thiết để đảm bảo flow hoạt động đúng, chẳng hạn như hiển thị loader, v.v.:

CallbackMô tả
onStartPurchase()Callback này cần được gá»i để thông báo cho AdaptyUI rằng quá trình mua hàng đã bắt đầu.
onFinishPurchase()Callback này cần được gá»i để thông báo cho AdaptyUI rằng quá trình mua hàng đã hoàn thành.
onStartRestore()Callback này cần được gá»i để thông báo cho AdaptyUI rằng quá trình khôi phục đã bắt đầu.
onFinishRestore()Callback này cần được gá»i để thông báo cho AdaptyUI rằng quá trình khôi phục đã hoàn thành.
  1. Äăng ký resolver trước khi hiển thị bất kỳ màn hình nào:

    AdaptyUI().setObserverModeResolver(MyObserverModeResolver());
  2. Tạo và hiển thị flow view như bình thưá»ng: lấy flow và tạo view cá»§a nó, sau đó hiển thị nó. Không cần thêm tham số nào — má»™t khi resolver đã được đăng ký, má»i flow hoặc paywall do Adapty render Ä‘á»u sẽ xá»­ lý việc mua và khôi phục thông qua nó.

Äừng quên báo cáo giao dịch và liên kết nó vá»›i paywall. Nếu không, Adapty sẽ không nhận ra giao dịch và sẽ không xác định được paywall nguồn cá»§a lần mua.

ÿÿÿÿ