design/patterns/notifications.jd

page.title=Notificaes
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>Notificao ao usurio</p>
  </div>
</a>

<a class="notice-designers" href="notifications_k.html">
  <div>
    <h3>Notificaes 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>Vdeo</h3>
    <p>DevBytes: Notificaes na pr-visualizao do desenvolvedor do Android L</p>
</div>
</a>

<style>
  .col-5, .col-6, .col-7 {
    margin-left:0px;
  }
</style>

<p>O sistema de notificaes permite que os usurios se mantenham informados sobre eventos relevantes e
imediatos
no aplicativo, como novas mensagens de bate-papo de um amigo ou um evento de calendrio.
Pense nas notificaes como um canal de notcias que alerta o usurio sobre eventos
importantes
medida que acontecem ou sobre um registro que grava eventos enquanto o usurio no est prestando
ateno &mdash; 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 notificaes recebem atualizaes importantes: em termos estruturais, visuais e
funcionais:</p>

<ul>
  <li>As notificaes passaram por mudanas visuais consistentes com o novo
tema do Material Design.</li>
  <li> As notificaes agora esto disponveis na tela de bloqueio do dispositivo, enquanto que
o contedo sensvel ainda pode
ficar oculto atrs dela.</li>
  <li>Notificaes de alta prioridade recebidas enquanto o dispositivo est em uso agora usam um novo formato, chamado de
notificaes heads-up.</li>
  <li>Notificaes sincronizadas na nuvem: descartar uma notificao em um dos
dispositivos Android a descarta
tambm nos outros.</li>
</ul>

<p class="note"><strong>Observao:</strong> o projeto de notificao nesta verso do
Android  uma mudana
significativa em relao s verses anteriores. Para obter informaes sobre o projeto de notificao em verses
anteriores, consulte <a href="./notifications_k.html">Notificaes no Android 4.4 ou em anteriores</a>.</p>

<h2 id="Anatomy">Anatomia de uma notificao</h2>

<p>Esta seo aborda as partes bsicas de uma notificao e como elas
podem aparecer em diferentes tipos de dispositivos.</p>

<h3 id="BaseLayout">Layout bsico</h3>

<p>No mnimo, todas as notificaes consistem em um layout bsico, incluindo:</p>

<ul>
  <li> O <strong>cone</strong> da notificao. O cone simboliza o
aplicativo de origem. Ele tambm
  pode indicar o tipo de notificao, caso o aplicativo gere mais de um
tipo.</li>
  <li> Um <strong>ttulo</strong> da notificao e
<strong>texto</strong> adicional.</li>
  <li> Uma <strong>marcao de data e hora</strong>.</li>
</ul>

<p>Notificaes criadas com {@link android.app.Notification.Builder Notification.Builder}
para verses anteriores da plataforma tm a mesma aparncia e o mesmo funcionamento no Android
5.0, com apenas mudanas menores de estilo que o sistema
entrega a voc. Para obter mais informaes sobre notificaes em verses
anteriores do Android, consulte
<a href="./notifications_k.html">Notificaes 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 bsico de uma notificao em dispositivo porttil ( esquerda) e a mesma notificao em Wear ( direita),
com uma foto do usurio e um cone de notificao
    </p>
  </div>

<h3 id="ExpandedLayouts">Layouts expandidos</h3>


<p>Voc pode escolher o nvel de detalhe que as notificaes de seu aplicativo
devem fornecer. Elas podem mostrar as primeiras
linhas de uma mensagem ou exibir uma visualizao de imagem maior. As informaes
adicionais fornecem ao usurio mais
contexto e &mdash; em alguns casos &mdash; podem permitir que o usurio leia uma mensagem
em sua totalidade. O usurio pode
pinar para aproximar ou afastar a vista ou realizar deslizamento de um dedo para alternar entre os layouts
compacto e expandido.
 Para notificaes de um evento, o Android fornece trs modelos de layout
expandido (texto, caixa de entrada e
 imagem) para usar em seu aplicativo. As imagens a seguir mostram como
