알림 채널 만들기 및 관리

Android 8.0 (API 수준 26)부터 모든 알림은 채널에 할당되어야 합니다. 각 채널에서 해당 채널의 모든 알림에 적용되는 시각적 및 청각적 동작을 설정할 수 있습니다. 사용자는 이러한 설정을 변경하고 앱의 어떤 알림 채널이 방해가 되거나 표시될 수 있는지 결정할 수 있습니다.

Android 8.0의 채널 및 기타 알림 기능에 관한 개요는 다음 동영상을 참고하세요.

알림 채널의 사용자 설정은 그림 1과 같이 시스템 설정의 각 앱에서 사용할 수 있습니다.

그림 1. 시계 앱 및 채널 중 하나의 알림 설정

알림 채널을 만든 후에는 알림 동작을 변경할 수 없습니다. 이 시점에서는 사용자가 완전히 제어할 수 있습니다. 하지만 채널 이름과 설명은 변경할 수 있습니다.

전송해야 하는 알림 유형별로 채널을 만듭니다. 사용자가 선택한 사항을 반영하는 알림 채널을 만들 수도 있습니다. 예를 들어 메시지 앱에서 사용자가 만든 각 대화 그룹에 별도의 알림 채널을 설정할 수 있습니다.

Android 8.0 (API 수준 26) 이상을 타겟팅하는 경우 하나 이상의 알림 채널을 구현해야 합니다. targetSdkVersion가 25 이하로 설정된 경우 앱이 Android 8.0 (API 수준 26) 이상에서 실행되면 Android 7.1 (API 수준 25) 이하를 실행하는 기기에서와 동일하게 작동합니다.

알림 채널 만들기

알림 채널을 만들려면 다음 단계를 따르세요.

  1. 고유한 채널 ID, 사용자에게 표시되는 이름, 중요도 수준을 사용하여 NotificationChannel 객체를 구성합니다.

  2. 원하는 경우 setDescription()를 사용하여 시스템 설정에서 사용자에게 표시되는 설명을 지정합니다.

  3. 알림 채널을 createNotificationChannel()에 전달하여 등록합니다.

다음 예시에서는 알림 채널을 만들고 등록하는 방법을 보여줍니다.

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Create the NotificationChannel.
    val importance = NotificationManager.IMPORTANCE_DEFAULT
    val mChannel = NotificationChannel(CHANNEL_ID, name, importance)
    mChannel.description = descriptionText
    // Register the channel with the system. You can't change the importance
    // or other notification behaviors after this.
    val notificationManager =
        context.getSystemService(NotificationManager::class.java)
    notificationManager?.createNotificationChannel(mChannel)
}

기존 알림 채널을 원래 값으로 다시 만들면 아무 작업도 실행되지 않으므로 앱을 시작할 때 이 코드를 호출해도 안전합니다.

기본적으로 특정 채널에 게시된 모든 알림은 NotificationManagerCompat 클래스의 중요도 수준(예: IMPORTANCE_DEFAULT 또는 IMPORTANCE_HIGH)에 따라 정의된 시각적 및 청각적 동작을 사용합니다. 중요도 수준에 관한 자세한 내용은 다음 섹션을 참고하세요.

채널의 기본 알림 동작을 추가로 맞춤설정하려면 NotificationChannel에서 enableLights(), setLightColor(), setVibrationPattern()와 같은 메서드를 호출하면 됩니다. 채널을 만들고 나면 이러한 설정을 변경할 수 없으며 이러한 동작의 활성화 여부는 사용자가 최종적으로 제어할 수 있습니다.

createNotificationChannels()를 호출하여 단일 작업으로 여러 알림 채널을 만들 수도 있습니다.

중요도 수준 설정

채널 중요도는 채널에 게시된 모든 알림의 방해 수준에 영향을 미칩니다. IMPORTANCE_NONE(0)에서 IMPORTANCE_HIGH(4)까지의 5가지 중요도 수준 중 하나를 사용하여 NotificationChannel 생성자에 지정합니다.

Android 7.1 (API 수준 25) 이하를 실행하는 기기를 지원하려면 NotificationCompat 클래스의 우선순위 상수를 사용하여 각 알림에 대해 setPriority()도 호출해야 합니다.

중요도 (NotificationManager.IMPORTANCE_*) 및 우선순위(NotificationCompat.PRIORITY_*) 상수는 다음 표와 같이 사용자에게 표시되는 중요도 옵션에 매핑됩니다.

사용자가 볼 수 있는 중요도 수준 중요도(Android 8.0 이상) 우선순위(Android 7.1 이하)
긴급
소리가 나고 헤드업 알림으로 표시됩니다.
IMPORTANCE_HIGH PRIORITY_HIGH 또는 PRIORITY_MAX
높음
소리가 납니다.
IMPORTANCE_DEFAULT PRIORITY_DEFAULT
중간
소리가 나지 않습니다.
IMPORTANCE_LOW PRIORITY_LOW
낮음
소리가 나지 않으며 상태 표시줄에 표시되지 않습니다.
IMPORTANCE_MIN PRIORITY_MIN
없음
소리가 나지 않으며 상태 표시줄이나 음영에 표시되지 않습니다.
IMPORTANCE_NONE N/A

