Android 웹 푸시 알림의 경우 배지는 앱 아이콘이 아닌 알림에 표시되는 작은 아이콘을 의미하며 사용자 지정할 수 있습니다. 웹 푸시 배지를 참조하세요.
Android 배지
Android 앱 아이콘 배지 동작은 Android 알림 카테고리를 통해 관리할 수 있습니다. 카테고리(채널)가 배지를 표시할지 여부를 제어하고 카테고리별로 배지 동작을 설정할 수 있습니다.Huawei 배지
Huawei 기기에서 배지는 사용자의 기기 설정에 따라 앱 아이콘에 숫자 또는 점으로 표시될 수 있습니다. 배지는 읽지 않은 메시지나 대기 중인 작업을 나타내어 사용자가 앱을 열도록 유도하는 데 도움이 됩니다. OneSignal을 사용하면 대시보드 또는 API를 통해 Huawei 배지 수를 직접 제어할 수 있습니다.Huawei 배지 작동 방식
배지는 사용자의 기기 설정(설정 > 알림 > 앱 아이콘 배지)에 따라 앱 아이콘에 숫자 수 또는 점으로 표시됩니다. API 호출이 기본 수를 제어하고 기기가 시각적 스타일을 결정합니다.매개변수
| 매개변수 | 유형 | 범위 | 설명 |
|---|---|---|---|
huawei_badge_class | string | — | (필수) 앱 런처 Activity의 정규화된 클래스 이름(예: com.example.myapp.MainActivity). Huawei 시스템에 배지를 표시할 앱 아이콘을 알려줍니다. |
huawei_badge_set_num | integer | 0–99 | 배지를 정확한 숫자로 설정합니다. 0은 배지를 지웁니다. |
huawei_badge_add_num | integer | 1–99 | 기존 배지 수를 이 양만큼 증가시킵니다. |
동작 규칙
huawei_badge_class는 모든 배지 작업에 필수입니다.huawei_badge_set_num과huawei_badge_add_num이 모두 제공되면huawei_badge_set_num이 우선합니다.- 둘 다 제공되지 않은 경우(
huawei_badge_class가 설정된 경우) 배지 수는 기본적으로 1 증가합니다.
배지와 함께 Huawei 푸시 보내기
- 대시보드
- API
- 메시지 > 푸시 또는 템플릿으로 이동
- 플랫폼 설정 > Huawei Android로 보내기 > 배지 아래
- 다음 중 하나를 선택:
- 설정 안 함 — 이 알림은 배지에 영향을 미치지 않음
- 설정 — 배지를 특정 숫자(0-99)로 설정
- 증가 — 기존 배지 수 증가(1-99)
배지 지우기
Huawei는 사용자가 앱을 열거나 알림을 탭할 때 배지를 자동으로 지우지 않습니다. 배지를 지우려면 두 가지 옵션이 있습니다:- API 또는 대시보드를 통해:
huawei_badge_set_num을0으로 설정한 알림을 보냅니다(또는 대시보드에서 설정 > 0 사용). 보이는 알림을 표시하지 않으려면 데이터/백그라운드 알림을 사용할 수 있습니다. - 클라이언트 측 코드를 통해: 앱은 Huawei 배지 API를 사용하여 로컬에서 배지를 지울 수 있습니다. 이를 위해서는
AndroidManifest.xml에com.huawei.android.launcher.permission.CHANGE_BADGE권한이 필요합니다. 구현 세부 정보는 Huawei 배지 개발 가이드를 참조하세요.
huawei_badge_set_num 매개변수에는 EMUI 10.0.0 이상 및 Push SDK 10.1.0 이상이 필요합니다. 이전 기기에서는 huawei_badge_add_num만 지원됩니다.iOS 배지
iOS에서 배지 수가 올바르게 증가하도록 하려면 다음을 구성해야 합니다:OneSignalNotificationServiceExtension- App Groups
- 앱이 열릴 때 앱 아이콘 배지를 지웁니다.
- 알림 센터에서 알림을 제거합니다.
- 앱이 시작되거나 재개될 때 배지 재설정
- 포그라운드에서 알림이 수신될 때 배지 증가
- 메시지를 읽거나 해제할 때 감소
- App Groups 또는 백엔드를 통해 기기 또는 앱 확장 간에 배지 상태 동기화
자동 알림 및 배지 지우기 비활성화
앱의info.plist에서 키: OneSignal_disable_badge_clearing를 Boolean 타입으로 추가하고 값을 YES로 설정합니다

iOS 네이티브 배지 관리
OneSignal의 자동 배지 지우기를 비활성화하면 Apple의 네이티브 API를 사용하여 배지 동작을 제어할 수 있습니다. 배지 수 설정 앱 아이콘의 배지를 특정 값으로 설정하려면:UserDefaults, 앱의 데이터 모델 또는 백엔드와 동기화 사용).
배지와 함께 iOS 푸시 보내기
OneSignal 대시보드 또는 API를 사용하여 배지 수를 설정할 수 있습니다.- 대시보드
- API
- 메시지 > 푸시 또는 템플릿으로 이동.
- 플랫폼 설정 > Apple iOS로 보내기 > 배지에서.
- 다음 중 하나를 선택:
- 특정 숫자로 설정.
- 상대적인 양만큼 증가.

FAQ
iOS에서 배지 수가 증가하지 않는 이유는 무엇인가요?
OneSignalNotificationServiceExtension과 App Groups를 구성했는지 확인하세요. 이것들이 없으면 배지 수가 올바르게 증가할 수 없습니다. 전체 지침은 모바일 SDK 설정을 참조하세요.
Huawei에서 배지를 지우려면 어떻게 해야 하나요?
huawei_badge_set_num을 0으로 설정한 알림을 보내거나 대시보드에서 설정 > 0을 사용하세요. 또한 데이터/백그라운드 알림을 사용하여 보이는 알림 없이 배지를 지울 수 있습니다. 또는 Huawei 배지 API를 사용하여 클라이언트 측에서 배지를 지우세요.
웹 푸시에 배지를 설정할 수 있나요?
아니요. 앱 아이콘 배지는 iOS, Android 및 Huawei에서만 지원됩니다. Android 웹 푸시의 경우 “배지”는 알림 자체에 표시되는 작은 아이콘을 의미합니다 — 웹 푸시 배지를 참조하세요.관련 페이지
Android 알림 카테고리
Android에서 알림 채널별 배지 표시 및 동작을 제어합니다.
Huawei 승인
OneSignal로 Huawei 푸시 메시지를 설정합니다.
푸시 개요
웹 푸시 배지를 포함한 푸시 알림 기능의 전체 참조입니다.
모바일 SDK 설정
iOS의 배지 전제 조건을 포함한 OneSignal SDK를 구성합니다.