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, você pode criar 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 quando a notificação estiver recolhida, como mostrado na figura abaixo, 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 o 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 seis primeiras 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 será semelhante à figura a seguir:

Uma notificação expandida no estilo de caixa de entrada
Figura 3. Uma notificação expandida no estilo 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, processando 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. Também é possível 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 mensagem
Figura 4. Uma notificação usando NotificationCompat.MessagingStyle.

Ao usar NotificationCompat.MessagingStyle, todos os valores fornecidos para setContentTitle() e setContentText() são ignorados.

Você pode chamar setConversationTitle() para adicionar um título que aparece acima da conversa. Pode ser o nome do grupo criado pelo usuário ou, se não houver 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 se aplica apenas a dispositivos com o Android 7.0 (nível 24 da API) e versões mais recentes. Ao usar a biblioteca de compatibilidade (NotificationCompat), conforme 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 de chat, adicione uma ação de resposta direta.

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

Aplique MediaStyleNotificationHelper.MediaStyle para mostrar os controles de mídia e as informações da faixa.

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

Chame addAction() até cinco vezes para exibir até cinco botões de ícone. Chame setLargeIcon() para definir a 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 do botão 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.