Badges

​

Badges Android

​

Badges Huawei

​

Comment fonctionnent les badges Huawei

• Le badge s’affiche sur l’icône de votre application sous forme de comptage numérique ou de point, selon le paramètre d’affichage des badges au niveau de l’appareil de l’utilisateur (contrôlé dans Paramètres > Notifications > Badges d’icônes d’application de l’appareil). Votre appel API contrôle le comptage sous-jacent ; l’appareil décide du style visuel.
• huawei_badge_class est requis pour toute opération de badge. Il s’agit du nom de classe entièrement qualifié de l’Activity d’entrée de votre application au format <package_name>.<ActivityName> (par exemple, com.example.myapp.MainActivity). Il indique au système Huawei à quelle icône d’application appliquer le badge.
• Si vous définissez à la fois huawei_badge_set_num et huawei_badge_add_num dans la même requête, huawei_badge_set_num est prioritaire.
• Si ni huawei_badge_set_num ni huawei_badge_add_num n’est fourni (mais que huawei_badge_class est défini), le compteur de badge s’incrémente de 1 par défaut.
• huawei_badge_set_num accepte des valeurs de 0 à 99. Le définir à 0 efface le badge.
• huawei_badge_add_num accepte des valeurs de 1 à 99. Par exemple, si l’application affiche actuellement un badge de 5 et que vous envoyez huawei_badge_add_num: 3, le badge devient 8.

​

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

Copier

Demander à l'IA

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