OneSignal의 Android 알림 카테고리는 Google Android, Huawei Android 및 Amazon FireOS에서 작동합니다.
프로그래밍 방식으로 카테고리를 정의하려면 Android의 알림 채널 만들기 가이드를 참조하세요.
기기의 앱 알림 카테고리 예제
기본 알림 카테고리
OneSignal은 자동으로 두 개의 기본 카테고리를 만듭니다:Miscellaneous
카테고리가 설정되지 않은 경우 사용됩니다.- 중요도: 높음
- 소리: 기본값
- 진동: 기본값
- 배지: 활성화됨
- 잠금 화면: 비공개
Restored
앱이 강제 종료되고 다시 열릴 때 사용되며, 지워진 이전 알림을 복원합니다.- 중요도: 낮음
- 소리: 꺼짐
- 진동: 꺼짐
- 배지: 비활성화됨
- 잠금 화면: 비공개
사용자 지정 카테고리로 푸시 알림을 항상 보내면 “Miscellaneous” 채널이 사용자 기기에 표시되지 않습니다. “Restored” 채널은 강제 종료 후 복원된 알림을 처리하기 위해 항상 표시됩니다.
Huawei 특정 동작
Huawei 기기에서 OneSignal은 기본 카테고리를 설정하지 않습니다. 포함하지 않으면 Huawei는 기본적으로 높음 중요도를 적용합니다.OneSignal에서 Android 알림 카테고리 만들기
- OneSignal 대시보드에서 설정 > 푸시 및 인앱 > Android 알림 채널로 이동합니다.
- 그룹 추가를 클릭하여 카테고리를 구성합니다(예: “뉴스 업데이트”, “소셜 활동”).
- 그룹 내에서 채널 추가를 클릭하여 새 카테고리를 만듭니다.
OneSignal에서 Android 카테고리를 추가할 위치
이름
사용자에게 표시됩니다. 명확하고 설명적으로 유지하세요.설명
사용자에게 표시됩니다. 이 카테고리가 처리할 알림 유형을 간략하게 설명하세요.중요도
알림이 얼마나 눈에 띄고 방해가 되는지 제어합니다:- 낮음: 무음, 알림 없음
- 중간: 소리/진동 없음, 최소한의 시각적 방해
- 높음: 소리가 재생되거나 진동하지만 화면 팝업 없음
- 긴급: 소리가 재생되고 전체 화면 알림 표시
소리
- 꺼짐: 소리 없음
- 기본값: 기기의 기본 알림 톤
- 사용자 지정: 사용자 지정 소리를 업로드하고 참조합니다(파일 확장자 없음).
예:
alert_beep(alert_beep.wav아님) 설정 지침은 알림 소리를 참조하세요.
진동
- 꺼짐: 진동 없음
- 기본값: 기기의 진동 패턴 사용
- 사용자 지정: 패턴을 사용하여 자체 정의합니다(밀리초 단위).
예:
0, 300, 500, 300→ 0ms 대기, 300ms 진동, 500ms 일시 중지, 300ms 진동.
LED 색상
일부 Android 기기는 LED 표시기를 지원합니다:- 꺼짐: LED 없음
- 기본값: 기기 기본값
- 사용자 지정: ARGB 16진수 값(예: 파란색의 경우
FF0000FF)
배지
앱 아이콘에 배지 수를 표시합니다:- 활성화됨: 배지가 표시됨
- 비활성화됨: 배지가 표시되지 않음
잠금 화면 가시성
- 공개: 전체 콘텐츠 표시
- 비공개: 앱 이름만 표시, 콘텐츠 숨김
- 비밀: 잠금 화면에 알림이 표시되지 않음
카테고리가 만들어지면 알림에서 사용할 수 있습니다.
카테고리 업데이트
기기가 카테고리에서 알림을 받으면 Android는 해당 카테고리의 동작을 잠급니다. 중요도, 소리, 진동 또는 기타 설정에 대한 변경 사항은 소급 적용되지 않습니다. 옵션:- 동작을 업데이트하려면: 새 카테고리를 만듭니다.
- 변경 사항을 테스트하려면: 앱 데이터를 지우거나 앱을 제거하고 다시 설치합니다.
- 채널 이름
- 채널 그룹 이름
카테고리 삭제
사용자 기기에서 삭제된 카테고리를 제거하려면:- OneSignal 대시보드에서 카테고리를 삭제합니다.
- 알림 센터에서 모든 알림이 지워졌는지 확인합니다.
- 사용자가 다음을 수행하도록 합니다:
- 60초 이상 앱을 백그라운드에 둡니다
- 다시 엽니다(SDK 동기화 트리거)
알림에서 카테고리 사용
OneSignal 대시보드에서
- 메시지 작성기에서 Android 플랫폼 설정으로 이동합니다.
- “카테고리” 아래에서 카테고리를 선택합니다.
- 소리, 잠금 화면 및 LED 설정은 카테고리에서 가져오고 UI에서 숨겨집니다.
REST API 사용
Create message API 요청에서android_channel_id를 사용합니다.
Android 카테고리 설정 화면에서 채널 ID 찾기
existing_android_channel_id를 사용합니다.
FAQ
Android 카테고리가 작동하지 않는 이유는 무엇인가요?
- 잘못된 초기화: OneSignal이
Activity가 아닌Application클래스에서 초기화되었는지 확인하세요. Android SDK 설정을 참조하세요. - 오래된 카테고리: 푸시를 보낸 후 카테고리를 변경한 경우 Android가 해당 변경 사항을 적용하지 않을 수 있습니다. 대신 새 카테고리를 만드세요.
카테고리가 방해 금지(DND) 모드에서 소리를 재생할 수 있나요?
아니요. OneSignal은 카테고리에setBypassDnd를 설정하지 않습니다. DND를 재정의하려면 프로그래밍 방식으로 자체 채널을 만들고 이 설정을 활성화하세요. setBypassDnd를 참조하세요.
카테고리 이름이나 설명을 현지화할 수 있나요?
아니요. OneSignal은 카테고리에 대한 여러 언어를 지원하지 않습니다. 현지화를 지원하려면 자체 Android 채널을 정의하고 푸시 API 요청에서existing_android_channel_id를 통해 참조하세요.