Melhores práticas para ícones de notificação push
- Use um PNG transparente para melhor renderização em todos os dispositivos.
- Certifique-se de que o ícone seja simples e reconhecível em tamanhos menores.
- Siga diretrizes específicas da plataforma para tamanho e esquema de cores (por exemplo, ícones brancos em fundos transparentes para barras de status do Android).
- Evite texto no ícone, pois pode ficar ilegível em tamanhos menores.
- Incluir um ícone de notificação push bem projetado pode melhorar significativamente a eficácia e o apelo de suas notificações.
Ícones de notificação web
O tamanho recomendado é256x256 pixels. Os tipos de arquivo PNG, JPG e GIF (não animado) são suportados.
Faça upload do seu ícone ou use uma URL para uma imagem nas suas Configurações Web do Painel.
Ícones de notificações iOS
As notificações iOS usam a mesma imagem do ícone do seu aplicativo e não podem ser alteradas sem alterar o ícone do seu aplicativo. O iOS também suporta Notificações de Comunicação que permitem que você altere o ícone para a imagem de perfil do usuário.Ícones de notificação Android
O Android (incluindo Amazon e Huawei) fornece várias opções para configurar ícones, que este guia detalha completamente. O Android também suporta Notificações de Conversa que permitem que você altere o ícone para a imagem de perfil do usuário. O Android suporta Ícones de Notificação Pequenos e Grandes.
Ícones de notificação pequenos
O ícone pequeno é exibido no canto superior esquerdo da notificação. Por padrão, o OneSignal mostrará um ícone de sino, no entanto, recomendamos que você personalize isso para que os assinantes reconheçam que é uma notificação do seu aplicativo.A maioria dos dispositivos Android suporta apenas canal alfa para o ícone. Ele será exibido monocromático na barra de status, mas uma cor de destaque pode ser aplicada ao lado esquerdo da notificação em si.
Ícones de notificação grandes
O ícone de notificação grande aparece no lado direito da notificação. Se você não definir um ícone grande, o ícone pequeno será usado. O OneSignal dimensionará automaticamente os ícones de notificação grandes para você para evitar que o ícone seja cortado. O tamanho recomendado do ícone grande é256x256 pixels.
Como adicionar ícones padrão do Android
Recomendamos fortemente adicionar ícones padrão a todos os aplicativos Android e Amazon.1
Gerar ícones
Você deve adicionar cada imagem com o tamanho listado e transparência alfa.Para ajuda na geração de imagens com transparência alfa, veja este link de clipart para exemplos no Android Asset Studio.
- Using Android asset studio
- Manually create icons
RecomendadoPara gerar rapidamente e facilmente ícones pequenos com as configurações corretas, recomendamos usar o Android Asset Studio. Use
ic_stat_onesignal_default como o nome.Nome do ícone padrão, densidade, tamanho
Obrigatório: Cada nome e tamanho de pixel deve estar presente no aplicativo.| Nome | Densidade (dp) | Tamanho (px) |
|---|---|---|
| ic_stat_onesignal_default | MDPI | 24x24 |
| ic_stat_onesignal_default | HDPI | 36x36 |
| ic_stat_onesignal_default | XHDPI | 48x48 |
| ic_stat_onesignal_default | XXHDPI | 72x72 |
| ic_stat_onesignal_default | XXXHDPI | 96x96 |
| ic_onesignal_large_icon_default.png | XXXHDPI | 256x256 |
2
Criar caminhos do projeto
Certifique-se de que os seguintes caminhos existam; crie quaisquer pastas que estejam faltando.Obrigatório: Cada imagem deve estar presente nos seguintes caminhos:
- Android Native
- Unity
- Cordova/Ionic
- React Native
- .NET Maui
- Flutter
res/drawable-mdpi/(24x24)res/drawable-hdpi/(36x36)res/drawable-xhdpi/(48x48)res/drawable-xxhdpi/(72x72)res/drawable-xxxhdpi/(96x96)res/drawable-xxxhdpi/(256x256) (Ícone Grande)
Com versões do Cordova anteriores a 7.0, você precisará usar
<project-root>/platforms/android/res/drawable-{size}/ em vez do caminho mostrado acima ao adicionar o recurso de ícone ao config.xmlSe você ver o ícone de sino padrão do OneSignal, você não adicionou todos os tamanhos de ícone. Por favor, adicione todos os tamanhos de ícone e caminhos corretos.Se você ver um quadrado sólido, você definiu a imagem para o caminho correto, mas a imagem não tem transparência alfa. Para mais ajuda, tente usar imagens deste Android Asset Studio clipart.
Você deve estar pronto com seus novos ícones padrão.
Ícones não padrão
Como enviar push com ícones não padrão (Opcional)
Como enviar push com ícones não padrão (Opcional)
Depois de adicionar seus ícones padrão, você pode optar por adicionar mais ícones não padrão. Isso permitirá que você mostre diferentes ícones dependendo dos tipos de notificações que seu aplicativo envia. Por exemplo, um jogo com um título como “Jewel Breaker” pode desejar ter um ícone de joia de cor diferente para cada notificação enviada que representa o nível do usuário. Enquanto isso, uma rede social pode desejar mostrar um ícone de balão de conversa quando o usuário recebe uma mensagem de outro usuário para diferenciar essas notificações de notificações do sistema mais genéricas.O OneSignal suporta a substituição de ícones padrão por mensagem.
1
Gerar ícones
Siga os passos acima para gerar ícones e colocá-los na pasta apropriada para seu SDK.
2
Nomear ícones não padrão
Para adicionar ícones não padrão, você deve nomeá-los com algo diferente dos nomes padrão especificados acima. Por exemplo, você pode nomear um
message_icon.3
Enviar notificações com ícones não padrão
Se você seguiu os passos acima para criar ícones padrão e atualizou seu aplicativo, poderá fazer referência a esses ícones quando enviar uma notificação. Para enviar uma notificação com um ícone personalizado:
Painel
Navegue até Mensagens > New Push > Platform Settings > Google Android Options > Defina o nome do ícone sem a extensão do arquivo. Com Ícones de Notificação Grandes, você também pode fornecer uma URL de onde o ícone será exibido.REST API
Defina ícones de notificação com as propriedadessmall_icon e large_icon da REST API. Defina o nome do ícone sem a extensão do arquivo. Mais detalhes na documentação da API REST Create notification.Cor de destaque do ícone pequeno
Você pode alterar a cor mostrada ao redor do ícone pequeno da notificação.
Definir cor de destaque do ícone pequeno
Para definir uma cor padrão, adicione a seguinte linha ao seu arquivores/values/strings.xml no seu projeto.
Se você quiser uma cor diferente para o modo escuro, adicione a chave ao seu res/values-night/strings.xml também.
Use o valor HEX. Use o Android Asset Studio esquema de cores para assistência.
android_accent_color em nossa chamada de API Create notification ou insira um valor no campo Accent color em Mensagens > New Push > Platform Settings > Google Android Options.
Se você adicionou um recurso de ícone ao seu aplicativo muito recentemente, talvez queira esperar alguns dias antes de enviar notificações usando o ícone. Isso ocorre porque pode levar muitos dias ou até semanas para a maioria de seus usuários atualizarem seus aplicativos para a versão mais recente que contém seus novos ícones.