Mindbox

Huawei Push Service

Передать в SDK HMS-токен

  1. Создайте новый kotlin класс с названием MindboxHuaweiMessagingService.
  2. Сделайте этот класс наследником от HmsMessageService(), если в приложении уже есть наследник HmsMessageService, то новый создавать не нужно, а все последующие изменения нужно добавить в существующий класс наследник HmsMessageService.
  3. Реализуйте метод onNewToken
KotlinCode
import cloud.mindbox.mobile_sdk.Mindbox import cloud.mindbox.mindbox_huawei.MindboxHuawei import com.huawei.hms.push.* import kotlinx.coroutines.* class MindboxHuaweiMessagingService : HmsMessageService() { private val coroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO) override fun onNewToken(token: String) { Mindbox.updatePushToken(applicationContext, token, MindboxHuawei) } override fun onMessageReceived(remoteMessage: RemoteMessage) { ...

Укажите, какие адреса могут приходить в push-уведомлении и как они соотносятся с активити приложения

В каждом push-уведомлении приходит ссылка, которую настроили в административном разделе. Также в push-уведомлении может быть до 3 кнопок, у каждой своя ссылка.

Чтобы корректно обработать открытие приложения и открыть ту активити, которую задумывалось, сформируйте Map. Укажите в нем ссылки и активити, которые они должны открывать. Этот метод обработает получение push-уведомлений, скачает картинку и отобразит push-уведомление.

При формировании Map activities для описания ссылок вы можете использовать маску с символом *. Например,https://mindbox.ru/push/* будет соответствовать:

  • https://mindbox.ru/push/,
  • https://mindbox.ru/push/1,
  • https://mindbox.ru/push/foo,
  • https://mindbox.ru/push/foo?product=123.

Push-уведомления и кнопки с таким URL будут открываться в одном активити, который вы указали.

KotlinCode
... override fun onMessageReceived(remoteMessage: RemoteMessage) { // Активти поумолчанию. Откроется, если пришла ссылка, которой нет в перечислении val defaultActivity = MainActivity::class.java // Перечесление ссылок и активити, которые должны открываться по разным ссылкам val activities = mapOf( "https://mindbox.ru/" to defaultActivity ) ...

Укажите, какая активити должна вызываться по умолчанию

Эта активити будет отображена, если в push-уведомлении пришла ссылка, которой нет в списке.

KotlinCode
... override fun onMessageReceived(remoteMessage: RemoteMessage) { // Активти поумолчанию. Откроется, если пришла ссылка, которой нет в перечислении val defaultActivity = MainActivity::class.java // Перечесление ссылок и активити, которые должны открываться по разным ссылкам val activities = mapOf( "https://mindbox.ru/" to defaultActivity ) ...

Придумайте название и описание канала для push-уведомлений

При первом push-уведомлении мы создадим собственный канал для уведомлений. Для него нужно придумать вместе с маркетологом название и описание. Подробнее про каналы уведомлений на Android можно почитать тут.

Идентификатор может быть любым, уникальным для вашего приложения.

KotlinCode
... // Перечесление ссылок и активити, которые должны открываться по разным ссылкам val activities = mapOf( "https://mindbox.ru/" to defaultActivity ) val channelId = "< ИДЕНТИФИКАТОР КАНАЛА >" // "my_android_app_channel" val channelName = "< НАЗВАНИЕ КАНАЛА >" // "Рекламные рассылки" val channelDescription = "< ОПИСАНИЕ КАНАЛА >" // "Рассылки, которые содержат рекламу" val pushSmallIcon = "< ИКОНКА ДЛЯ УВЕДОМЛЕНИЙ >" // R.mipmap.ic_launcher ...

Вызовите метод для отрисовки push-уведомлений

Для реализации отображения push-уведомлений вызовите метод Mindbox.handleRemoteMessage и передайте в него подготовленные данные.

Метод возвращает TRUE, если push-уведомление успешно обработано и отображено, и FALSE, если push-уведомление не обработано. На этот статус вы можете завязать логику обработки push-уведомления другими методами.

KotlinCode
... // Метод возвращает boolen, чтобы можно было сделать фолбек для обработки push-уведомлений coroutineScope.launch { val messageWasHandled = Mindbox.handleRemoteMessage( context = applicationContext, message = remoteMessage, activities = activities, channelId = channelId, channelName = channelName, pushSmallIcon = pushSmallIcon, defaultActivity = defaultActivity, channelDescription = channelDescription ) ...

Пример готового файла

KotlinCode
import cloud.mindbox.mobile_sdk.Mindbox import cloud.mindbox.mindbox_huawei.MindboxHuawei import com.huawei.hms.push.* import kotlinx.coroutines.* class MindboxHuaweiMessagingService : HmsMessageService() { private val coroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO) override fun onNewToken(token: String) { Mindbox.updatePushToken(applicationContext, token, MindboxHuawei) } override fun onMessageReceived(remoteMessage: RemoteMessage) { // Активти поумолчанию. Откроется, если пришла ссылка, которой нет в перечислении val defaultActivity = MainActivity::class.java // Перечесление ссылок и активити, которые должны открываться по разным ссылкам val activities = mapOf( "https://mindbox.ru/" to defaultActivity ) val channelId = "< ИДЕНТИФИКАТОР КАНАЛА >" // "my_android_app_channel" val channelName = "< НАЗВАНИЕ КАНАЛА >" // "Рекламные рассылки" val channelDescription = "< ОПИСАНИЕ КАНАЛА >" // "Рассылки, которые содержат рекламу" val pushSmallIcon = "< ИКОНКА ДЛЯ УВЕДОМЛЕНИЙ >" // R.mipmap.ic_launcher // Метод возвращает boolen, чтобы можно было сделать фолбек для обработки push-уведомлений coroutineScope.launch { val messageWasHandled = Mindbox.handleRemoteMessage( context = applicationContext, message = remoteMessage, activities = activities, channelId = channelId, channelName = channelName, pushSmallIcon = pushSmallIcon, defaultActivity = defaultActivity, channelDescription = channelDescription ) if (!messageWasHandled) { // Если push-уведомление было не от Mindbox или в нем некорректные данные, то можно написать фолбе для его обработки } } } override fun onDestroy() { super.onDestroy() coroutineScope.cancel() } }
Last modified on