Criar um layout personalizado de notificação

Para que suas notificações tenham a melhor aparência possível em diferentes versões do Android, use a notificação padrão modelo para criar notificações. Se você quiser fornecer mais conteúdo em sua notificação, use um dos sistemas de notificação expansíveis de modelos.

No entanto, se os modelos do sistema não atenderem às suas necessidades, use seu próprio modelo da notificação.

Atenção: ao usar um layout de notificação personalizado, tome cuidado para garantir seu layout personalizado funciona com diferentes orientações e resoluções do dispositivo. Embora esse conselho se aplique a todos os layouts de interface, ele é especialmente importante para notificações porque o espaço na gaveta de notificações é restrito. A a altura disponível para um layout de notificação personalizado depende da estrutura do Android para a versão anterior. Em algumas versões, os layouts de visualização recolhida são limitados ao mínimo 48 dp, layouts de visualização de avisos são limitados a 88 dp e Os layouts de visualização expandida são limitados a 252 dp.

Criar layout personalizado para a área de conteúdo

Se você precisar de um layout personalizado, NotificationCompat.DecoratedCustomViewStyle à notificação. Essa API permite fornecer um layout personalizado para o conteúdo normalmente ocupada pelo título e pelo conteúdo de texto, usando o sistema decorações para o ícone de notificação, carimbo de data/hora, subtexto e botões de ação.

Essa API funciona de maneira semelhante aos modelos de notificação expansíveis baseando-se nos modelos da seguinte forma:

1. Criar uma notificação básica com NotificationCompat.Builder.
2. Ligação setStyle(), passando uma instância de NotificationCompat.DecoratedCustomViewStyle
3. Infle o layout personalizado como uma instância do RemoteViews
4. Ligação setCustomContentView() para definir o layout da notificação recolhida.
5. Opcionalmente, chame também setCustomBigContentView() para definir um layout diferente para a notificação expandida.

.

Observação: se você estiver criando uma notificação personalizada para controles de mídia, seguir as mesmas recomendações, mas use o NotificationCompat.DecoratedMediaCustomViewStyle.

Preparar os layouts

Você precisa de um layout small e large. Para este exemplo, o layout small pode ter esta aparência:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:text="Small notification, showing only a title" />
</LinearLayout>

E o layout large pode ficar assim:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="300dp"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Large notification, showing a title and a body." />

    <TextView
        android:id="@+id/notification_body"
        style="@style/TextAppearance.Compat.Notification.Line2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="This is the body. The height is manually forced to 300dp." />
</LinearLayout>

Criar e mostrar a notificação

Depois que os layouts estiverem prontos, você poderá usá-los conforme mostrado no exemplo a seguir:

Kotlin

val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

// Get the layouts to use in the custom notification.
val notificationLayout = RemoteViews(packageName, R.layout.notification_small)
val notificationLayoutExpanded = RemoteViews(packageName, R.layout.notification_large)

// Apply the layouts to the notification.
val customNotification = NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setStyle(NotificationCompat.DecoratedCustomViewStyle())
        .setCustomContentView(notificationLayout)
        .setCustomBigContentView(notificationLayoutExpanded)
        .build()

notificationManager.notify(666, customNotification)

Java

NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);

// Get the layouts to use in the custom notification
RemoteViews notificationLayout = new RemoteViews(getPackageName(), R.layout.notification_small);
RemoteViews notificationLayoutExpanded = new RemoteViews(getPackageName(), R.layout.notification_large);

// Apply the layouts to the notification.
Notification customNotification = new NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setStyle(new NotificationCompat.DecoratedCustomViewStyle())
        .setCustomContentView(notificationLayout)
        .setCustomBigContentView(notificationLayoutExpanded)
        .build();

notificationManager.notify(666, customNotification);

A cor do plano de fundo da notificação pode variar de acordo com o dispositivo e versões mais recentes. Aplicar estilos da Biblioteca de Suporte, como TextAppearance_Compat_Notification para o texto e TextAppearance_Compat_Notification_Title para o título no seu layout personalizado; como mostrado no exemplo a seguir. Esses estilos se adaptam às variações de cor, você não acabará com texto preto sobre preto ou branco sobre branco.

<TextView
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:layout_weight="1"
    android:text="@string/notification_title"
    android:id="@+id/notification_title"
    style="@style/TextAppearance.Compat.Notification.Title" />

Evite definir uma imagem de plano de fundo no objeto RemoteViews, já que o texto podem se tornar ilegíveis.

Quando você aciona uma notificação enquanto o usuário está usando um app, o resultado é semelhante à Figura 1:

Figura 1. Um layout pequeno de notificação é exibido enquanto usam outros apps.

Tocar na seta expansora expande a notificação, conforme mostrado na Figura 2:

Figura 2. Um layout de notificação grande é exibido enquanto usam outros apps.

Depois que o tempo limite da notificação se esgotar, a notificação ficará visível somente no que se parece com a Figura 3:

Figura 3. Como o layout pequeno de notificação aparece na barra do sistema.

Tocar na seta expansora expande a notificação, conforme mostrado na Figura 4:

Figura 4. Um layout de notificação grande aparece barra de sistema.

Criar um layout de notificação totalmente personalizado

Observação :apps destinados ao Android 12 (nível 31 da API) ou posterior não podem criar notificações totalmente personalizadas. Em vez disso, o sistema aplica modelo padrão praticamente idêntico ao comportamento Notification.DecoratedCustomViewStyle.

Se você não quiser que sua notificação seja decorada com a notificação padrão e cabeçalho, siga as etapas anteriores, mas não chame setStyle().

Cuidado: não recomendamos usar uma notificação não decorada, porque isso não corresponder a outras notificações e causar problemas significativos de compatibilidade de layout em dispositivos que aplicam estilos diferentes à área de notificação.