在 Flutter SDK 中查看订阅状态
借助 Adapty,订阅状态管理变得轻而易举。你无需在代码中手动填入产品 ID,只需检查用户是否拥有有效的访问等级,即可确认其订阅状态。
开始检查订阅状态前的准备工作(点击展开)
- iOS 请配置 App Store Server Notifications
- Android 请配置 Real-time Developer Notifications (RTDN)
访问等级与 AdaptyProfile 对象
访问等级是 AdaptyProfile 对象的属性。我们建议在应用启动时获取用户画像,例如在识别用户时,之后在发生变化时及时更新。这样,你就可以直接使用已有的用户画像对象,而无需反复请求。 要接收用户画像更新通知,请按照下方监听用户画像更新(包括访问等级)部分的说明监听用户画像变更。
想看看 Adapty SDK 在移动应用中的实际集成示例吗?欢迎查看我们的示例应用,其中演示了完整的集成流程,包括展示付费墙、完成购买以及其他基本功能。
从服务器获取访问等级
使用 .getProfile() 方法从服务器获取访问等级:
try {
final profile = await Adapty().getProfile();
// check the access
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}
响应参数:
| 参数 | 描述 |
|---|---|
| Profile | 一个 AdaptyProfile 对象。通常,你只需检查用户画像的访问等级状态,即可判断用户是否拥有应用的高级访问权限。
|
.getProfile() 方法可以获取用户画像,从中你可以了解访问等级的状态。一个应用可以拥有多个访问等级。例如,如果你有一个新闻应用,并对不同主题独立销售订阅,可以创建”sports”和”science”两个访问等级。但大多数情况下,你只需要一个访问等级,此时直接使用默认的”premium”访问等级即可。 |
以下是检查默认”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) {
}
监听订阅状态更新
每当用户的订阅发生变化时,Adapty 都会触发一个事件。
要接收来自 Adapty 的消息,您需要进行一些额外配置:
Adapty().didUpdateProfileStream.listen((profile) {
// handle any changes to subscription state
});
Adapty 也会在应用启动时触发一个事件,此时将传递缓存中的订阅状态。
订阅状态缓存
Adapty SDK 内置了缓存机制,用于存储用户画像的订阅状态。这意味着即使服务器无法访问,也可以从缓存数据中获取用户画像的订阅状态信息。 但需要注意的是,无法直接从缓存中请求数据。SDK 每隔一分钟会定期向服务器查询,检查用户画像是否有任何更新或变更。如果存在修改(例如新的交易记录或其他更新),这些内容将同步到缓存数据中,以保持其与服务器的一致性。