Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

대화에 알림 대화창 사용

알림 버블을 사용하면 사용자가 대화를 더 쉽게 확인하고 참여할 수 있습니다.

그림 1. 채팅 풍선

버블은 다른 앱 콘텐츠 위에 떠 있으며 사용자는 버블을 펼쳐 앱 콘텐츠를 표시하고 상호작용할 수 있으며 사용하지 않을 때는 접을 수 있습니다.

기기가 잠겨 있거나 화면 항상 켜기가 활성화되어 있으면 대화창이 일반적인 알림처럼 표시됩니다.

사용자가 알림 버블을 사용 설정합니다. 대화창을 지원하는 알림에서 대화창 버튼을 탭하면 됩니다. 이렇게 하면 특정 채팅이 항상 버블로 표시됩니다. 설정에서 사용자는 버블로 표시한 채팅을 조정하거나 전체 앱의 설정을 수정할 수 있습니다.

사용자는 다음 작업을 할 수 있습니다.

앱에 표시되는 알림 버블을 모두 차단합니다. 알림이 차단되지는 않지만 버블로 표시되지 않습니다.
앱에서 선택된 알림 버블을 허용합니다. 버블 버튼을 사용하여 버블링된 알림은 '선택'됩니다.
앱의 모든 알림 버블을 허용합니다. BubbleMetadata로 전송된 모든 알림이 버블로 표시됩니다.

알림 버블 API

알림 버블은 알림 API를 사용하여 생성됩니다. 알림을 풍선으로 표시하려면 추가 데이터를 첨부하세요.

도움말 풍선 펼쳐 보기는 개발자가 선택하는 활동에서 생성됩니다. 활동이 대화창으로 올바르게 표시되도록 구성합니다. 활동은 크기 조절 가능하고 삽입되어야 합니다. 이러한 요구사항 중 하나라도 충족하지 않으면 시스템은 이를 알림으로 표시합니다.

다음 코드는 대화창을 구현하는 방법을 보여줍니다.

<activity
  android:name=".bubbles.BubbleActivity"
  android:theme="@style/AppTheme.NoActionBar"
  android:label="@string/title_activity_bubble"
  android:allowEmbedded="true"
  android:resizeableActivity="true"
/>

앱에서 동일한 유형의 여러 대화창(예: 여러 연락처와의 여러 채팅 대화)을 표시하는 경우 활동은 여러 인스턴스를 실행할 수 있어야 합니다. Android 10 이하를 실행하는 기기에서는 documentLaunchMode를 "always"로 명시적으로 설정하지 않는 한 알림이 풍선으로 표시되지 않습니다. Android 11부터는 시스템이 모든 대화의 documentLaunchMode를 "always"로 자동 설정하므로 이 값을 명시적으로 설정할 필요가 없습니다.

알림 버블을 보내려면 다음 단계를 따르세요.

평소와 같이 알림을 만듭니다.
BubbleMetadata.Builder(PendingIntent, Icon) 또는 BubbleMetadata.Builder(String)를 호출하여 BubbleMetadata 객체를 만듭니다.
setBubbleMetadata()를 사용하여 알림에 메타데이터를 추가합니다.
Android 11 (API 수준 30) 이상을 타겟팅하는 경우 풍선 메타데이터 또는 알림이 공유 바로가기를 참조하는지 확인합니다.
버블로 표시되는 알림을 취소하지 않도록 앱을 수정합니다. 알림을 취소하면 화면에서 대화창이 삭제됩니다. 풍선을 열면 연결된 알림이 자동으로 숨겨집니다.

이러한 단계는 다음 예에 나와 있습니다.

// Create a bubble intent.
val target = Intent(context, BubbleActivity::class.java)
val bubbleIntent =
    PendingIntent.getActivity(context, 0, target, PendingIntent.FLAG_IMMUTABLE /* flags */)
val category = "com.example.category.IMG_SHARE_TARGET"

val chatPartner = Person.Builder()
    .setName("Chat partner")
    .setImportant(true)
    .build()

// Create a sharing shortcut.
val shortcutId = generateShortcutId()
val shortcut =
    ShortcutInfoCompat.Builder(context, shortcutId)
        .setCategories(setOf(category))
        .setIntent(Intent(Intent.ACTION_DEFAULT))
        .setLongLived(true)
        .setShortLabel("Chat partner name")
        .build()
// Publish the shortcut, otherwise the bubble metadata will not apply.
ShortcutManagerCompat.pushDynamicShortcut(context, shortcut)

// Create a bubble metadata.
val bubbleData = NotificationCompat.BubbleMetadata.Builder(bubbleIntent,
    IconCompat.createWithResource(context, R.drawable.ic_logo))
    .setDesiredHeight(600)
    .build()

// Create a notification, referencing the sharing shortcut.
val builder = NotificationCompat.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(R.drawable.chat)
    .setBubbleMetadata(bubbleData)
    .setShortcutId(shortcutId)
    .addPerson(chatPartner)NotificationsSnippets.kt

버블이 전송될 때 앱이 포그라운드에 있으면 중요도는 무시되고 사용자가 앱의 버블이나 알림을 차단하지 않는 한 버블이 항상 표시됩니다.