se parecem notificaes de um evento em
 dispositivos portteis ( 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">Aes</h3>

<p>O Android tem suporte para aes opcionais que so exibidas na parte inferior
da notificao.
Com aes, os usurios podem tratar as tarefas mais comuns para
determinada notificao de dentro da sombra da notificao sem precisar abrir o
aplicativo de origem.
Isso acelera a interao e, em conjunto com deslizar-para-descartar, ajuda os usurios a
se concentrarem em notificaes 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 nmero de aes que inclui em uma
notificao. Quanto mais
aes incluir, maior ser a complexidade cognitiva criada. Limite-se
ao menor nmero possvel
de aes, incluindo apenas as aes efetivamente mais importantes e
significativas.</p>

<p>Boas candidatas a aes em notificaes so aes que:</p>

<ul>
  <li> Sejam essenciais, frequentes e tpicas para o tipo de contedo
exibido
  <li> Permitam que o usurio realize tarefas rapidamente
</ul>

<p>Evite aes que sejam:</p>

<ul>
  <li> Ambguas
  <li> Idnticas  ao padro da notificao (como "Ler" ou
"Abrir")
</ul>


<p>Voc pode especificar no mximo trs aes, cada uma consistindo em um cone
e um nome de ao.
 Adicionar aes a um layout bsico simples torna a notificao expansvel,
mesmo se a
notificao no tiver um layout expandido. Como as aes so exibidas apenas para notificaes
expandidas
 e que ficam de outra forma ocultas, certifique-se de que qualquer ao que um
usurio possa invocar de dentro de uma
 notificao esteja disponvel tambm dentro do aplicativo
associado.</p>

<h2 style="clear:left">Notificao 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 notificao heads-up (chamada telefnica recebida, alta prioridade)
que aparece sobre um
aplicativo imersivo
  </p>
</div>

<p>Quando uma notificao de alta prioridade chega (veja  direita), ela  apresentada
aos usurios por
um perodo curto com um layout expandido mostrando possveis aes.</p>
<p> Depois desse perodo, a notificao recua para a sombra
de notificao. Se a <a href="#correctly_set_and_manage_notification_priority">prioridade</a> de uma notificao for
marcada como Alta, Mxima ou tela cheia, ela receber uma notificao heads-up.</p>

<p><b>Bons exemplos de notificaes heads-up</b></p>

<ul>
  <li> Chamada telefnica 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 notificaes de itens enviados por outra pessoa (como uma mensagem ou
atualizao de status), inclua a imagem da pessoa usando
{@link android.app.Notification.Builder#setLargeIcon setLargeIcon()}. Anexe tambm informaes sobre
a pessoa nos metadados da notificao (consulte {@link android.app.Notification#EXTRA_PEOPLE}).</p>

<p>O cone principal de sua notificao ainda  mostrado, portanto, o usurio pode associ-lo
ao cone
visvel 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">
  Notificao que mostra a pessoa que a ativou e o contedo enviado.
</p>


<h3 id="navigate_to_the_right_place">Navegao para o lugar certo</h3>

<p>Quando o usurio toca no corpo de uma notificao (fora dos botes
de ao), abra o aplicativo
no lugar em que o usurio possa visualizar e agir sobre os dados referenciados na
notificao. Na maioria dos casos, ser a exibio detalhada de um nico item de dado, como uma mensagem,
mas tambm poder ser uma
vista resumida se a notificao estiver empilhada. Se o aplicativo
levar o usurio a qualquer lugar abaixo do nvel superior do aplicativo, insira a navegao na pilha de retorno do aplicativo para que
o usurio possa pressionar o boto Voltar do sistema para voltar ao nvel superior. Para obter mais informaes, consulte
<em>Navegao para o seu aplicativo pelos widgets de pgina inicial e notificaes</em> no padro de projeto de <a href="{@docRoot}design/patterns/navigation.html#into-your-app">Navegao</a>.
</p>

<h3 id="correctly_set_and_manage_notification_priority">Definio e gerenciamento
corretos da prioridade das
notificaes</h3>

<p>O Android tem suporte para um sinalizador de prioridade para notificaes. Esse sinalizador permite
influenciar o local em que a notificao  exibida em relao a outras notificaes e
ajuda a garantir
que os usurios sempre vejam primeiro as notificaes mais importantes. Voc pode escolher entre
os seguintes
nveis de prioridade ao publicar uma notificao:</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 notificaes crticas e urgentes que alertam o usurio sobre uma condio
que depende
do tempo ou que precisa ser resolvida antes que o usurio 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 comunicaes importantes, como uma mensagem ou
eventos de bate-papo com contedo particularmente interessante para o usurio.
Notificaes de alta prioridade acionam a exibio de uma notificao heads-up.</p>
</td>
 </tr>
 <tr>
    <td class="tab1">
<p><code>DEFAULT</code></p>
</td>
    <td class="tab1">
<p>Use para todas as notificaes que no 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 notificaes sobre as quais deseja que o usurio seja informado, mas
que sejam menos urgentes. Notificaes de baixa prioridade tendem a ser exibidas na parte inferior da lista,
o que as torna uma boa
opo para coisas como atualizaes pblicas ou sociais no direcionadas: o usurio pediu para
ser notificado sobre
elas, mas essas notificaes nunca devem ter precedncia sobre comunicaes
urgentes ou diretas.</p>
</td>
 </tr>
 <tr>
    <td class="tab1">
<p><code>MIN</code></p>
</td>
    <td class="tab1">
<p>Use para informaes contextuais ou de histrico, como informaes sobre clima ou
informaes contextuais de localizao.
Notificaes de prioridade mnima no aparecem na barra de status. O usurio
as descobre expandindo a sombra da notificao.</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> so nveis de prioridade de interrupo e arriscam
interromper a atividade
do usurio. Para evitar irritar os usurios de seu aplicativo, reserve nveis de prioridade de interrupo para
notificaes que:</p>

<ul>
  <li> Envolvam outra pessoa</li>
  <li> Dependam do tempo</li>
  <li> Possam mudar imediatamente o comportamento do usurio no mundo real</li>
</ul>

<p>Notificaes definidas como <code>LOW</code> e <code>MIN</code> ainda podem
ser valiosas para o usurio: muitas, se no a maioria, das notificaes no precisam demandar a ateno
imediata do usurio, ou vibrar o pulso do usurio, mas ainda contm informaes que o usurio
achar valiosas ao decidir procurar
notificaes. Os critrios para notificaes de prioridade <code>LOW</code> e <code>MIN</code>
incluem:</p>

<ul>
  <li> No envolver outras pessoas</li>
  <li> No depender de tempo</li>
  <li> Ter contedo no qual o usurio 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">Definio de uma categoria
de notificao</h3>

<p>Se a sua notificao recair em uma das categorias predefinidas (veja
abaixo), atribua-a
adequadamente.  Aspectos da IU do sistema, como a sombra da notificao (ou qualquer
outra escuta
de notificao), podem usar essas informaes para tomar decises de classificao 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 vdeo) ou solicitao similar de
comunicao sncrona</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 instantnea 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 assncronas 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 calendrio</p>
</td>
 </tr>
 <tr>
    <td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_PROMO">CATEGORY_PROMO</a></code></p>
</td>
    <td>
<p>Promoo 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 cronmetro</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 operao de execuo 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>Atualizao 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 operao de segundo plano ou no status de autenticao</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 mdia para reproduo</p>
</td>
 </tr>
 <tr>
    <td>
<p><code><a
href="/reference/android/app/Notification.html#CATEGORY_SYSTEM">CATEGORY_SYSTEM</a></code></p>
</td>
    <td>
<p>Atualizao 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>Indicao de servio de segundo plano em execuo</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 recomendao especfica e oportuna para uma nica coisa.  Por exemplo, um aplicativo
de notcias pode querer
recomendar uma notcia que acredita que o usurio 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>Informaes contnuas sobre o dispositivo ou o status contextual</p>
</td>
 </tr>
</table>

<h3 id="summarize_your_notifications">Resuma as notificaes</h3>

<p>Se uma notificao de um certo tipo j estiver pendente quando o aplicativo tentar enviar uma nova
notificao do mesmo tipo, combine-as em uma nica notificao de resumo para o aplicativo. No
crie um novo objeto.</p>

<p>Uma notificao de resumo cria uma descrio resumida e permite que o
usurio entenda quantas notificaes
de um determinado tipo esto pendentes.</p>

<div class="col-6">

<p><strong>O que no 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 notificaes individuais que compem um
resumo usando o layout resumido expandido. Essa abordagem permite que os usurios
entendam melhor quais
notificaes esto pendentes e decidam se esto 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">
  Notificao expandida e contrada que  um resumo (usando <code>InboxStyle</code>)
  </p>
</div>

<h3 style="clear:both" id="make_notifications_optional">Torne as notificaes
opcionais</h3>

<p>Os usurios devem sempre controlar as notificaes. Permita que o usurio
desative as notificaes
de seu aplicativo ou altere as propriedades de alerta, como som de alerta e
se a vibrao ser usada,
adicionando um item de configurao da notificao nas configuraes do aplicativo.</p>

<h3 id="use_distinct_icons">Use cones distintos</h3>
<p>Ao olhar para a rea de notificao, o usurio dever ser capaz de discernir
que tipos de
notificaes esto 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 notificao que os aplicativos do Android j fornecem e crie
cones de notificao para o seu
aplicativo que tenham aparncia suficientemente distinta.</p>

    <p><strong>O que fazer</strong></p>
    <p>Use o <a href="/design/style/iconography.html#notification">estilo de cone de notificao</a> apropriado
 para cones pequenos e o
    <a href="/design/style/iconography.html#action-bar">estilo de cone de barra
de ao</a> da luminosidade do Material para os cones
    de ao.</p>
<p ><strong>O que fazer</strong></p>
<p >Mantenha os cones visualmente simples, evitando detalhes excessivos que sejam
difceis de discernir.</p>

  <div><p><strong>O que no fazer</strong></p>
    <p>Coloque um alfa adicional (esmaecimento ou reduo de intensidade) nos cones pequenos
e nos cones de
    ao; eles podem ter bordas suavizadas, mas, como o Android usa esses
cones como mscaras (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 no fazer</strong></p>

<p>Use cores para distinguir o seu aplicativo dos outros. cones de notificao devem
somente ser uma imagem com fundo branco sobre transparente.</p>


<h3 id="pulse_the_notification_led_appropriately">Pisque o LED de notificao
adequadamente</h3>

<p>Muitos dispositivos Android contm um LED de notificao, que  usado para manter o
usurio informado sobre
eventos enquanto a tela est desligada. Notificaes com um nvel 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>) no devem.</p>

<p>O controle do usurio sobre as notificaes deve se estender ao LED. Ao usar
DEFAULT_LIGHTS, o
LED brilhar na cor branca. Suas notificaes no devem usar uma cor
diferente, a no ser que o
usurio as tenha explicitamente personalizado.</p>

<h2 id="building_notifications_that_users_care_about">Criao de notificaes
que agradam aos usurios</h2>

<p>Para criar um aplicativo que os usurios amem,  importante projetar as
notificaes cuidadosamente.
As notificaes personificam a voz do seu aplicativo e contribuem para
a personalidade dele. Notificaes indesejadas ou
irrelevantes podem irritar o usurio ou fazer com que ele reprove a
quantidade de ateno que o
aplicativo exige. Portanto, use notificaes de forma cuidadosa.</p>

<h3 id="when_to_display_a_notification">Quando exibir uma notificao</h3>

<p>Para criar um aplicativo que as pessoas gostem de usar,  importante
reconhecer que a ateno e o foco
do usurio so recursos que devem ser protegidos. Apesar de o sistema de
notificao do Android ter
sido projetado para minimizar o impacto das notificaes na ateno do usurio,
ainda
importante ter cincia do fato de que as notificaes interrompem o
fluxo de tarefas do usurio.
Ao planejar as notificaes, pergunte-se se elas so importantes o suficiente para
justificar uma interrupo. Se no tiver certeza, permita que o usurio decida se quer
uma notificao usando as configuraes de notificao do seu aplicativo ou ajuste
o sinalizador de prioridade das notificaes para <code>LOW</code> ou <code>MIN</code> para
evitar distrair o usurio 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 notificao que depende de tempo
  </p>

<p>Apesar de aplicativos bem comportados geralmente se manifestarem apenas quando ocorre interao com eles, alguns
casos justificam que o aplicativo interrompa o usurio com uma notificao no solicitada.</p>

<p>Use notificaes principalmente para <strong>eventos que dependam de tempo</strong>, especialmente
 se esses eventos sncronos <strong>envolverem outras pessoas</strong>. Por
exemplo, um bate-papo recebido
 uma forma sncrona em tempo real de comunicao: outro usurio
espera ativamente a resposta. Eventos de calendrio so outro exemplo bom de quando usar uma
notificao e atrair a
ateno do usurio, pois o evento  iminente e eventos de calendrio frequentemente
envolvem outras pessoas.</p>

<h3 style="clear:both" id="when_not_to_display_a_notification">Quando no exibir
uma notificao</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, notificaes no so adequadas:</p>

<ul>
  <li> Evite notificar o usurio sobre informaes que no so especificamente
direcionadas a ele ou
que no dependam realmente de tempo. Por exemplo, as atualizaes
assncronas e no direcionadas
que fluem por uma rede social geralmente no justificam uma interrupo
em tempo real. Para os usurios que se importam
com elas, deixe que decidam receb-las.</li>
  <li> No crie uma notificao se as informaes novas relevantes estiverem
atualmente na tela. Em vez disso,
use a IU do prprio aplicativo para notificar o usurio das novas informaes
diretamente no contexto.
  Por exemplo, um aplicativo de bate-papo no deve criar notificaes de sistema enquanto o
usurio estiver conversando ativamente com outro usurio.</li>
  <li> No interrompa o usurio para realizar operaes tcnicas de baixo nvel, como salvar
ou sincronizar informaes, nem atualize um aplicativo se o aplicativo ou o sistema puder resolver
o problema sem envolver o usurio.</li>
  <li> No interrompa o usurio para informar um erro se o aplicativo
puder se recuperar dele por conta prpria, sem que o usurio
tome qualquer ao.</li>
  <li> No crie notificaes que no tenham contedo real de notificao e
que meramente anunciem o seu
aplicativo. Uma notificao deve fornecer informaes teis, oportunas e novas e
no deve ser usada
meramente para executar um aplicativo.</li>
  <li> No crie notificaes suprfluas apenas para colocar sua marca na frente
dos usurios.
  Tais notificaes frustram e provavelmente alienam seu pblico-alvo. A
melhor forma de fornecer
  pequenas quantidades de informaes atualizadas e manter o usurio 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">Interao com
notificaes</h2>

<p>Notificaes so indicadas por cones na barra de status e podem ser acessadas
abrindo a
gaveta de notificaes.</p>

<p>Tocar em uma notificao abre o aplicativo associado com o contedo
detalhado que corresponde  notificao.
Deslizar  esquerda ou  direita em uma notificao a remove da gaveta.</p>

<h3 id="ongoing_notifications">Notificaes contnuas</h3>
<div class="figure" style="width:311px">
  <img src="{@docRoot}images/android-5.0/notifications/MusicPlayback.png" alt="" width="311px" />
      <p class="img-caption">
    Notificao contnua devido  reproduo de msica
  </p>
</div>
<p>Notificaes contnuas mantm os usurios informados sobre um processo em andamento em
segundo plano.
Por exemplo, reprodutores de msica anunciam a faixa em reproduo no
sistema de notificao e
continuam a fazer isso at que o usurio interrompa a reproduo. Notificaes contnuas tambm podem
mostrar ao usurio
feedback sobre tarefas mais longas, como o download de um arquivo ou a codificao de um vdeo. Um usurio no pode remover
manualmente uma notificao contnua da gaveta de notificaes.</p>

<h3 id="ongoing_notifications">Reproduo de mdia</h3>
<p>No Android 5.0, a tela de bloqueio no mostra controles de transporte por causa da classe
{@link android.media.RemoteControlClient} obsoleta. Mas ela <em>mostra</em> notificaes, portanto, a notificao de reproduo
de cada aplicativo agora  a forma
principal para que os usurios controlem a reproduo em um estado bloqueado. Esse comportamento d aos aplicativos mais
controle sobre quais
botes exibir e de que forma, ao mesmo tempo em que fornece uma experincia consistente
para o usurio, com a tela bloqueada ou no.</p>

<h3 style="clear:both"
id="dialogs_and_toasts_are_for_feedback_not_notification">Dilogos
e avisos</h3>

<p>O seu aplicativo no deve criar uma caixa de dilogo ou um aviso se no estiver
atualmente na tela. Uma caixa de dilogo ou um aviso
 deve ser exibido somente como uma resposta imediata ao usurio tomando uma ao
dentro do seu aplicativo.
Para obter orientao adicional sobre o uso de caixas de dilogo e avisos, consulte
<a href="/design/patterns/confirming-acknowledging.html">Confirmao e reconhecimento</a>.</p>

<h3>Avaliao e classificao</h3>

<p>Notificaes so notcias e, portanto, so essencialmente exibidas
em ordem cronolgica inversa, com
considerao especial para a
<a href="#correctly_set_and_manage_notification_priority">prioridade</a> da notificao declarada no aplicativo.</p>

<p>Notificaes so uma parte importante da tela de bloqueio e so exibidas proeminentemente
sempre
que a tela do dispositivo  exibida. O espao na tela de bloqueio  restrito, portanto,
 mais importante
do que nunca identificar as notificaes mais urgentes ou relevantes. Por esse
motivo, o Android tem um
algoritmo de classificao mais sofisticado para notificaes, levando em conta:</p>

<ul>
  <li> A marcao de data e hora e a prioridade declarada no aplicativo.</li>
  <li> Se a notificao incomodou recentemente o usurio com som ou
vibrao (ou seja,
  se o celular acabou de fazer um rudo e o usurio deseja saber "O que acabou de
acontecer?", a tela de bloqueio
  deve responder com um olhar rpido).</li>
  <li> Qualquer pessoa anexada  notificao usando {@link android.app.Notification#EXTRA_PEOPLE}
  e, em particular, se  contato especial (com estrelas).</li>
</ul>

<p>Para aproveitar ao mximo essa classificao, concentre-se na experincia
do usurio que deseja
criar, e no 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">Notificaes do Gmail tm
prioridade padro e normalmente
  so classificadas abaixo de mensagens de um aplicativo de mensagem instantnea, como o Hangouts, mas
recebem
  uma promoo temporria quando novas mensagens chegam.
  </p>


<h3>Na tela de bloqueio</h3>

<p>Como as notificaes so visveis na tela de bloqueio, a privacidade do usurio  uma considerao
especialmente
 importante. Notificaes frequentemente contm informaes sensveis e
no devem necessariamente estar visveis
para qualquer pessoa que ligar a tela do dispositivo.</p>

<ul>
  <li> Para dispositivos que tm uma tela de bloqueio segura (PIN, padro ou senha), a interface tem
partes pblicas e privadas. A interface pblica pode ser exibida em uma tela de bloqueio segura e,
portanto, vista por qualquer pessoa. A interface privada  o mundo atrs da tela de bloqueio e
s  revelada depois que o usurio faz login no dispositivo.</li>
</ul>

<h3>Controle do usurio sobre as informaes 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">
    Notificaes na tela de bloqueio com contedo revelado depois que o usurio desbloqueia o dispositivo.
  </p>
</div>

<p>Ao definir uma tela de bloqueio segura, o usurio poder escolher ocultar
detalhes sensveis da tela de bloqueio segura. Nesse caso, a IU do sistema
considerar o <em>nvel de visibilidade</em> da notificao para descobrir o que pode
ser exibido com segurana.</p>
<p> Para controlar o nvel 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 contedo inteiro da notificao.
  Esse  o padro do sistema se a visibilidade no for especificada.</li>
  <li><code><a
href="/reference/android/app/Notification.html#VISIBILITY_PRIVATE">VISIBILITY_PRIVATE</a></code>.
Na tela de bloqueio, exibe informaes bsicas sobre essa notificao, incluindo o
cone e o nome do aplicativo que a publicou. O restante dos detalhes da notificao no  exibido.
Alguns pontos a ter em mente so:
  <ul>
    <li> Se voc quer fornecer uma verso pblica diferente da sua notificao
para que o sistema a exiba em uma tela de bloqueio segura, fornea um objeto
Notificao substituto no campo <code><a
href="/reference/android/app/Notification.html#publicVersion">Notification.publicVersion</a></code>.

    <li> Essa configurao d ao aplicativo uma oportunidade de criar uma verso alternativa do
contedo que ainda  til, mas no revela informaes pessoais. Considere o exemplo de um
aplicativo de SMS cujas notificaes incluem o texto da mensagem SMS, o nome do remetente e o cone do contato.
Essa notificao deve ser <code>VISIBILITY_PRIVATE</code>, mas <code>publicVersion</code> ainda pode
conter informaes teis, como "3 novas mensagens", sem outros detalhes
de identificao.
  </ul>
  </li>
  <li><code><a
href="/reference/android/app/Notification.html#VISIBILITY_SECRET">Notification.VISIBILITY_SECRET</a></code>. Mostra apenas as informaes mnimas, excluindo at mesmo
o cone da notificao.</li>
</ul>
<h2 style="clear:both" id="notifications_on_android_wear">Notificaes no
Android Wear</h2>

<p>Notificaes e suas <em>aes</em> so enviadas a dispositivos Wear por padro.
Os desenvolvedores podem controlar que notificaes so enviadas do
celular ao relgio
e vice-versa. Os desenvolvedores tambm podem controlar quais aes so transmitidas. Se o
seu aplicativo inclui
aes que no podem ser executadas com um toque, oculte essas aes
na sua notificao do Wear
ou considere coloc-las em um aplicativo do Wear, permitindo que o usurio
termine a ao
no relgio.</p>

<h4>Transmisso de notificaes e aes</h4>

<p>Um dispositivo conectado, como um celular, pode transmitir notificaes para um dispositivo Wear para que as
notificaes sejam exibidas nele. De forma similar, ele pode transmitir aes para que o usurio possa agir
sobre as notificaes diretamente do dispositivo Wear.</p>

<p><strong>Transmitir</strong></p>

<ul>
  <li> Novas mensagens instantneas</li>
  <li> Aes de um toque, como +1, Curtir, Corao</li>
</ul>

<img src="{@docRoot}images/android-5.0/notifications/WearBasic.png" width="156px" height="156px" alt="" />

<p><strong>No transmitir</strong></p>

<ul>
  <li> Notificaes de podcasts recm-chegados</li>
  <li> Aes que mapeiem para recursos que no so possveis no relgio</li>
</ul>


<p><h4>Aes exclusivas a definir para Wear</h4></p>

<p>H algumas aes que s podem ser realizadas em Wear. Elas incluem:</p>

<ul>
  <li> Listas rpidas de respostas prontas, como "Volto logo"</li>
  <li> Abrir no celular</li>
  <li> Uma ao "Comentar" ou "Responder" que abre a tela de entrada de voz</li>
  <li> Aes que executam aplicativos especficos de Wear</li>
</ul>

<img src="{@docRoot}images/android-5.0/notifications/ReplyAction.png" width="156px" height="156px" alt="" />