Notification Category: 정의, 카테고리 종류 및 iOS에서의 작동 방식

iOS에서 Notification Category란?

Notification Category는 iOS 8.0부터 제공되는 기능으로, 개발자가 푸시 알림을 분류하고 대화형 작업을 추가할 수 있게 합니다. 사용자가 알림을 받고 강하게 누르거나(3D Touch) 길게 누르면 카테고리에 정의된 버튼이 나타납니다. 이렇게 하면 알림이 대화형이 되어 사용자가 앱을 열지 않고도 작업을 수행할 수 있습니다.

카테고리는 UNNotificationCategory 객체를 사용하여 등록되며, 식별자, 작업 배열 및 선택적 표시 매개변수를 포함합니다. 시스템은 APNS 페이로드의 카테고리 식별자를 사용하여 등록된 카테고리를 찾고 해당 버튼을 표시합니다.

Android Notification Channel과 달리 iOS Category는 중요도, 사운드 또는 진동을 관리하지 않습니다. 유일한 목적은 알림에 대화형 기능을 제공하는 것입니다: 응답, 확인, 취소 또는 텍스트 입력 버튼.

카테고리는 필수인가요?

iOS에서 푸시 알림을 표시하는 데 카테고리는 필수가 아닙니다. 알림은 항상 표시됩니다 — 카테고리가 등록되어 있으면 버튼과 함께, 그렇지 않으면 버튼 없이 표시됩니다. 카테고리는 알림에 상호작용성을 추가하는 데만 필요합니다.

알림 카테고리는 어떻게 작동하나요?

카테고리 메커니즘은 네 단계로 구성됩니다: 클라이언트에서 카테고리 등록, 카테고리가 포함된 APNS 페이로드 전송, 시스템이 카테고리를 인식, 사용자 작업 처리.

• 등록 — 앱이 작업 배열로 UNNotificationCategory를 생성하고 UNUserNotificationCenter에 등록
• 전송 — 서버가 APNS 페이로드에 category 키를 포함하고 값이 카테고리 식별자와 일치
• 표시 — iOS가 알림을 표시하고 포스 터치 시 카테고리와 연결된 버튼을 표시
• 처리 — 사용자가 버튼을 탭하여 UNUserNotificationCenterDelegate.didReceive response 트리거

카테고리의 작업은 두 가지 유형이 있습니다: foreground(앱 열기)와 background(백그라운드에서 실행). 백그라운드 작업의 경우 앱은 UNNotificationActionHandler에서 처리하는 데 제한된 시간(약 30초)을 받습니다.

카테고리 등록 시 옵션

UNNotificationCategory는 options 매개변수를 통해 여러 옵션을 지원합니다: customDismissAction — 알림을 스와이프하여 닫을 때 이벤트 수신, allowInCarPlay — CarPlay에서 작업 표시, hiddenPreviewsBodyPlaceholder — 숨겨진 미리보기의 사용자 지정 플레이스홀더 텍스트.

UNNotificationAction: 작업 유형

iOS는 알림 카테고리에 두 가지 유형의 작업을 제공합니다. 각 유형은 고유한 목적과 사용자와의 상호 작용 방식을 가지고 있습니다.

UNTextInputAction은 iOS의 고유한 기능입니다. 사용자가 “답장” 버튼을 탭하면 시스템이 텍스트 필드를 표시하고 사용자가 답변을 입력합니다. 입력된 텍스트는 작업 식별자와 함께 델리게이트에 전달됩니다. 이를 통해 앱을 열지 않고도 빠른 답장을 구현할 수 있습니다.

작업 옵션: options.authenticationRequired — 기기 잠금 해제 필요, options.destructive — 버튼을 빨간색으로 강조(위험한 작업용), options.foreground — 탭 후 앱 열기.

iOS 코드에서 카테고리 설정

카테고리는 앱 실행 시 등록되며, 일반적으로 didFinishLaunchingWithOptions 메서드에서 수행됩니다. 등록은 UNUserNotificationCenter를 통해 알림 권한을 요청한 후 이루어집니다. 카테고리는 매 실행 시 업데이트할 수 있습니다 — 이전 버전은 새 버전으로 대체됩니다.

import UserNotifications

class AppDelegate: UIResponder, UIApplicationDelegate {

    func registerNotificationCategories() {
        let replyAction = UNTextInputNotificationAction(
            identifier: "reply",
            title: "답장",
            options: [.foreground],
            textInputButtonTitle: "보내기",
            textInputPlaceholder: "메시지 입력..."
        )

        let deleteAction = UNNotificationAction(
            identifier: "delete",
            title: "삭제",
            options: [.destructive]
        )

        let messageCategory = UNNotificationCategory(
            identifier: "message",
            actions: [replyAction, deleteAction],
            intentIdentifiers: [],
            options: [.customDismissAction]
        )

        UNUserNotificationCenter.current()
            .setNotificationCategories([messageCategory])
    }

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions options: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        registerNotificationCategories()
        return true
    }
}