중요도와 관계없이 모든 알림은 알림 창과 같은 비침해적 시스템 UI 위치에 런처 아이콘의 배지로 표시됩니다. 단, 알림 배지의 모양을 수정할 수는 있습니다.

채널을 NotificationManager에 제출한 후에는 중요도 수준을 변경할 수 없습니다. 그러나 사용자는 언제든지 앱 채널의 환경설정을 변경할 수 있습니다.

적절한 우선순위 수준을 선택하는 방법에 관한 자세한 내용은 알림 디자인 가이드의 '우선순위 수준'을 참고하세요.

알림 채널 설정 읽기

사용자는 진동 및 알림 소리와 같은 동작을 포함하여 알림 채널의 설정을 수정할 수 있습니다. 사용자가 알림 채널에 적용하는 설정을 확인하려면 다음 단계를 따르세요.

  1. getNotificationChannel() 또는 getNotificationChannels()를 호출하여 NotificationChannel 객체를 가져옵니다.

  2. getVibrationPattern(), getSound(), getImportance()와 같은 특정 채널 설정을 쿼리합니다.

앱의 의도된 동작을 방해한다고 생각되는 채널 설정을 감지하면 사용자에게 설정을 변경하도록 제안하고 다음 섹션에 표시된 대로 채널 설정을 여는 작업을 제공할 수 있습니다.

알림 채널 설정 열기

알림 채널을 만든 후에는 알림 채널의 시각적 및 청각적 동작을 프로그래매틱 방식으로 변경할 수 없습니다. 사용자만 시스템 설정에서 채널 동작을 변경할 수 있습니다. 사용자가 이러한 알림 설정에 빠르게 액세스할 수 있도록 하려면 앱의 설정 UI에 이러한 시스템 설정을 여는 항목을 추가하세요.

ACTION_CHANNEL_NOTIFICATION_SETTINGS 작업을 사용하는 Intent을 통해 알림 채널의 시스템 설정을 열 수 있습니다.

예를 들어 다음 샘플 코드는 사용자를 알림 채널 설정으로 리디렉션하는 방법을 보여줍니다.

val intent = Intent(Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS).apply {
    putExtra(Settings.EXTRA_APP_PACKAGE, context.packageName)
    putExtra(Settings.EXTRA_CHANNEL_ID, CHANNEL_ID)
}
Button(onClick = {
    context.startActivity(intent)
}) {
    Text("Open Channel Settings")
}

인텐트에는 앱의 패키지 이름(애플리케이션 ID라고도 함)과 수정할 채널을 지정하는 두 개의 추가 항목이 필요합니다.

알림 채널 삭제

deleteNotificationChannel()를 호출하여 알림 채널을 삭제할 수 있습니다. 다음 샘플 코드는 이 프로세스를 완료하는 방법을 보여줍니다.

val notificationManager =
    ContextCompat.getSystemService<NotificationManager>(context, NotificationManager::class.java)
notificationManager?.deleteNotificationChannel(channelId)

알림 채널 그룹 만들기

설정 UI에서 채널 표시를 추가로 구성하려면 채널 그룹을 만들면 됩니다. 앱이 여러 사용자 계정을 지원하는 경우 각 계정에 알림 채널 그룹을 만들 수 있으므로 이 방법이 좋습니다. 채널 그룹은 사용자가 이름이 동일한 여러 알림 채널을 구분하고 제어하는 데 도움이 됩니다.

그림 2. 개인 계정과 직장 계정의 그룹이 있는 알림 채널 설정

예를 들어 소셜 네트워킹 앱에는 개인 계정과 직장 계정 지원이 포함될 수 있습니다. 이 시나리오에서는 각 계정에 다음과 같이 동일한 함수와 이름을 가진 여러 알림 채널이 필요할 수 있습니다.

  • 채널이 두 개 있는 개인 계정:

    • 새로운 댓글

    • 추천 게시물

  • 채널이 두 개 있는 비즈니스 계정:

    • 새로운 댓글

    • 추천 게시물

각 계정의 알림 채널을 그룹으로 구성하면 사용자가 채널을 구분할 수 있습니다.

각 알림 채널 그룹에는 패키지 내에서 고유해야 하는 ID와 사용자에게 표시되는 이름이 필요합니다. 다음 스니펫은 알림 채널 그룹을 만드는 방법을 보여줍니다.

fun createNotificationChannelGroup(context: Context, groupId: String, groupName: String) {
    val notificationManager =
        ContextCompat.getSystemService(context, NotificationManager::class.java)
    notificationManager?.createNotificationChannelGroup(NotificationChannelGroup(groupId, groupName))
}

새 그룹을 만든 후 setGroup()를 호출하여 새 NotificationChannel 객체를 그룹과 연결할 수 있습니다.

알림 관리자에게 채널을 제출한 후에는 알림 채널과 그룹 간의 연결을 변경할 수 없습니다.