Badges

​

Badges Android

​

Badges Huawei

​

Comment fonctionnent les badges Huawei

​

Paramètres

​

Règles de comportement

• huawei_badge_class est requis pour toute opération de badge.
• Si huawei_badge_set_num et huawei_badge_add_num sont tous les deux fournis, huawei_badge_set_num est prioritaire.
• Si aucun n’est fourni (mais que huawei_badge_class est défini), le compteur de badge s’incrémente de 1 par défaut.

​

Envoyer un push Huawei avec des 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
}

​

Effacer les badges

• Via l’API ou le tableau de bord : Envoyez une notification avec huawei_badge_set_num défini à 0 (ou utilisez Définir à > 0 dans le tableau de bord). Cela peut être une notification de données/en arrière-plan si vous ne voulez pas qu’une notification visible apparaisse.
• Via le code côté client : Votre application peut effacer le badge localement en utilisant l’API de badge Huawei. Cela nécessite la permission com.huawei.android.launcher.permission.CHANGE_BADGE dans votre AndroidManifest.xml. Consultez le guide de développement des badges Huawei pour les détails d’implémentation.

​

Badges iOS

• Le OneSignalNotificationServiceExtension
• App Groups

1. Effacer le badge de l’icône de l’application lorsque l’application est ouverte.
2. Supprimer les notifications du Centre de notifications.

• Réinitialiser le badge au lancement ou à la reprise de l’application
• Incrémenter le badge lorsqu’une notification est reçue au premier plan
• Décrémenter lorsqu’un message est lu ou ignoré
• Synchroniser l’état du badge entre les appareils ou les extensions d’application via App Groups ou votre backend

​

Désactiver le nettoyage automatique des notifications et des badges

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

​

Gestion native des badges 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
}

// Exemple : Stocker et récupérer le compteur de badge en utilisant UserDefaults
let badgeCount = UserDefaults.standard.integer(forKey: "badgeCount")
// Mettre à jour le compteur de badge selon les besoins
UserDefaults.standard.set(badgeCount, forKey: "badgeCount")

// Exemple : Incrémenter le compteur de badge et mettre à jour le badge système
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
}

​

Envoyer des push iOS avec badges

• Tableau de bord
• API

1. Accédez à Messages > Push ou Modèles.
2. Sous Paramètres de plateforme > Envoyer vers Apple iOS > Badges.
3. Choisissez soit :
   • Définir à un nombre spécifique.
   • Augmenter d’un montant relatif.

Utilisez les paramètres suivants dans l’API Créer un message :

• ios_badgeType — Défini sur SetTo ou Increase.
• ios_badgeCount — Le nombre à définir ou à augmenter.

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

​

FAQ

​

Pourquoi mon compteur de badge ne s’incrémente-t-il pas sur iOS ?

​

Comment effacer les badges sur Huawei ?

​

Puis-je définir des badges pour les push Web ?

​

Pages connexes