С Adapty отслеживать статус подписки очень просто. Вам не нужно вручную прописывать идентификаторы продуктов в коде. Вместо этого достаточно проверить наличие активного уровня доступа, чтобы убедиться, что у пользователя есть подписка.

Перед тем как проверять статус подписки (нажмите, чтобы развернуть)

• Для iOS настройте App Store Server Notifications
• Для Android настройте Real-time Developer Notifications (RTDN)

Уровень доступа и объект AdaptyProfile

Уровни доступа — это свойства объекта AdaptyProfile. Рекомендуем получать профиль при запуске приложения — например, когда вы идентифицируете пользователя — и обновлять его при каждом изменении. Так вы сможете использовать объект профиля без лишних запросов. Чтобы получать уведомления об обновлениях профиля, подпишитесь на изменения профиля, как описано в разделе Отслеживание изменений профиля, включая уровни доступа ниже.

Получение уровня доступа с сервера

Чтобы получить уровень доступа с сервера, используйте метод .getProfile():

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

Параметры ответа:

Параметр	Описание
Profile	Объект AdaptyProfile. Как правило, достаточно проверить статус уровня доступа профиля, чтобы определить, есть ли у пользователя премиум-доступ к приложению. Метод .getProfile возвращает максимально актуальные данные, поскольку всегда обращается к API. Если по какой-то причине (например, при отсутствии интернета) SDK не может получить информацию с сервера, возвращаются данные из кэша. Важно также отметить, что SDK регулярно обновляет кэш 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 периодически обращается к серверу каждую минуту, чтобы проверить наличие обновлений или изменений, связанных с профилем. Если появятся какие-либо изменения — например, новые транзакции или другие обновления — они будут отправлены в кэшированные данные, чтобы поддерживать их синхронизацию с сервером.