page.title=Notificações
page.tags="notifications","design","L"
@jd:body
<a class="notice-developers" href="{@docRoot}training/notify-user/index.html">
<div>
<h3>Documentos do desenvolvedor</h3>
<p>Notificação ao usuário</p>
</div>
</a>
<a class="notice-designers" href="notifications_k.html">
<div>
<h3>Notificações no Android 4.4 e em anteriores</h3>
</div>
</a>
<!-- video box -->
<a class="notice-developers-video" href="https://www.youtube.com/watch?v=Uiq2kZ2JHVY">
<div>
<h3>Vídeo</h3>
<p>DevBytes: Notificações na pré-visualização do desenvolvedor do Android L</p>
</div>
</a>
<style>
.col-5, .col-6, .col-7 {
margin-left:0px;
}
</style>
<p>O sistema de notificações permite que os usuários se mantenham informados sobre eventos relevantes e
imediatos
no aplicativo, como novas mensagens de bate-papo de um amigo ou um evento de calendário.
Pense nas notificações como um canal de notícias que alerta o usuário sobre eventos
importantes à
medida que acontecem ou sobre um registro que grava eventos enquanto o usuário não está prestando
atenção — e que é sincronizado conforme apropriado em todos os dispositivos Android dele.</p>
<h4 id="New"><strong>Novo no Android 5.0</strong></h4>
<p>No Android 5.0, as notificações recebem atualizações importantes: em termos estruturais, visuais e
funcionais:</p>
<ul>
<li>As notificações passaram por mudanças visuais consistentes com o novo
tema do Material Design.</li>
<li> As notificações agora estão disponíveis na tela de bloqueio do dispositivo, enquanto que
o conteúdo sensível ainda pode
ficar oculto atrás dela.</li>
<li>Notificações de alta prioridade recebidas enquanto o dispositivo está em uso agora usam um novo formato, chamado de
notificações heads-up.</li>
<li>Notificações sincronizadas na nuvem: descartar uma notificação em um dos
dispositivos Android a descarta
também nos outros.</li>
</ul>
<p class="note"><strong>Observação:</strong> o projeto de notificação nesta versão do
Android é uma mudança
significativa em relação às versões anteriores. Para obter informações sobre o projeto de notificação em versões
anteriores, consulte <a href="./notifications_k.html">Notificações no Android 4.4 ou em anteriores</a>.</p>
<h2 id="Anatomy">Anatomia de uma notificação</h2>
<p>Esta seção aborda as partes básicas de uma notificação e como elas
podem aparecer em diferentes tipos de dispositivos.</p>
<h3 id="BaseLayout">Layout básico</h3>
<p>No mínimo, todas as notificações consistem em um layout básico, incluindo:</p>
<ul>
<li> O <strong>ícone</strong> da notificação. O ícone simboliza o
aplicativo de origem. Ele também
pode indicar o tipo de notificação, caso o aplicativo gere mais de um
tipo.</li>
<li> Um <strong>título</strong> da notificação e
<strong>texto</strong> adicional.</li>
<li> Uma <strong>marcação de data e hora</strong>.</li>
</ul>
<p>Notificações criadas com {@link android.app.Notification.Builder Notification.Builder}
para versões anteriores da plataforma têm a mesma aparência e o mesmo funcionamento no Android
5.0, com apenas mudanças menores de estilo que o sistema
entrega a você. Para obter mais informações sobre notificações em versões
anteriores do Android, consulte
<a href="./notifications_k.html">Notificações no Android 4.4 ou em anteriores</a>.</p></p>
<img style="margin:20px 0 0 0" src="{@docRoot}images/android-5.0/notifications/basic_combo.png" alt="" width="700px" />
<div style="clear:both;margin-top:20px">
<p class="img-caption">
Layout básico de uma notificação em dispositivo portátil (à esquerda) e a mesma notificação em Wear (à direita),
com uma foto do usuário e um ícone de notificação
</p>
</div>
<h3 id="ExpandedLayouts">Layouts expandidos</h3>
<p>Você pode escolher o nível de detalhe que as notificações de seu aplicativo
devem fornecer. Elas podem mostrar as primeiras
linhas de uma mensagem ou exibir uma visualização de imagem maior. As informações
adicionais fornecem ao usuário mais
contexto e — em alguns casos — podem permitir que o usuário leia uma mensagem
em sua totalidade. O usuário pode
pinçar para aproximar ou afastar a vista ou realizar deslizamento de um dedo para alternar entre os layouts
compacto e expandido.
Para notificações de um evento, o Android fornece três modelos de layout
expandido (texto, caixa de entrada e
imagem) para usar em seu aplicativo. As imagens a seguir mostram como
se parecem notificações de um evento em
dispositivos portáteis (à esquerda) e usados junto ao corpo (à direita).</p>
<img style="margin-top:30px"
src="{@docRoot}images/android-5.0/notifications/expandedtext_combo.png"
alt="" width="700px" height;="284px" />
<img style="margin-top:30px"
src="{@docRoot}images/android-5.0/notifications/stack_combo.png"
alt="" width="700px" height;="284px" />
<img style="margin-top:30px"
src="{@docRoot}images/android-5.0/notifications/ExpandedImage.png"
alt="" width="311px" height;="450px" />
<h3 id="actions" style="clear:both; margin-top:40px">Ações</h3>
<p>O Android tem suporte para ações opcionais que são exibidas na parte inferior
da notificação.
Com ações, os usuários podem tratar as tarefas mais comuns para
determinada notificação de dentro da sombra da notificação sem precisar abrir o
aplicativo de origem.
Isso acelera a interação e, em conjunto com deslizar-para-descartar, ajuda os usuários a
se concentrarem em notificações que sejam importantes.</p>
<img src="{@docRoot}images/android-5.0/notifications/action_combo.png" alt="" width="700px" />
<p style="clear:both">Tenha cuidado com o número de ações que inclui em uma
notificação. Quanto mais
ações incluir, maior será a complexidade cognitiva criada. Limite-se
ao menor número possível
de ações, incluindo apenas as ações efetivamente mais importantes e
significativas.</p>
<p>Boas candidatas a ações em notificações são ações que:</p>
<ul>
<li> Sejam essenciais, frequentes e típicas para o tipo de conteúdo
exibido
<li> Permitam que o usuário realize tarefas rapidamente
</ul>
<p>Evite ações que sejam:</p>
<ul>
<li> Ambíguas
<li> Idênticas à ação padrão da notificação (como "Ler" ou
"Abrir")
</ul>
<p>Você pode especificar no máximo três ações, cada uma consistindo em um ícone
e um nome de ação.
Adicionar ações a um layout básico simples torna a notificação expansível,
mesmo se a
notificação não tiver um layout expandido. Como as ações são exibidas apenas para notificações
expandidas
e que ficam de outra forma ocultas, certifique-se de que qualquer ação que um
usuário possa invocar de dentro de uma
notificação esteja disponível também dentro do aplicativo
associado.</p>
<h2 style="clear:left">Notificação heads-up</h2>
<div class="figure" style="width:311px">
<img src="{@docRoot}images/android-5.0/notifications/hun-example.png" alt="" width="311px" />
<p class="img-caption">
Exemplo de uma notificação heads-up (chamada telefônica recebida, alta prioridade)
que aparece sobre um
aplicativo imersivo
</p>
</div>
<p>Quando uma notificação de alta prioridade chega (veja à direita), ela é apresentada
aos usuários por
um período curto com um layout expandido mostrando possíveis ações.</p>
<p> Depois desse período, a notificação recua para a sombra
de notificação. Se a <a href="#correctly_set_and_manage_notification_priority">prioridade</a> de uma notificação for
marcada como Alta, Máxima ou tela cheia, ela receberá uma notificação heads-up.</p>
<p><b>Bons exemplos de notificações heads-up</b></p>
<ul>
<li> Chamada telefônica recebida durante o uso do dispositivo</li>
<li> Alarme durante o uso do dispositivo</li>
<li> Nova mensagem SMS</li>
<li> Bateria fraca</li>
</ul>
<h2 style="clear:both" id="guidelines">Diretrizes</h2>
<h3 id="MakeItPersonal">Torne-a pessoal</h3>
<p>Para notificações de itens enviados por outra pessoa (como uma mensagem ou
atualização de status), inclua a imagem da pessoa usando
{@link android.app.Notification.Builder#setLargeIcon setLargeIcon()}. Anexe também informações sobre
a pessoa nos metadados da notificação (consulte {@link android.app.Notification#EXTRA_PEOPLE}).</p>
<p>O ícone principal de sua notificação ainda é mostrado, portanto, o usuário pode associá-lo
ao ícone
visível na barra de status.</p>
<img src="{@docRoot}images/android-5.0/notifications/Triggered.png" alt="" width="311px" />
<p style="margin-top:10px" class="img-caption">
Notificação que mostra a pessoa que a ativou e o conteúdo enviado.
</p>
<h3 id="navigate_to_the_right_place">Navegação para o lugar certo</h3>
<p>Quando o usuário toca no corpo de uma notificação (fora dos botões
de ação), abra o aplicativo
no lugar em que o usuário possa visualizar e agir sobre os dados referenciados na
notificação. Na maioria dos casos, será a exibição detalhada de um único item de dado, como uma mensagem,
mas também poderá ser uma
vista resumida se a notificação estiver empilhada. Se o aplicativo
levar o usuário a qualquer lugar abaixo do nível superior do aplicativo, insira a navegação na pilha de retorno do aplicativo para que
o usuário possa pressionar o botão Voltar do sistema para voltar ao nível superior. Para obter mais informações, consulte
<em>Navegação para o seu aplicativo pelos widgets de página inicial e notificações</em> no padrão de projeto de <a href="{@docRoot}design/patterns/navigation.html#into-your-app">Navegação</a>.
</p>
<h3 id="correctly_set_and_manage_notification_priority">Definição e gerenciamento
corretos da prioridade das
notificações</h3>
<p>O Android tem suporte para um sinalizador de prioridade para notificações. Esse sinalizador permite
influenciar o local em que a notificação é exibida em relação a outras notificações e
ajuda a garantir
que os usuários sempre vejam primeiro as notificações mais importantes. Você pode escolher entre
os seguintes
níveis de prioridade ao publicar uma notificação:</p>
<table>
<tr>
<td class="tab0">
<p><strong>Prioridade</strong></p>
</td>
<td class="tab0">
<p><strong>Uso</strong></p>
</td>
</tr>
<tr>
<td class="tab1">
<p><code>MAX</code></p>
</td>
<td class="tab1">
<p>Use para notificações críticas e urgentes que alertam o usuário sobre uma condição
que depende
do tempo ou que precisa ser resolvida antes que o usuário possa continuar
com uma determinada tarefa.</p>
</td>
</tr>
<tr>
<td class="tab1">
<p><code>HIGH</code></p>
</td>
<td class="tab1">
<p>Use principalmente para comunicações importantes, como uma mensagem ou
eventos de bate-papo com conteúdo particularmente interessante para o usuário.
Notificações de alta prioridade acionam a exibição de uma notificação heads-up.</p>
</td>
</tr>
<tr>
<td class="tab1">
<p><code>DEFAULT</code></p>
</td>
<td class="tab1">
<p>Use para todas as notificações que não recaiam em nenhuma das outras prioridades descritas aqui.</p>
</td>
</tr>
<tr>
<td class="tab1">
<p><code>LOW</code></p>
</td>
<td class="tab1">
<p>Use para notificações sobre as quais deseja que o usuário seja informado, mas
que sejam menos urgentes. Notificações de baixa prioridade tendem a ser exibidas na parte inferior da lista,
o que as torna uma boa
opção para coisas como atualizações públicas ou sociais não direcionadas: o usuário pediu para
ser notificado sobre
elas, mas essas notificações nunca devem ter precedência sobre comunicações
urgentes ou diretas.</p>
</td>
</tr>
<tr>
<td class="tab1">
<p><code>MIN</code></p>
</td>
<td class="tab1">
<p>Use para informações contextuais ou de histórico, como informações sobre clima ou
informações contextuais de localização.
Notificações de prioridade mínima não aparecem na barra de status. O usuário
as descobre expandindo a sombra da notificação.</p>
</td>
</tr>
</table>
<h4 id="how_to_choose_an_appropriate_priority"><strong>Como escolher uma prioridade
adequada
</strong></h4>
<p><code>DEFAULT</code>, <code>HIGH</code> e <code>MAX</code> são níveis de prioridade de interrupção e arriscam
interromper a atividade
do usuário. Para evitar irritar os usuários de seu aplicativo, reserve níveis de prioridade de interrupção para
notificações que:</p>
<ul>
<li> Envolvam outra pessoa</li>
<li> Dependam do tempo</li>
<li> Possam mudar imediatamente o comportamento do usuário no mundo real</li>
</ul>
<p>Notificações definidas como <code>LOW</code> e <code>MIN</code> ainda podem
ser valiosas para o usuário: muitas, se não a maioria, das notificações não precisam demandar a atenção
imediata do usuário, ou vibrar o pulso do usuário, mas ainda contêm informações que o usuário
achará valiosas ao decidir procurar
notificações. Os critérios para notificações de prioridade <code>LOW</code> e <code>MIN</code>
incluem:</p>
<ul>
<li> Não envolver outras pessoas</li>
<li> Não depender de tempo</li>
<li> Ter conteúdo no qual o usuário pode estar interessado, mas que pode decidir
verificar no momento em que desejar</li>
</ul>
<img src="{@docRoot}images/android-5.0/notifications/notifications_pattern_priority.png" alt="" width="700" />
<h3 style="clear:both" id="set_a_notification_category">Definição de uma categoria
de notificação</h3>
<p>Se a sua notificação recair em uma das categorias predefinidas (veja
abaixo), atribua-a
adequadamente. Aspectos da IU do sistema, como a sombra da notificação (ou qualquer
outra escuta
de notificação), podem usar essas informações para tomar decisões de classificação e filtragem.</p>
<table>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_CALL">CATEGORY_CALL</a></code></p>
</td>
<td>
<p>Chamada recebida (voz ou vídeo) ou solicitação similar de
comunicação síncrona</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_MESSAGE">CATEGORY_MESSAGE</a></code></p>
</td>
<td>
<p>Mensagem direta recebida (SMS, mensagem instantânea etc.)</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_EMAIL">CATEGORY_EMAIL</a></code></p>
</td>
<td>
<p>Mensagens assíncronas em lote (e-mail)</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_EVENT">CATEGORY_EVENT</a></code></p>
</td>
<td>
<p>Evento de calendário</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_PROMO">CATEGORY_PROMO</a></code></p>
</td>
<td>
<p>Promoção ou publicidade</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_ALARM">CATEGORY_ALARM</a></code></p>
</td>
<td>
<p>Alarme ou cronômetro</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_PROGRESS">CATEGORY_PROGRESS</a></code></p>
</td>
<td>
<p>Andamento de uma operação de execução longa em segundo plano</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_SOCIAL">CATEGORY_SOCIAL</a></code></p>
</td>
<td>
<p>Atualização de rede social ou de compartilhamento</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_ERROR">CATEGORY_ERROR</a></code></p>
</td>
<td>
<p>Erro em operação de segundo plano ou no status de autenticação</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_TRANSPORT">CATEGORY_TRANSPORT</a></code></p>
</td>
<td>
<p>Controle de transporte de mídia para reprodução</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_SYSTEM">CATEGORY_SYSTEM</a></code></p>
</td>
<td>
<p>Atualização do sistema ou do status do dispositivo. Reservado para uso do sistema.</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_SERVICE">CATEGORY_SERVICE</a></code></p>
</td>
<td>
<p>Indicação de serviço de segundo plano em execução</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_RECOMMENDATION">CATEGORY_RECOMMENDATION</a></code></p>
</td>
<td>
<p>Uma recomendação específica e oportuna para uma única coisa. Por exemplo, um aplicativo
de notícias pode querer
recomendar uma notícia que acredita que o usuário desejará ler em seguida.</p>
</td>
</tr>
<tr>
<td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_STATUS">CATEGORY_STATUS</a></code></p>
</td>
<td>
<p>Informações contínuas sobre o dispositivo ou o status contextual</p>
</td>
</tr>
</table>
<h3 id="summarize_your_notifications">Resuma as notificações</h3>
<p>Se uma notificação de um certo tipo já estiver pendente quando o aplicativo tentar enviar uma nova
notificação do mesmo tipo, combine-as em uma única notificação de resumo para o aplicativo. Não
crie um novo objeto.</p>
<p>Uma notificação de resumo cria uma descrição resumida e permite que o
usuário entenda quantas notificações
de um determinado tipo estão pendentes.</p>
<div class="col-6">
<p><strong>O que não fazer</strong></p>
<img src="{@docRoot}images/android-5.0/notifications/Summarise_Dont.png" alt="" width="311px" />
</div>
<div>
<p><strong>O que fazer</strong></p>
<img src="{@docRoot}images/android-5.0/notifications/Summarise_Do.png" alt="" width="311px" />
</div>
<p style="clear:left; padding-top:30px; padding-bottom:20px">Você pode fornecer
mais detalhes sobre as notificações individuais que compõem um
resumo usando o layout resumido expandido. Essa abordagem permite que os usuários
entendam melhor quais
notificações estão pendentes e decidam se estão interessados o suficiente para lê-las
em detalhes dentro
do aplicativo associado.</p>
<div class="col-6">
<img src="{@docRoot}images/android-5.0/notifications/Stack.png" style="margin-bottom:20px" alt="" width="311px" />
<p class="img-caption">
Notificação expandida e contraída que é um resumo (usando <code>InboxStyle</code>)
</p>
</div>
<h3 style="clear:both" id="make_notifications_optional">Torne as notificações
opcionais</h3>
<p>Os usuários devem sempre controlar as notificações. Permita que o usuário
desative as notificações
de seu aplicativo ou altere as propriedades de alerta, como som de alerta e
se a vibração será usada,
adicionando um item de configuração da notificação nas configurações do aplicativo.</p>
<h3 id="use_distinct_icons">Use ícones distintos</h3>
<p>Ao olhar para a área de notificação, o usuário deverá ser capaz de discernir
que tipos de
notificações estão atualmente pendentes.</p>
<div class="figure">
<img src="{@docRoot}images/android-5.0/notifications/ProductIcons.png" alt="" width="420" />
</div>
<div><p><strong>O que fazer</strong></p>
<p>Verifique os ícones de notificação que os aplicativos do Android já fornecem e crie
ícones de notificação para o seu
aplicativo que tenham aparência suficientemente distinta.</p>
<p><strong>O que fazer</strong></p>
<p>Use o <a href="/design/style/iconography.html#notification">estilo de ícone de notificação</a> apropriado
para ícones pequenos e o
<a href="/design/style/iconography.html#action-bar">estilo de ícone de barra
de ação</a> da luminosidade do Material para os ícones
de ação.</p>
<p ><strong>O que fazer</strong></p>
<p >Mantenha os ícones visualmente simples, evitando detalhes excessivos que sejam
difíceis de discernir.</p>
<div><p><strong>O que não fazer</strong></p>
<p>Coloque um alfa adicional (esmaecimento ou redução de intensidade) nos ícones pequenos
e nos ícones de
ação; eles podem ter bordas suavizadas, mas, como o Android usa esses
ícones como máscaras (ou seja, somente
o canal alfa é usado), a imagem normalmente deve ser desenhada com
opacidade total.</p>
</div>
<p style="clear:both"><strong>O que não fazer</strong></p>
<p>Use cores para distinguir o seu aplicativo dos outros. Ícones de notificação devem
somente ser uma imagem com fundo branco sobre transparente.</p>
<h3 id="pulse_the_notification_led_appropriately">Pisque o LED de notificação
adequadamente</h3>
<p>Muitos dispositivos Android contêm um LED de notificação, que é usado para manter o
usuário informado sobre
eventos enquanto a tela está desligada. Notificações com um nível de prioridade de <code>MAX</code>,
<code>HIGH</code> ou <code>DEFAULT</code> devem
fazer com que o LED brilhe, enquanto que os de prioridade mais baixa (<code>LOW</code> e
<code>MIN</code>) não devem.</p>
<p>O controle do usuário sobre as notificações deve se estender ao LED. Ao usar
DEFAULT_LIGHTS, o
LED brilhará na cor branca. Suas notificações não devem usar uma cor
diferente, a não ser que o
usuário as tenha explicitamente personalizado.</p>
<h2 id="building_notifications_that_users_care_about">Criação de notificações
que agradam aos usuários</h2>
<p>Para criar um aplicativo que os usuários amem, é importante projetar as
notificações cuidadosamente.
As notificações personificam a voz do seu aplicativo e contribuem para
a personalidade dele. Notificações indesejadas ou
irrelevantes podem irritar o usuário ou fazer com que ele reprove a
quantidade de atenção que o
aplicativo exige. Portanto, use notificações de forma cuidadosa.</p>
<h3 id="when_to_display_a_notification">Quando exibir uma notificação</h3>
<p>Para criar um aplicativo que as pessoas gostem de usar, é importante
reconhecer que a atenção e o foco
do usuário são recursos que devem ser protegidos. Apesar de o sistema de
notificação do Android ter
sido projetado para minimizar o impacto das notificações na atenção do usuário,
ainda é
importante ter ciência do fato de que as notificações interrompem o
fluxo de tarefas do usuário.
Ao planejar as notificações, pergunte-se se elas são importantes o suficiente para
justificar uma interrupção. Se não tiver certeza, permita que o usuário decida se quer
uma notificação usando as configurações de notificação do seu aplicativo ou ajuste
o sinalizador de prioridade das notificações para <code>LOW</code> ou <code>MIN</code> para
evitar distrair o usuário enquanto ele faz
alguma outra coisa.</p>
<img src="{@docRoot}images/android-5.0/notifications/TimeSensitive.png" alt="" width="311px" />
<p style="margin-top:10px" class="img-caption">
Exemplos de notificação que depende de tempo
</p>
<p>Apesar de aplicativos bem comportados geralmente se manifestarem apenas quando ocorre interação com eles, alguns
casos justificam que o aplicativo interrompa o usuário com uma notificação não solicitada.</p>
<p>Use notificações principalmente para <strong>eventos que dependam de tempo</strong>, especialmente
se esses eventos síncronos <strong>envolverem outras pessoas</strong>. Por
exemplo, um bate-papo recebido
é uma forma síncrona em tempo real de comunicação: outro usuário
espera ativamente a resposta. Eventos de calendário são outro exemplo bom de quando usar uma
notificação e atrair a
atenção do usuário, pois o evento é iminente e eventos de calendário frequentemente
envolvem outras pessoas.</p>
<h3 style="clear:both" id="when_not_to_display_a_notification">Quando não exibir
uma notificação</h3>
<div class="figure" style="margin-top:60px">
<img src="{@docRoot}images/android-5.0/notifications/AntiSample1.png" alt="" width="311px" />
</div>
<p>Em muitos outros casos, notificações não são adequadas:</p>
<ul>
<li> Evite notificar o usuário sobre informações que não são especificamente
direcionadas a ele ou
que não dependam realmente de tempo. Por exemplo, as atualizações
assíncronas e não direcionadas
que fluem por uma rede social geralmente não justificam uma interrupção
em tempo real. Para os usuários que se importam
com elas, deixe que decidam recebê-las.</li>
<li> Não crie uma notificação se as informações novas relevantes estiverem
atualmente na tela. Em vez disso,
use a IU do próprio aplicativo para notificar o usuário das novas informações
diretamente no contexto.
Por exemplo, um aplicativo de bate-papo não deve criar notificações de sistema enquanto o
usuário estiver conversando ativamente com outro usuário.</li>
<li> Não interrompa o usuário para realizar operações técnicas de baixo nível, como salvar
ou sincronizar informações, nem atualize um aplicativo se o aplicativo ou o sistema puder resolver
o problema sem envolver o usuário.</li>
<li> Não interrompa o usuário para informar um erro se o aplicativo
puder se recuperar dele por conta própria, sem que o usuário
tome qualquer ação.</li>
<li> Não crie notificações que não tenham conteúdo real de notificação e
que meramente anunciem o seu
aplicativo. Uma notificação deve fornecer informações úteis, oportunas e novas e
não deve ser usada
meramente para executar um aplicativo.</li>
<li> Não crie notificações supérfluas apenas para colocar sua marca na frente
dos usuários.
Tais notificações frustram e provavelmente alienam seu público-alvo. A
melhor forma de fornecer
pequenas quantidades de informações atualizadas e manter o usuário envolvido
com o seu
aplicativo é desenvolver um widget que ele possa colocar na
tela inicial.</li>
</ul>
<h2 style="clear:left" id="interacting_with_notifications">Interação com
notificações</h2>
<p>Notificações são indicadas por ícones na barra de status e podem ser acessadas
abrindo a
gaveta de notificações.</p>
<p>Tocar em uma notificação abre o aplicativo associado com o conteúdo
detalhado que corresponde à notificação.
Deslizar à esquerda ou à direita em uma notificação a remove da gaveta.</p>
<h3 id="ongoing_notifications">Notificações contínuas</h3>
<div class="figure" style="width:311px">
<img src="{@docRoot}images/android-5.0/notifications/MusicPlayback.png" alt="" width="311px" />
<p class="img-caption">
Notificação contínua devido à reprodução de música
</p>
</div>
<p>Notificações contínuas mantêm os usuários informados sobre um processo em andamento em
segundo plano.
Por exemplo, reprodutores de música anunciam a faixa em reprodução no
sistema de notificação e
continuam a fazer isso até que o usuário interrompa a reprodução. Notificações contínuas também podem
mostrar ao usuário
feedback sobre tarefas mais longas, como o download de um arquivo ou a codificação de um vídeo. Um usuário não pode remover
manualmente uma notificação contínua da gaveta de notificações.</p>
<h3 id="ongoing_notifications">Reprodução de mídia</h3>
<p>No Android 5.0, a tela de bloqueio não mostra controles de transporte por causa da classe
{@link android.media.RemoteControlClient} obsoleta. Mas ela <em>mostra</em> notificações, portanto, a notificação de reprodução
de cada aplicativo agora é a forma
principal para que os usuários controlem a reprodução em um estado bloqueado. Esse comportamento dá aos aplicativos mais
controle sobre quais
botões exibir e de que forma, ao mesmo tempo em que fornece uma experiência consistente
para o usuário, com a tela bloqueada ou não.</p>
<h3 style="clear:both"
id="dialogs_and_toasts_are_for_feedback_not_notification">Diálogos
e avisos</h3>
<p>O seu aplicativo não deve criar uma caixa de diálogo ou um aviso se não estiver
atualmente na tela. Uma caixa de diálogo ou um aviso
deve ser exibido somente como uma resposta imediata ao usuário tomando uma ação
dentro do seu aplicativo.
Para obter orientação adicional sobre o uso de caixas de diálogo e avisos, consulte
<a href="/design/patterns/confirming-acknowledging.html">Confirmação e reconhecimento</a>.</p>
<h3>Avaliação e classificação</h3>
<p>Notificações são notícias e, portanto, são essencialmente exibidas
em ordem cronológica inversa, com
consideração especial para a
<a href="#correctly_set_and_manage_notification_priority">prioridade</a> da notificação declarada no aplicativo.</p>
<p>Notificações são uma parte importante da tela de bloqueio e são exibidas proeminentemente
sempre
que a tela do dispositivo é exibida. O espaço na tela de bloqueio é restrito, portanto,
é mais importante
do que nunca identificar as notificações mais urgentes ou relevantes. Por esse
motivo, o Android tem um
algoritmo de classificação mais sofisticado para notificações, levando em conta:</p>
<ul>
<li> A marcação de data e hora e a prioridade declarada no aplicativo.</li>
<li> Se a notificação incomodou recentemente o usuário com som ou
vibração (ou seja,
se o celular acabou de fazer um ruído e o usuário deseja saber "O que acabou de
acontecer?", a tela de bloqueio
deve responder com um olhar rápido).</li>
<li> Qualquer pessoa anexada à notificação usando {@link android.app.Notification#EXTRA_PEOPLE}
e, em particular, se é contato especial (com estrelas).</li>
</ul>
<p>Para aproveitar ao máximo essa classificação, concentre-se na experiência
do usuário que deseja
criar, e não em um determinado local na lista.</p>
<img src="{@docRoot}images/android-5.0/notifications/AntiSample3.png" alt="" width="700px" />
<p class="img-caption" style="margin-top:10px">Notificações do Gmail têm
prioridade padrão e normalmente
são classificadas abaixo de mensagens de um aplicativo de mensagem instantânea, como o Hangouts, mas
recebem
uma promoção temporária quando novas mensagens chegam.
</p>
<h3>Na tela de bloqueio</h3>
<p>Como as notificações são visíveis na tela de bloqueio, a privacidade do usuário é uma consideração
especialmente
importante. Notificações frequentemente contêm informações sensíveis e
não devem necessariamente estar visíveis
para qualquer pessoa que ligar a tela do dispositivo.</p>
<ul>
<li> Para dispositivos que têm uma tela de bloqueio segura (PIN, padrão ou senha), a interface tem
partes públicas e privadas. A interface pública pode ser exibida em uma tela de bloqueio segura e,
portanto, vista por qualquer pessoa. A interface privada é o mundo atrás da tela de bloqueio e
só é revelada depois que o usuário faz login no dispositivo.</li>
</ul>
<h3>Controle do usuário sobre as informações exibidas na tela de bloqueio segura</h3>
<div class="figure" style="width:311px">
<img src="{@docRoot}images/android-5.0/notifications/LockScreen@2x.png" srcset="{@docRoot}images/android-5.0/notifications/LockScreen.png 1x" alt="" width="311px" />
<p class="img-caption">
Notificações na tela de bloqueio com conteúdo revelado depois que o usuário desbloqueia o dispositivo.
</p>
</div>
<p>Ao definir uma tela de bloqueio segura, o usuário poderá escolher ocultar
detalhes sensíveis da tela de bloqueio segura. Nesse caso, a IU do sistema
considerará o <em>nível de visibilidade</em> da notificação para descobrir o que pode
ser exibido com segurança.</p>
<p> Para controlar o nível de visibilidade, chame
<code><a
href="/reference/android/app/Notification.Builder.html#setVisibility(int)">Notification.Builder.setVisibility()</a></code>
e especifique um destes valores:</p>
<ul>
<li><code><a
href="/reference/android/app/Notification.html#VISIBILITY_PUBLIC">VISIBILITY_PUBLIC</a></code>.
Exibe o conteúdo inteiro da notificação.
Esse é o padrão do sistema se a visibilidade não for especificada.</li>
<li><code><a
href="/reference/android/app/Notification.html#VISIBILITY_PRIVATE">VISIBILITY_PRIVATE</a></code>.
Na tela de bloqueio, exibe informações básicas sobre essa notificação, incluindo o
ícone e o nome do aplicativo que a publicou. O restante dos detalhes da notificação não é exibido.
Alguns pontos a ter em mente são:
<ul>
<li> Se você quer fornecer uma versão pública diferente da sua notificação
para que o sistema a exiba em uma tela de bloqueio segura, forneça um objeto
Notificação substituto no campo <code><a
href="/reference/android/app/Notification.html#publicVersion">Notification.publicVersion</a></code>.
<li> Essa configuração dá ao aplicativo uma oportunidade de criar uma versão alternativa do
conteúdo que ainda é útil, mas não revela informações pessoais. Considere o exemplo de um
aplicativo de SMS cujas notificações incluem o texto da mensagem SMS, o nome do remetente e o ícone do contato.
Essa notificação deve ser <code>VISIBILITY_PRIVATE</code>, mas <code>publicVersion</code> ainda pode
conter informações úteis, como "3 novas mensagens", sem outros detalhes
de identificação.
</ul>
</li>
<li><code><a
href="/reference/android/app/Notification.html#VISIBILITY_SECRET">Notification.VISIBILITY_SECRET</a></code>. Mostra apenas as informações mínimas, excluindo até mesmo
o ícone da notificação.</li>
</ul>
<h2 style="clear:both" id="notifications_on_android_wear">Notificações no
Android Wear</h2>
<p>Notificações e suas <em>ações</em> são enviadas a dispositivos Wear por padrão.
Os desenvolvedores podem controlar que notificações são enviadas do
celular ao relógio
e vice-versa. Os desenvolvedores também podem controlar quais ações são transmitidas. Se o
seu aplicativo inclui
ações que não podem ser executadas com um toque, oculte essas ações
na sua notificação do Wear
ou considere colocá-las em um aplicativo do Wear, permitindo que o usuário
termine a ação
no relógio.</p>
<h4>Transmissão de notificações e ações</h4>
<p>Um dispositivo conectado, como um celular, pode transmitir notificações para um dispositivo Wear para que as
notificações sejam exibidas nele. De forma similar, ele pode transmitir ações para que o usuário possa agir
sobre as notificações diretamente do dispositivo Wear.</p>
<p><strong>Transmitir</strong></p>
<ul>
<li> Novas mensagens instantâneas</li>
<li> Ações de um toque, como +1, Curtir, Coração</li>
</ul>
<img src="{@docRoot}images/android-5.0/notifications/WearBasic.png" width="156px" height="156px" alt="" />
<p><strong>Não transmitir</strong></p>
<ul>
<li> Notificações de podcasts recém-chegados</li>
<li> Ações que mapeiem para recursos que não são possíveis no relógio</li>
</ul>
<p><h4>Ações exclusivas a definir para Wear</h4></p>
<p>Há algumas ações que só podem ser realizadas em Wear. Elas incluem:</p>
<ul>
<li> Listas rápidas de respostas prontas, como "Volto logo"</li>
<li> Abrir no celular</li>
<li> Uma ação "Comentar" ou "Responder" que abre a tela de entrada de voz</li>
<li> Ações que executam aplicativos específicos de Wear</li>
</ul>
<img src="{@docRoot}images/android-5.0/notifications/ReplyAction.png" width="156px" height="156px" alt="" />