Criar uma notificação expansível

Uma notificação básica geralmente inclui um título, uma linha de texto e ações que o usuário pode realizar em resposta. Para fornecer mais informações, crie notificações grandes e expansíveis aplicando um dos vários modelos de notificação, conforme descrito neste documento.

Para começar, crie uma notificação com todo o conteúdo básico, conforme descrito em Criar uma notificação. Em seguida, chame setStyle() com um objeto de estilo e forneça informações correspondentes a cada modelo, conforme mostrado nos exemplos a seguir.

Adicionar uma imagem grande

Para adicionar uma imagem à notificação, transmita uma instância de NotificationCompat.BigPictureStyle para setStyle().

var notification =
    NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(com.example.compose.snippets.R.drawable.ic_logo)
        .setContentTitle("Title")
        .setContentText("Content text")
        .setStyle(
            NotificationCompat.BigPictureStyle()
                .bigPicture(bitmapImage)
        )
        .build()

Para que a imagem apareça como uma miniatura apenas enquanto a notificação está compactada, conforme mostrado na figura a seguir, chame setLargeIcon() e transmita a imagem. Em seguida, chame BigPictureStyle.bigLargeIcon() e transmita null para que o ícone grande desapareça quando a notificação for expandida:

notification = NotificationCompat.Builder(context, CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_logo)
    .setContentTitle("Title")
    .setContentText("Content text")
    .setLargeIcon(Icon.createWithResource(context, R.drawable.dog))
    .setStyle(
        NotificationCompat.BigPictureStyle()
            .bigPicture(bitmapImage)
            .bigLargeIcon(null as Bitmap?)
    )
    .build()

Uma notificação recolhida e uma expandida com uma imagem azul
Figura 1. Uma notificação usando NotificationCompat.BigPictureStyle.

Adicionar um bloco grande de texto

Aplique NotificationCompat.BigTextStyle para mostrar texto na área de conteúdo expandida da notificação:

notification = NotificationCompat.Builder(context, CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_logo)
    .setContentTitle("Sender name")
    .setContentText("Email subject")
    .setLargeIcon(Icon.createWithResource(context, R.drawable.dog))
    .setStyle(
        NotificationCompat.BigTextStyle()
            .bigText(someVeryLongMessage)
    )
    .build()

Uma notificação recolhida e uma expandida usando BigTextStyle
Figura 2. Uma notificação usando NotificationCompat.BigTextStyle.

Criar uma notificação no estilo de caixa de entrada

Aplique NotificationCompat.InboxStyle a uma notificação se quiser adicionar várias linhas de resumo curtas, como snippets de e-mails recebidos. Isso permite adicionar vários textos de conteúdo, cada um truncado em uma linha, em vez da linha contínua de texto fornecida por NotificationCompat.BigTextStyle.

Para adicionar uma nova linha, chame addLine() até seis vezes, como mostrado no exemplo a seguir. Se você adicionar mais de seis linhas, apenas as primeiras seis vão ficar visíveis.

notification = NotificationCompat.Builder(context, CHANNEL_ID)
    .setSmallIcon(R.drawable.mail)
    .setContentTitle("5 New mails from Frank")
    .setContentText("Check them out")
    .setLargeIcon(bitmapImage)
    .setStyle(
        NotificationCompat.InboxStyle()
            .addLine("Re: Planning")
            .addLine("Delivery on its way")
            .addLine("Follow-up")
    )
    .build()

O resultado é semelhante à figura a seguir:

Uma notificação expandida no estilo da caixa de entrada
Figura 3. Uma notificação expandida no estilo da caixa de entrada.

Mostrar uma conversa em uma notificação

Aplique NotificationCompat.MessagingStyle para mostrar mensagens sequenciais entre qualquer número de pessoas. Isso é ideal para apps de mensagens, porque oferece um layout consistente para cada mensagem ao processar o nome do remetente e o texto da mensagem separadamente, e cada mensagem pode ter várias linhas.

Para adicionar uma nova mensagem, chame addMessage(), transmitindo o texto da mensagem, o horário de recebimento e o nome do remetente. Você também pode transmitir essas informações como um objeto NotificationCompat.MessagingStyle.Message, conforme mostrado no exemplo a seguir:

val message1 = NotificationCompat.MessagingStyle.Message(
    messages[0].text,
    messages[0].time,
    messages[0].sender
)
val message2 = NotificationCompat.MessagingStyle.Message(
    messages[1].text,
    messages[1].time,
    messages[1].sender
)
notification = NotificationCompat.Builder(context, CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_logo)
    .setStyle(
        NotificationCompat.MessagingStyle(Person.Builder().setName("Me").build())
            .addMessage(message1)
            .addMessage(message2)
    )
    .build()

Uma notificação no estilo de mensagens
Figura 4. Uma notificação usando NotificationCompat.MessagingStyle.

Ao usar NotificationCompat.MessagingStyle, todos os valores atribuídos a setContentTitle() e setContentText() são ignorados.

Você pode chamar setConversationTitle() para adicionar um título que aparece acima da conversa. Pode ser o nome criado pelo usuário ou, se não tiver um nome específico, uma lista dos participantes da conversa. Não defina um título para conversas individuais, porque o sistema usa a existência desse campo como uma dica de que a conversa é em grupo.

Esse estilo só é aplicado em dispositivos com Android 7.0 (nível 24 da API) ou versões mais recentes. Ao usar a biblioteca de compatibilidade (NotificationCompat), como demonstrado anteriormente, as notificações com MessagingStyle voltam automaticamente para um estilo de notificação expandida compatível.

Ao criar uma notificação como essa para uma conversa por chat, adicione uma ação de resposta direta.

Criar uma notificação com controles de mídia

Aplique MediaStyleNotificationHelper.MediaStyle para mostrar controles de reprodução de mídia e informações de rastreamento.

Especifique seu MediaSession associado no construtor. Isso permite que o Android mostre as informações corretas sobre sua mídia.

Chame addAction() até cinco vezes para mostrar até cinco botões de ícone. Chame setLargeIcon() para definir a arte da capa do álbum.

Ao contrário dos outros estilos de notificação, o MediaStyle também permite modificar a visualização de conteúdo de tamanho recolhido especificando três botões de ação que também aparecem na visualização recolhida. Para fazer isso, forneça os índices dos botões de ação para setShowActionsInCompactView().

O exemplo a seguir mostra como criar uma notificação com controles de mídia:

notification = NotificationCompat.Builder(context, CHANNEL_ID)
    // Show controls on lock screen even when user hides sensitive content.
    .setVisibility(NotificationCompat.VISIBILITY_PUBLIC)
    .setSmallIcon(com.example.compose.snippets.R.drawable.play)
    // Add media control buttons that invoke intents in your media service
    .addAction(R.drawable.previous, "Previous", null /* Add valid intent */) // #0
    .addAction(R.drawable.pause, "Pause", null /* Add valid intent */) // #1
    .addAction(R.drawable.next, "Next", null /* Add valid intent */) // #2
    // Apply the media style template.
    .setStyle(MediaStyleNotificationHelper.MediaStyle(mediaSession)
        .setShowActionsInCompactView(1 /* #1: pause button */))
    .setContentTitle("Wonderful music")
    .setContentText("My Awesome Band")
    .setLargeIcon(bitmapImage)
    .build()

Uma notificação com estilo de mídia
Figura 5. Uma notificação usando MediaStyleNotificationHelper.MediaStyle.

Outros recursos

Consulte as referências a seguir para mais informações sobre MediaStyle e notificações expansíveis.