알림 트레이 관리

​

트레이에서의 알림 생명주기

​

클릭 및 해제 동작

​

복원된 알림 (Android)

​

배지 동작

​

프로그래밍 방식으로 알림 지우기

• 콘텐츠 소비 동기화: 사용자가 알림이 가리키는 화면(받은 편지함, 메시지 센터 또는 활동 피드)을 열어 알림이 더 이상 필요 없게 된 경우. 모두 지우거나, 일부 콘텐츠만 소비되었다면 대상 지정 메서드를 사용하세요.
• 로그아웃: 이전 사용자의 알림이 다음 사용자에게 표시되지 않도록 모든 것을 지웁니다.

​

clearAllNotifications()

​

removeNotification() 및 removeGroupedNotifications() (Android)

​

일정 시간 후 알림 자동 해제

• Android 8.0(API 26) 이상: 알림 서비스 확장에서 setTimeoutAfter()를 사용하여 타임아웃을 설정하세요. 타임아웃이 경과하면 Android가 알림 창에서 알림을 제거합니다. API 26 미만 기기에서는 호출이 무시되고 사용자가 상호 작용할 때까지 알림이 유지됩니다.
• iOS: 지원되지 않습니다. iOS에는 전달된 알림을 자동으로 만료시키는 방법이 없습니다. 가장 가까운 옵션은 collapse_id를 통해 더 새로운 알림으로 교체하거나, 이후 푸시가 도착했을 때 Apple의 removeDeliveredNotifications(withIdentifiers:)로 Notification Service Extension에서 제거하는 것입니다.

class NotificationServiceExtension : INotificationServiceExtension {
    override fun onNotificationReceived(event: INotificationReceivedEvent) {
        event.notification.setExtender { builder ->
            // Remove this notification from the shade after 10 minutes (API 26+ only)
            builder.setTimeoutAfter(10 * 60 * 1000L)
        }
    }
}

public class NotificationServiceExtension implements INotificationServiceExtension {
    @Override
    public void onNotificationReceived(INotificationReceivedEvent event) {
        event.getNotification().setExtender(builder ->
            // Remove this notification from the shade after 10 minutes (API 26+ only)
            builder.setTimeoutAfter(10 * 60 * 1000L)
        );
    }
}

​

서비스 확장으로 알림 커스터마이즈

• Android에서는 INotificationServiceExtension을 구현하고 setExtender()를 사용하여 NotificationCompat 옵션을 변경하거나, event.preventDefault()를 호출하여 표시를 억제하세요.
• iOS에서는 리치 미디어, 배지 증가 및 확인된 전달을 위해 UNNotificationServiceExtension(설정 중 생성된 OneSignalNotificationServiceExtension)을 사용하세요.

​

FAQ

​

Android에서 앱을 열 때 오래된 알림이 다시 나타나는 이유는 무엇인가요?

​

TTL이 만료되면 트레이에서 알림이 제거되나요?

​

트레이를 지우지 않고 배지만 지울 수 있나요?

​

사용자가 알림을 해제할 때를 위한 리스너가 있나요?