Badges

​

Badges do Android

​

Badges Huawei

​

Como os badges Huawei funcionam

• O badge é exibido no ícone do seu aplicativo como uma contagem numérica ou um ponto, dependendo da configuração de exibição de badge no nível do dispositivo do usuário (controlada em Configurações > Notificações > Badges de ícone de aplicativo do dispositivo). Sua chamada de API controla a contagem subjacente; o dispositivo decide o estilo visual.
• huawei_badge_class é obrigatório para qualquer operação de badge. Este é o nome de classe totalmente qualificado da Activity de entrada do seu aplicativo no formato <package_name>.<ActivityName> (por exemplo, com.example.myapp.MainActivity). Ele informa ao sistema Huawei a qual ícone de aplicativo aplicar o badge.
• Se você definir tanto huawei_badge_set_num quanto huawei_badge_add_num na mesma solicitação, huawei_badge_set_num tem prioridade.
• Se nem huawei_badge_set_num nem huawei_badge_add_num for fornecido (mas huawei_badge_class estiver definido), a contagem de badge incrementa em 1 por padrão.
• huawei_badge_set_num aceita valores de 0 a 99. Definir como 0 limpa o badge.
• huawei_badge_add_num aceita valores de 1 a 99. Por exemplo, se o aplicativo atualmente mostra um badge de 5 e você envia huawei_badge_add_num: 3, o badge se torna 8.

​

Enviar push Huawei com badges

{
  "huawei_badge_class": "com.example.myapp.MainActivity",
  "huawei_badge_set_num": 5
}

{
  "huawei_badge_class": "com.example.myapp.MainActivity",
  "huawei_badge_add_num": 1
}

{
  "huawei_badge_class": "com.example.myapp.MainActivity",
  "huawei_badge_set_num": 0
}

​

Limpando badges

• Via API ou painel: Envie uma notificação com huawei_badge_set_num definido como 0 (ou use Definir para > 0 no painel). Pode ser uma notificação de dados/em segundo plano se você não quiser que uma notificação visível apareça.
• Via código do lado do cliente: Seu aplicativo pode limpar o badge localmente usando a API de badge da Huawei. Isso requer a permissão com.huawei.android.launcher.permission.CHANGE_BADGE em seu AndroidManifest.xml. Consulte o guia de desenvolvimento de badges da Huawei para detalhes de implementação.

​

Badges do iOS

• O OneSignalNotificationServiceExtension
• App Groups

1. Limpar o badge do ícone do aplicativo quando o aplicativo é aberto.
2. Remover notificações da Central de Notificações.

• Redefinir badge quando o aplicativo é iniciado ou retomado
• Incrementar badge quando uma notificação é recebida em primeiro plano
• Decrementar quando uma mensagem é lida ou descartada
• Sincronizar estado de badge entre dispositivos ou extensões de aplicativo via App Groups ou seu backend

​

Desabilitar notificação automática e limpeza de badge

<key>OneSignal_disable_badge_clearing</key>
<true/>

​

Gerenciamento nativo de badge do iOS

import UserNotifications
import UIKit

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(5) { error in
    if let error = error {
      print("Failed to set badge count: \(error.localizedDescription)")
    } else {
      print("Badge count updated successfully.")
    }
  }
} else {
  UIApplication.shared.applicationIconBadgeNumber = 5
}

// Example: Store and retrieve badge count using UserDefaults
let badgeCount = UserDefaults.standard.integer(forKey: "badgeCount")
// Update badge count as needed
UserDefaults.standard.set(badgeCount, forKey: "badgeCount")

// Example: Increment badge count and update system badge
let currentCount = UserDefaults.standard.integer(forKey: "badgeCount")
let updatedCount = max(0, currentCount + 1)
UserDefaults.standard.set(updatedCount, forKey: "badgeCount")

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(updatedCount)
} else {
  UIApplication.shared.applicationIconBadgeNumber = updatedCount
}

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(0)
} else {
  UIApplication.shared.applicationIconBadgeNumber = 0
}

​

Enviar push do iOS com badges

• Dashboard
• API

1. Vá para Messages > Push ou Templates
2. Em Platform Settings > Send to Apple iOS > Badges
3. Escolha:
   • Definir para um número específico
   • Aumentar por uma quantidade relativa

Use os seguintes parâmetros na API Create message:

• ios_badgeType - Defina como SetTo ou Increase
• ios_badgeCount - O número para definir ou aumentar

Copiar

Perguntar à IA

{
  "ios_badgeType": "Increase",
  "ios_badgeCount": 1
}