확장된 대화창 만들기

버블이 자동으로 펼침 상태로 표시되도록 구성할 수 있습니다. 사용자가 버튼을 탭하여 새 채팅을 시작하는 등 버블을 생성하는 작업을 실행하는 경우에만 이 기능을 사용하는 것이 좋습니다. 이 경우 버블이 생성될 때 전송되는 초기 알림을 표시하지 않는 것도 좋습니다.

setAutoExpandBubble() 및 setSuppressNotification() 메서드를 사용하여 이러한 동작을 사용 설정하는 플래그를 설정할 수 있습니다.

다음 예에서는 버블이 자동으로 펼침 상태로 표시되도록 구성하는 방법을 보여줍니다.

val bubbleMetadata = NotificationCompat.BubbleMetadata.Builder()
    .setDesiredHeight(600)
    .setIntent(bubbleIntent)
    .setAutoExpandBubble(true)
    .setSuppressNotification(true)
    .build()NotificationsSnippets.kt

버블 콘텐츠 수명 주기

대화창이 펼쳐지면 콘텐츠 활동은 정상적인 프로세스 수명 주기를 거치며, 이로 인해 애플리케이션이 포그라운드 프로세스가 됩니다(아직 포그라운드 프로세스가 아닌 경우).

풍선이 접히거나 닫히면 활동이 소멸됩니다. 이로 인해 앱에 실행 중인 다른 포그라운드 구성요소가 있는지에 따라 프로세스가 캐시되고 나중에 종료될 수 있습니다.

버블이 표시되는 상황

사용자에게 방해가 되지 않도록 버블은 특정 상황에서만 표시됩니다.

앱이 Android 11 (API 수준 30) 이상을 타겟팅하는 경우 대화 요구사항을 충족하지 않으면 알림이 풍선으로 표시되지 않습니다. 앱이 Android 10 (API 수준 29) 이하를 타겟팅하는 경우 다음 조건 중 하나 이상을 충족하는 경우에만 알림이 풍선으로 표시됩니다.

알림에서 MessagingStyle을 사용하고 Person가 추가되었습니다.
알림은 Service.startForeground 호출에서 발생하며 category은 CATEGORY_CALL이고 Person가 추가되었습니다.
알림이 전송되었을 때 앱이 포그라운드에 있습니다.

이러한 조건이 하나도 충족되지 않으면 알림이 풍선 대신 표시됩니다.

풍선에서 활동 실행

풍선이 새 활동을 실행하면 새 활동은 동일한 작업 및 동일한 풍선 창 내에서 실행되거나 전체 화면의 새 작업에서 실행되어 실행한 풍선을 접습니다.

버블과 동일한 작업에서 새 활동을 실행하려면 다음 단계를 따르세요. 1. 인텐트, activity.startActivity(intent)를 실행할 때 활동 컨텍스트를 사용합니다. 1. 인텐트에 FLAG_ACTIVITY_NEW_TASK 플래그를 설정하지 마세요.

그렇지 않으면 새 활동이 새 작업에서 시작되고 대화창이 접힙니다.

대화창은 특정 대화를 나타내므로 대화창 내에서 실행되는 활동은 해당 대화와 관련이 있어야 합니다. 또한 버블 내에서 활동을 실행하면 버블의 작업 스택이 증가하고 사용자 환경이 복잡해질 수 있습니다(특히 탐색 관련).

권장사항

진행 중인 커뮤니케이션의 일부이거나 사용자가 콘텐츠에 대한 대화창을 명시적으로 요청하는 경우와 같이 중요한 경우에만 알림을 대화창으로 전송합니다. 대화창은 화면 공간을 사용하고 다른 앱 콘텐츠를 가립니다.
풍선 알림이 일반 알림으로도 작동하는지 확인합니다. 사용자가 대화창을 사용 중지하면 대화창 알림이 일반 알림으로 표시됩니다.
BackHandler 컴포저블을 사용하고 enabled 매개변수를 UI 상태에 연결하여 필요한 경우에만 뒤로 누르기를 가로챕니다. 핸들러가 사용 중지되면 풍선이 접힙니다.

접힌 도움말 풍선에 업데이트된 메시지가 수신되면 읽지 않은 메시지를 나타내는 배지 아이콘이 도움말 풍선에 표시됩니다. 사용자가 연결된 앱에서 메시지를 열면 다음 단계를 따르세요.

BubbleMetadata를 업데이트하여 알림을 표시하지 않습니다. BubbleMetadata.Builder.setSuppressNotification()을 호출합니다. 이렇게 하면 사용자가 메시지와 상호작용했음을 나타내는 배지 아이콘이 삭제됩니다.
BubbleMetadata 업데이트와 함께 제공되는 소리 또는 진동을 억제하려면 Notification.Builder.setOnlyAlertOnce()를 true로 설정합니다.

샘플 앱

SociaLite 샘플 앱은 대화창을 사용하는 대화 앱입니다. 이 앱은 시연 목적으로 챗봇을 사용합니다. 실제 애플리케이션에서는 사람이 보내는 메시지에 대화창을 사용합니다.