Настройка бейджей

Примечание

Чтобы установить бейджи для плагинов Cordova или React Native, обратитесь к соответствующим руководствам:

• Бейджи для Cordova
• Бейджи для React Native

Начиная с версии 6.4.0 Pushwoosh iOS SDK, процесс управления и установки бейджей через push-уведомления изменился.

Если вы ранее использовали номер бейджа для отображения количества полученных push-уведомлений в вашем приложении, вам необходимо перейти на более новую версию iOS SDK (6.4.0 или более позднюю). Старые версии будут поддерживаться до конца второго квартала 2022 года.

Что определяет значение бейджа

Бейдж всегда приходит из самого push-уведомления. Ни одна функция Pushwoosh не устанавливает и не сбрасывает его самостоятельно. Отправка "ios_badges" в запросе /createMessage (или поле badges в Control Panel) устанавливает как aps.badge (абсолютное значение), так и aps.pw_badge (относительное изменение) в полезной нагрузке iOS. Android передает эквивалентное значение в pw_badges и требует модуль com.pushwoosh:pushwoosh-badge для его применения на поддерживаемых лаунчерах. Сохранение push-уведомления в Message Inbox никогда не устанавливает и не изменяет бейдж. Это два независимых эффекта одного и того же push-уведомления.

Осторожно

Относительное значение бейджа +1/-1 применяется только Notification Service Extension, и только когда оно установлено и настроено с соответствующей App Group, как описано ниже. Без этой настройки ОС применяет абсолютное значение aps.badge из полезной нагрузки как есть. Автоинкремента нет.

Как настроить бейджи

Чтобы настроить бейджи, выполните следующие шаги:

1. Добавьте Notification Service Extension (File -> New -> Target…)

2. Выберите “Notification Service Extension”

3. Замените сгенерированный класс NotificationService подклассом PushwooshNotificationServiceExtension. Pushwoosh берет на себя подсчет бейджей, событие доставки, загрузку вложений и обработку тайм-аута:

Swift

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

Objective-C

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

4. Добавьте возможность App Groups к обеим целям — основному приложению и Notification Service Extension — и используйте одну и ту же App Group для каждой.

5. Добавьте ID App Group в info.plist основного приложения:

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

Расширение наследует это значение от хост-приложения, поэтому вам не нужно повторять его в info.plist расширения — добавляйте его туда только для переопределения значения хоста.

Если вы предпочитаете не использовать файл info.plist, укажите App Group в коде, переопределив pushwooshAppGroupsName в вашем классе NotificationServiceExtension:

Swift

override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}

Objective-C

- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}

Пример

Отправка push-уведомления с бейджами

Если вы хотите отправить push-уведомление с бейджами из Pushwoosh Control Panel, просто добавьте желаемое значение бейджа в текстовое поле badges, как показано на рисунке ниже:

Примечание

Вы можете использовать следующие форматы значений для корректной отправки бейджей: +1, -1 или 5. Если вы хотите увеличить значение бейджа, используйте знак ”+”, если вы хотите уменьшить значение бейджа, используйте знак ”-”. Вы также можете установить точное число, используя, например, 5 без знака.

Поделитесь с нами своим мнением

Ваши отзывы помогают нам улучшать продукт, поэтому мы будем рады, если вы расскажете нам о любых проблемах, возникших в процессе интеграции SDK. Если вы столкнетесь с какими-либо трудностями, пожалуйста, не стесняйтесь поделиться с нами своими мыслями через эту форму.