Insignias

​

Insignias de Android

​

Insignias de Huawei

​

Cómo funcionan las insignias de Huawei

• La insignia se muestra en el ícono de su aplicación como un conteo numérico o un punto, dependiendo de la configuración de visualización de insignias a nivel de dispositivo del usuario (controlada en Configuración > Notificaciones > Insignias de íconos de aplicación del dispositivo). Su llamada a la API controla el conteo subyacente; el dispositivo decide el estilo visual.
• huawei_badge_class es requerido para cualquier operación de insignia. Este es el nombre de clase completamente cualificado de la Activity de entrada de su aplicación en el formato <package_name>.<ActivityName> (por ejemplo, com.example.myapp.MainActivity). Indica al sistema Huawei a qué ícono de aplicación aplicar la insignia.
• Si establece tanto huawei_badge_set_num como huawei_badge_add_num en la misma solicitud, huawei_badge_set_num tiene prioridad.
• Si no se proporciona ni huawei_badge_set_num ni huawei_badge_add_num (pero huawei_badge_class está configurado), el conteo de insignias se incrementa en 1 por defecto.
• huawei_badge_set_num acepta valores de 0 a 99. Establecerlo en 0 borra la insignia.
• huawei_badge_add_num acepta valores de 1 a 99. Por ejemplo, si la aplicación actualmente muestra una insignia de 5 y envía huawei_badge_add_num: 3, la insignia se convierte en 8.

​

Enviar push de Huawei con insignias

{
  "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
}

​

Borrar insignias

• A través de la API o el panel: Envíe una notificación con huawei_badge_set_num establecido en 0 (o use Establecer en > 0 en el panel). Puede ser una notificación de datos/en segundo plano si no desea que aparezca una notificación visible.
• A través de código del lado del cliente: Su aplicación puede borrar la insignia localmente usando la API de insignias de Huawei. Esto requiere el permiso com.huawei.android.launcher.permission.CHANGE_BADGE en su AndroidManifest.xml. Consulte la guía de desarrollo de insignias de Huawei para detalles de implementación.

​

Insignias de iOS

• La OneSignalNotificationServiceExtension
• App Groups

1. Borrará la insignia del ícono de la aplicación cuando se abra la aplicación.
2. Eliminará las notificaciones del Centro de Notificaciones.

• Restablecer la insignia cuando la aplicación se inicia o reanuda
• Incrementar la insignia cuando se recibe una notificación en primer plano
• Decrementar cuando se lee o descarta un mensaje
• Sincronizar el estado de la insignia entre dispositivos o extensiones de aplicación a través de App Groups o su backend

​

Deshabilitar la eliminación automática de notificaciones e insignias

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

​

Gestión nativa de insignias de iOS

import UserNotifications
import UIKit

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(5) { error in
    if let error = error {
      print("Fallo al establecer el contador de insignias: \(error.localizedDescription)")
    } else {
      print("Contador de insignias actualizado con éxito.")
    }
  }
} else {
  UIApplication.shared.applicationIconBadgeNumber = 5
}

// Ejemplo: Almacenar y recuperar el contador de insignias usando UserDefaults
let badgeCount = UserDefaults.standard.integer(forKey: "badgeCount")
// Actualizar el contador de insignias según sea necesario
UserDefaults.standard.set(badgeCount, forKey: "badgeCount")

// Ejemplo: Incrementar el contador de insignias y actualizar la insignia del sistema
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 de iOS con insignias

• Panel
• API

1. Vaya a Messages > Push o Templates
2. Bajo Platform Settings > Send to Apple iOS > Badges
3. Elija cualquiera de las siguientes opciones:
   • Establecer a un número específico
   • Aumentar por una cantidad relativa

Use los siguientes parámetros en la API de Create message:

• ios_badgeType - Establecer a SetTo o Increase
• ios_badgeCount - El número a establecer o incrementar

Copiar

Preguntar a la IA

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