카테고리를 등록한 후, APNS 페이로드에 category = “message”가 포함된 모든 알림은 “답장” 및 “삭제” 버튼을 표시합니다. 탭 처리는 userNotificationCenter:didReceive response에서 이루어지며, actionIdentifier가 눌린 버튼을 결정합니다.

델리게이트에서 탭 처리

사용자가 카테고리 버튼을 탭하면 iOS는 UNNotificationResponse 객체와 함께 UNUserNotificationCenterDelegate를 호출합니다. response.actionIdentifier에는 탭된 버튼의 식별자가 포함되고, response.notification.request.content.userInfo에는 페이로드의 사용자 지정 데이터가 포함됩니다.

Android 채널과의 차이점

Android Notification Channel에 익숙한 개발자들은 종종 이를 iOS Notification Category와 혼동합니다. 이름은 비슷하지만, 이러한 메커니즘은 다른 작업을 해결하고 다르게 작동합니다.

• 목적 — Android Channel은 알림의 중요도와 표시 여부를 관리하고, iOS Category는 대화형 작업을 관리
• 필수 여부 — Android Channel은 알림 표시에 필수, iOS Category는 선택 사항
• 사용자 제어 — Android 사용자는 시스템 설정에서 채널을 구성, iOS 카테고리는 사용자에게 직접 표시되지 않음
• 그룹화 — Android Channel은 ChannelGroups로 그룹화 가능, iOS Category는 그룹화되지 않음

두 플랫폼 모두 두 메커니즘을 결합할 수 있습니다: Android에서는 NotificationCompat의 작업이 있는 채널에 알림이 속할 수 있고, iOS에서는 카테고리가 채널을 보완합니다. iOS에서 채널은 thread-id라고 하며 알림 센터에서 알림을 그룹화하는 데 사용됩니다.

카테고리가 있는 APNS 페이로드

알림에 카테고리 버튼이 표시되려면 서버가 APNS 페이로드에 category 키를 포함해야 합니다. 이 키가 없으면 시스템은 알림에 어떤 카테고리를 적용해야 할지 알 수 없습니다.

{
    "aps": {
        "alert": {
            "title": "새 메시지",
            "body": "안나: 안녕하세요! 어떻게 지내세요?"
        },
        "category": "message",
        "thread-id": "chat_123",
        "badge": 5,
        "sound": "default"
    }
}

category 키는 클라이언트에서 setNotificationCategories를 통해 등록된 식별자와 정확히 일치해야 합니다. 대소문자를 구분합니다 — “message”와 “Message”는 다른 카테고리로 간주됩니다. 카테고리를 찾을 수 없으면 알림이 버튼 없이 표시되며 로그에 오류가 기록되지 않습니다.

알 수 없는 카테고리 처리

서버가 클라이언트에 등록되지 않은 카테고리로 알림을 보내면 iOS는 카테고리를 무시하고 알림을 버튼 없이 표시합니다. 오류가 기록되지 않으며 앱은 불일치를 알 수 없습니다. 서버와 클라이언트 간에 카테고리 목록을 동기화하는 것이 좋습니다.

카테고리 디자인 패턴

iOS에서 알림 카테고리를 설계할 때는 하나의 카테고리 — 하나의 시나리오 원칙을 따르세요. 각 카테고리는 특정 유형의 상호 작용에 해당해야 합니다: 메시지에 답장, 작업 확인, 요청 거부. 하나의 카테고리에 다른 시나리오를 혼합하지 마세요.

앱을 열지 않고 텍스트를 입력해야 하는 시나리오(메시징 답장, 댓글, 빠른 메모)에는 UNTextInputAction을 사용하세요. 텍스트 작업은 참여도를 높입니다 — 사용자는 앱 내에서 5회 이상의 탭 대신 2회의 탭으로 의미 있는 작업을 수행합니다.

위험한 작업(삭제, 차단)에는 destructive 옵션을 사용하세요. iOS는 이러한 버튼을 빨간색으로 강조하여 작업의 되돌릴 수 없음을 사용자에게 경고합니다. 기기 잠금 해제가 필요한 작업(개인 데이터 보기)에는 authenticationRequired를 지정하세요.

다양한 기기에서 카테고리를 테스트하세요: 3D Touch 지원 iPhone, 3D Touch 미지원 iPhone(길게 누르기), iPad, Mac. Apple 플랫폼 간에 카테고리 동작이 약간 다를 수 있습니다. CarPlay에 특별히 주의하세요: 카테고리 버튼이 자동차 화면에 나타나며 운전자 안전을 위해 최소한의 텍스트로 설계해야 합니다.