배지

​

Android 배지

​

Huawei 배지

​

Huawei 배지 작동 방식

• 배지는 사용자의 기기 수준 배지 표시 설정(기기의 설정 > 알림 > 앱 아이콘 배지에서 제어)에 따라 숫자 수 또는 점으로 앱 아이콘에 표시됩니다. API 호출은 기본 수를 제어하고 기기가 시각적 스타일을 결정합니다.
• huawei_badge_class는 모든 배지 작업에 필수입니다. 이는 <package_name>.<ActivityName> 형식(예: com.example.myapp.MainActivity)의 앱 진입 Activity의 정규화된 클래스 이름입니다. 이는 Huawei 시스템에 어떤 앱 아이콘에 배지를 적용할지 알려줍니다.
• 동일한 요청에서 huawei_badge_set_num과 huawei_badge_add_num을 모두 설정하면 huawei_badge_set_num이 우선합니다.
• huawei_badge_set_num과 huawei_badge_add_num이 모두 제공되지 않은 경우(huawei_badge_class는 설정된 경우) 배지 수는 기본적으로 1 증가합니다.
• huawei_badge_set_num은 0에서 99까지의 값을 허용합니다. 0으로 설정하면 배지가 지워집니다.
• huawei_badge_add_num은 1에서 99까지의 값을 허용합니다. 예를 들어 앱이 현재 배지 5를 표시하고 huawei_badge_add_num: 3을 보내면 배지가 8이 됩니다.

​

배지와 함께 Huawei 푸시 보내기

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

​

배지 지우기

• API 또는 대시보드를 통해: huawei_badge_set_num을 0으로 설정한 알림을 보냅니다(또는 대시보드에서 설정 > 0 사용). 보이는 알림을 표시하지 않으려면 데이터/백그라운드 알림을 사용할 수 있습니다.
• 클라이언트 측 코드를 통해: 앱은 Huawei 배지 API를 사용하여 로컬에서 배지를 지울 수 있습니다. 이를 위해서는 AndroidManifest.xml에 com.huawei.android.launcher.permission.CHANGE_BADGE 권한이 필요합니다. 구현 세부 정보는 Huawei 배지 개발 가이드를 참조하세요.

​

iOS 배지

• OneSignalNotificationServiceExtension
• App Groups

1. 앱이 열릴 때 앱 아이콘 배지를 지웁니다.
2. 알림 센터에서 알림을 제거합니다.

• 앱이 시작되거나 재개될 때 배지 재설정
• 포그라운드에서 알림이 수신될 때 배지 증가
• 메시지를 읽거나 해제할 때 감소
• App Groups 또는 백엔드를 통해 기기 또는 앱 확장 간에 배지 상태 동기화

​

자동 알림 및 배지 지우기 비활성화

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

​

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
}

​

배지와 함께 iOS 푸시 보내기

• 대시보드
• API

1. 메시지 > 푸시 또는 템플릿으로 이동
2. 플랫폼 설정 > Apple iOS로 보내기 > 배지에서
3. 다음 중 하나를 선택:
   • 특정 숫자로 설정
   • 상대적인 양만큼 증가

Create message API에서 다음 매개변수를 사용합니다:

• ios_badgeType - SetTo 또는 Increase로 설정
• ios_badgeCount - 설정하거나 증가시킬 숫자

복사

AI에게 묻기

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