Kiểm tra trạng thái gói đăng ký trong Flutter SDK

Với Adapty, việc theo dõi trạng thái gói đăng ký trở nên đơn giản hơn bao giờ hết. Bạn không cần phải chèn thủ công các product ID vào code. Thay vào đó, bạn có thể dễ dàng xác nhận trạng thái gói đăng ký của người dùng bằng cách kiểm tra mức độ truy cập đang hoạt động.

Trước khi bắt đầu kiểm tra trạng thái gói đăng ký (Nhấn để mở rộng)

Mức độ truy cập và đối tượng AdaptyProfile

Mức độ truy cập là các thuộc tính của đối tượng AdaptyProfile. Chúng tôi khuyến nghị bạn lấy hồ sơ người dùng khi ứng dụng khởi động, chẳng hạn như khi bạn xác định người dùng, rồi cập nhật lại mỗi khi có thay đổi. Bằng cách này, bạn có thể sử dụng đối tượng hồ sơ mà không cần liên tục gửi yêu cầu lấy lại. Để nhận thông báo về các cập nhật hồ sơ người dùng, hãy lắng nghe các thay đổi hồ sơ như được mô tả trong phần Lắng nghe cập nhật hồ sơ, bao gồm mức độ truy cập bên dưới.

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, nơ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.

Lấy mức độ truy cập từ máy chủ

Để lấy mức độ truy cập từ máy chủ, sử dụng phương thức .getProfile():

try {
  final profile = await Adapty().getProfile();
  // check the access
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Tham số phản hồi:

Tham sốMô tả
Profile

Một đối tượng AdaptyProfile. Thông thường, bạn chỉ cần kiểm tra trạng thái mức độ truy cập của hồ sơ người dùng để xác định xem người dùng có quyền truy cập premium vào ứng dụng hay không.

Phương thức .getProfile luôn cố gắng truy vấn API nên cho kết quả cập nhật nhất. Nếu vì lý do nào đó (ví dụ: không có kết nối internet), Adapty SDK không thể lấy thông tin từ máy chủ, dữ liệu từ bộ nhớ cache sẽ được trả về. Cũng cần lưu ý rằng Adapty SDK thường xuyên cập nhật cache của AdaptyProfile để giữ cho thông tin này luôn mới nhất có thể.

Phương thức .getProfile() cung cấp cho bạn hồ sơ người dùng, từ đó bạn có thể kiểm tra trạng thái mức độ truy cập. Mỗi ứng dụng có thể có nhiều mức độ truy cập. Ví dụ, nếu bạn có ứng dụng tin tức và bán gói đăng ký cho các chủ đề khác nhau một cách độc lập, bạn có thể tạo các mức độ truy cập “sports” và “science”. Tuy nhiên, trong hầu hết trường hợp, bạn chỉ cần một mức độ truy cập — khi đó bạn có thể dùng mức độ truy cập mặc định “premium”.

Dưới đây là ví dụ kiểm tra mức độ truy cập mặc định “premium”:

try {
  final profile = await Adapty().getProfile();
  if (profile?.accessLevels['premium']?.isActive ?? false) {
        // grant access to premium features
    }
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Lắng nghe cập nhật trạng thái đăng ký

Mỗi khi gói đăng ký của người dùng thay đổi, Adapty sẽ kích hoạt một sự kiện.

Để nhận thông báo từ Adapty, bạn cần thực hiện thêm một số cấu hình:

Adapty().didUpdateProfileStream.listen((profile) {
  // handle any changes to subscription state
});

Adapty cũng kích hoạt một sự kiện khi ứng dụng khởi động. Trong trường hợp này, trạng thái gói đăng ký được lưu trong cache sẽ được truyền vào.

Bộ nhớ đệm trạng thái gói đăng ký

Bộ nhớ đệm được tích hợp trong Adapty SDK lưu trữ trạng thái gói đăng ký của hồ sơ người dùng. Điều này có nghĩa là ngay cả khi máy chủ không khả dụng, dữ liệu đã được lưu trong bộ nhớ đệm vẫn có thể được truy cập để cung cấp thông tin về trạng thái gói đăng ký của hồ sơ người dùng. Tuy nhiên, cần lưu ý rằng không thể truy vấn dữ liệu trực tiếp từ bộ nhớ cache. SDK sẽ định kỳ truy vấn máy chủ mỗi phút một lần để kiểm tra các cập nhật hoặc thay đổi liên quan đến hồ sơ người dùng. Nếu có bất kỳ thay đổi nào, chẳng hạn như giao dịch mới hoặc các cập nhật khác, chúng sẽ được gửi đến dữ liệu trong bộ nhớ cache để đảm bảo đồng bộ với máy chủ.