Сценарии работы push-библиотек
Первый запуск приложения
При первом запуске приложения выполняются следующие действия:
- Библиотека получает от приложения необходимые рабочие настройки.
- Приложение запрашивает у пользователя разрешение на отображение push-уведомлений. Запрос может выполнить как само приложение, так и библиотека.
- После получения разрешения библиотека запрашивает необходимые данные у ОС и регистрирует уст ройство на push-сервере.
- После успешной регистрации библиотека передаёт приложению актуальные значения
deviceUidиdeviceAddress. - Приложение должно передать полученные
deviceUidиdeviceAddressна свой backend. Эти идентификаторы используются для адресной отправки push-уведомлений на устройство.
Повторный запуск приложения
При каждом повторном запуске приложения библиотека проверяет актуальность данных регистрации с помощью метода onActualDeviceAddress.
Если данные регистрации актуальны, библиотека передаёт приложению актуальные значения deviceUid и deviceAddress.
Получение push-уведомления
Обработка уведомления в Notification Service Extension
Обработка push-уведомления зависит от варианта интеграции библиотеки EDNAPushNE.
При базовом варианте интеграции
- Библиотека обрабатывает полученное уведомление и отправляет на push-сервер подтверждение его доставки.
- Библиотека загружает логотип и добавляет его к отображаемому уведомлению.
При расширенном варианте интеграции
- Библиотека инициализируется, получает рабочие настройки и актуальный
deviceAddress. - Notification Service Extension вызывает метод библиотеки для обработки полученного уведомления.
- Библиотека отправляет на push-сервер подтверждение получения уведомления.
- Если загрузка контента настроена, библиотека запрашивает содержимое уведомления на push-сервере.
- После получения контента библиотека отправляет на push-сервер подтверждение его загрузки.
- Библиотека передаёт обработанные данные уведомления в расширение для дальнейшей модификации.
Обработка уведомления основным приложением
Если основное приложение не выгружено из памяти или пользователь открыл его после нажатия на отображенное уведомление, выполняются следующие действия:
- Для обработки уведомления вызывается метод делегата
onPushReceived. - Библиотека автоматически запрашивает на push-сервере содержимое полученного уведомления.
- После получения содержимого вызывается метод делегата
onPushMessagesReceived.
Действия приложения
Отметка сообщения как прочитанного
После прочтения пользователем полученного сообщения приложение может вызвать метод markAsRead.
Библиотека передает на push-сервер информацию о прочтении сообщения, после чего сообщение отмечается на сервере как прочитанное.
Сброс счётчика новых сообщений
При открытии приложения и просмотре новых сообщений приложение может вызвать метод resetNewMessageCounter.
Библиотека передает на push-сервер запрос на обнуление счётчика новых сообщений. Одновременно сбрасывается счётчик уведомлений (badge) на иконке приложения.