xref: /frameworks/base/docs/html-intl/intl/pt-br/about/versions/android-5.0.jd

page.title=APIs do Android 5.0
excludeFromSuggestions=true
sdk.platform.version=5.0
sdk.platform.apiLevel=21
@jd:body


<div id="qv-wrapper">
<div id="qv">

<h2>Neste documento <a href="#" onclick="hideNestedItems('#toc44',this);return false;" class="header-toggle"> <span class="more">mostrar mais</span> <span class="less" style="display:none">mostrar menos</span></a></h2>

<ol id="toc44" class="hide-nested">
  <li><a href="#ApiLevel">Atualizar seu nvel de API desejado</a></li>
  <li><a href="#Behaviors">Alteraes importantes de comportamento</a>
    <ol>
      <li><a href="#ART">Caso voc ainda no tenha testado seu app no novo tempo de execuo do Android (ART)</a></li>
      <li><a href="#BehaviorNotifications">Caso seu app implemente notificaes</a></li>
      <li><a href="#BehaviorMediaControl">Caso seu app use RemoteControlClient</a></li>
<li><a href="#BehaviorGetRecentTasks">Caso seu app use getRecentTasks()</a></li>
<li><a href="#64BitSupport">Caso voc esteja usando o Kit de desenvolvimento nativo do Android (NDK, na sigla em ingls)</a></li>
<li><a href="#BindService">Caso seu app esteja associado a um servio</a></li>
<li><a href="#BehaviorWebView">Caso seu app use WebView</a></li>
    </ol>
  </li>
  <li><a href="#UI">Interface do usurio</a>
    <ol>
      <li><a href="#MaterialDesign">Suporte ao material design</a></li>
      <li><a href="#Recents">Documentos simultneos recentes e atividades na tela de recentes</a></li>
      <li><a href="#WebView">Atualizaes de WebView</a></li>
      <li><a href="#ScreenCapture">Compartilhamento e captura de tela</a></li>
    </ol>
  </li>
  <li><a href="#Notifications">Notificaes</a>
    <ol>
      <li><a href="#LockscreenNotifications">Notificaes na tela bloqueada</a></li>
      <li><a href="#NotificationsMetadata">Metadados de notificaes</a></li>
    </ol>
  </li>
  <li><a href="#Graphics">Grficos</a>
    <ol>
      <li><a href="#OpenGLES-3-1">Suporte para OpenGL ES 3.1 </a></li>
      <li><a href="#AndroidExtensionPack">Pacote de extenses para Android</a></li>
    </ol>
  </li>
  <li><a href="#Media">Mdia</a>
    <ol>
      <li><a href="#Camera-v2">API de cmera para funcionalidades avanadas da cmera</a></li>
      <li><a href="#AudioPlayback">Reproduo de udio</a></li>
      <li><a href="#MediaPlaybackControl">Controle de reproduo de mdia</a></li>
      <li><a href="#MediaBrowsing">Navegao de mdia</a></li>
    </ol>
  </li>
  <li><a href="#Storage">Armazenamento</a>
    <ol>
      <li><a href="#DirectorySelection">Seleo do diretrio</a></li>
    </ol>
  </li>
  <li><a href="#Wireless">Sem fio e conectividade</a>
    <ol>
      <li><a href="#Multinetwork">Vrias conexes de rede</a></li>
      <li><a href="#BluetoothBroadcasting">Transmisso por Bluetooth</a></li>
      <li><a href="#NFCEnhancements">Aprimoramentos na NFC</a></li>
    </ol>
  </li>
  <li><a href="#Power">Project Volta</a>
    <ol>
      <li><a href="#JobScheduler">Agendamento de tarefas</a></li>
      <li><a href="#PowerMeasurementTools">Ferramentas do desenvolvedor para uso da bateria</a>
    </ol>
  </li>
  <li><a href="#Enterprise">Android no local de trabalho e na educao</a>
    <ol>
      <li><a href="#ManagedProvisioning">Aprovisionamento gerenciado</a></li>
      <li><a href="#DeviceOwner">Proprietrio do dispositivo</a></li>
      <li><a href="#ScreenPinning">Fixao de tela</a></li>
    </ol>
  </li>
  <li><a href="#System">Sistema</a>
    <ol>
      <li><a href="#AppUsageStatistics">Estatsticas de uso do app</a></li>
    </ol>
  </li>
  <li><a href="#Printing">Estrutura de impresso</a>
    <ol>
      <li><a href="#PDFRender">Processar PDF como bitmap</a></li>
    </ol>
  </li>
  <li><a href="#TestingA11y">Testes e acessibilidade</a>
    <ol>
      <li><a href="#TestingA11yImprovements">Testes e aprimoramentos na acessibilidade</a></li>
    </ol>
  </li>
  <li><a href="#IME">IME</a>
    <ol>
      <li><a href="#Switching">Fcil de alternar entre os idiomas de entrada</a></li>
    </ol>
  </li>
  <li><a href="#Manifest">Declaraes do manifesto</a>
    <ol>
      <li><a href="#ManifestFeatures">Recursos obrigatrios declarveis</a></li>
      <li><a href="#Permissions">Permisses de usurio</a></li>
    </ol>
  </li>
</ol>

<h2>Diferenas de API</h2>
<ol>
<li><a href="{@docRoot}sdk/api_diff/21/changes.html">Nvel de API de 20 a 21 </a> </li>
<li><a href="{@docRoot}sdk/api_diff/preview-21/changes.html">Visualizao do desenvolvedor de L a 21 </a> </li>
</ol>

</div>
</div>

<p>Nvel de API: {@sdkPlatformApiLevel}</p>

<p>O Android 5.0 (<a href="{@docRoot}reference/android/os/Build.VERSION_CODES.html#LOLLIPOP">LOLLIPOP</a>) oferece novos recursos para usurios e desenvolvedores de apps. Este documento fornece uma introduo s novas APIs mais relevantes.</p>

<p>Para uma viso de alto nvel dos novos recursos da plataforma, veja os <a href="{@docRoot}about/versions/lollipop.html">destaques do Android Lollipop</a>.</p>


<h3 id="Start">Comear a desenvolver</h3>

<p>Para comear a criar apps para o Android 5.0, primeiro  preciso <a href="{@docRoot}sdk/index.html">conseguir o SDK do Android</a>. Depois disso, use o <a href="{@docRoot}tools/help/sdk-manager.html">Gerenciador de SDK</a> para fazer o download das imagens do sistema e da plataforma de SDK do Android 5.0.</p>

<p style=" padding: 10px; background: #eee; width: 445px; border: 1px solid #ccc; margin-top: 20px;">Para testar seus apps em um dispositivo real, inclua um Nexus 5 ou 7 com a <br><a href="/preview/index.html#Start"><b>IMAGEM DE VISUALIZAO DO SISTEMA DO ANDROID</b></a>.</p>



<h3 id="ApiLevel">Atualizar seu nvel de API desejado</h3>

<p>Para melhor otimizar seu app para os dispositivos executando Android {@sdkPlatformVersion}, defina <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code targetSdkVersion}</a> como <code>"{@sdkPlatformApiLevel}"</code>, instale o app em uma imagem do sistema do Android {@sdkPlatformVersion}, teste-a e, em seguida, publique o app atualizado com essa alterao.</p>

<p> possvel usar as APIs do Android {@sdkPlatformVersion} ao mesmo tempo em que oferece suporte a verses mais antigas adicionando condies para o nvel de API do sistema antes de executar APIs que no so compatveis com seu <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code minSdkVersion}</a>. Para saber mais sobre a manuteno de compatibilidade com verses anteriores, leia <a href="{@docRoot}training/basics/supporting-devices/platforms.html">Suporte a diferentes verses de plataforma</a>.</p>

<p>Para mais informaes sobre como os nveis de API funcionam, leia <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">O que  um nvel de API?</a></p>

<h2 id="Behaviors">Alteraes importantes de comportamento </h2>

<p>Se voc j tiver publicado um app para Android, esteja ciente de que seu app pode ser afetado por alteraes feitas no Android 5.0.</p>

<h3 id="ART">Se voc ainda no tiver testado o app com o novo tempo de execuo do Android (ART)</h3>

<p>A verso 4.4 apresentou um novo tempo de execuo experimental do Android, o ART. Na verso 4.4, o ART era opcional, e o tempo de execuo padro continuava sendo o Dalvik. Com o Android 5.0, o ART agora  o tempo de execuo padro.</p>

<p>Para uma viso geral dos novos recursos do ART, consulte <a href="https://source.android.com/devices/tech/dalvik/art.html">Introduo ao ART</a>. Alguns dos principais recursos novos so:</p>

<ul>
  <li>Compilao antecipada (AOT, na sigla em ingls)</li>
  <li>Coleta de lixo aprimorada (GC, na sigla em ingls)</li>
  <li>Suporte  depurao aprimorado</li>
</ul>

<p>A maioria dos apps para Android deve funcionar com o ART sem alteraes. No entanto, algumas tcnicas que funcionam em Dalvik no funcionam no ART. Para informaes sobre os problemas mais importantes, consulte <a href="{@docRoot}guide/practices/verifying-apps-art.html">Verificao do comportamento do app no tempo de execuo Android (ART)</a>. Preste especial ateno se:</p>

<ul>
  <li>O app usar interface nativa Java (JNI, na sigla em ingls) para executar cdigo C/C++.</li>
  <li>Voc usar ferramentas de desenvolvedor que geram cdigo no padro (como alguns ofuscadores).</li>
  <li>Voc usar tcnicas que so incompatveis com a compactao de coleta de lixo. O ART no implementa a compactao de coleta de GC atualmente, mas essa compactao est em desenvolvimento no projeto de cdigo aberto do Android.</li>
</ul>

<h3 id="BehaviorNotifications">Caso seu app implemente as notificaes</h3>

<p>Verifique se suas notificaes consideram essas alteraes do Android 5.0. Para saber mais sobre como fazer as notificaes para o Android 5.0 e superior, consulte o <a href="{@docRoot}design/patterns/notifications.html">Guia de design de notificaes</a>.
</p>

<h4 id="NotificationsMaterialDesignStyle">Estilo do material design</h4>
<p>As notificaes so desenhadas com texto escuro em planos de fundo brancos (ou muito claros) para corresponder aos novos widgets de material design. Verifique a aparncia de todas as suas notificaes com o novo esquema de cores. Se o resultado no estiver bom, corrija-o:</p>

<ul>
  <li>Use {@link android.app.Notification.Builder#setColor(int) setColor()} para definir uma cor de destaque em um crculo atrs da imagem do cone. </li>
  <li>Atualize ou remova recursos que envolvam cor. O sistema ignora todos os canais no Alfa em cones de ao e no cone de notificao principal. Voc deve partir do princpio de que esses cones sero somente Alfa. O sistema desenha cones de notificao em branco e cones de ao em cinza escuro.</li>
</ul>

<h4 id="NotificationsSoundVibration">Som e vibrao</h4>
<p>Se atualmente voc estiver adicionando sons e vibraes s suas notificaes usando as classes {@link android.media.Ringtone}, {@link android.media.MediaPlayer} ou {@link android.os.Vibrator}, remova este cdigo para que o sistema possa apresentar notificaes de forma correta no modo de <em>prioridade</em>. Em vez disso, use mtodos {@link android.app.Notification.Builder} para adicionar sons e vibrao.</p>

<p>Definir o dispositivo como {@link android.media.AudioManager#RINGER_MODE_SILENT RINGER_MODE_SILENT} faz com que o dispositivo entre no novo modo de prioridade. O dispositivo sai do modo prioridade se voc o configurar para {@link android.media.AudioManager#RINGER_MODE_NORMAL RINGER_MODE_NORMAL} ou {@link android.media.AudioManager#RINGER_MODE_NORMAL RINGER_MODE_VIBRATE}.</p>

<p>Anteriormente, o Android usava {@link android.media.AudioManager#STREAM_MUSIC STREAM_MUSIC} como o stream principal para controlar o volume em tablets. No Android 5.0, o stream de volume principal para dispositivos smartphone e tablet agora est unificado e  controlado por {@link android.media.AudioManager#STREAM_RING STREAM_RING} ou {@link android.media.AudioManager#STREAM_NOTIFICATION STREAM_NOTIFICATION}.</p>

<h4 id="NotificationsLockscreenVisibility">Bloquear a visibilidade da tela</h4>
<p>Por padro, as notificaes agora so exibidas na tela de bloqueio no Android 5.0. Os usurios podem optar por proteger informaes confidenciais evitando que elas sejam expostas, caso em que o sistema automaticamente redige o texto exibido pela notificao. Para personalizar esta notificao redigida, use {@link android.app.Notification.Builder#setPublicVersion(android.app.Notification) setPublicVersion()}.</p>
<p>Se a notificao no tiver informaes pessoais ou se voc desejar permitir o controle de reproduo de mdia na notificao, chame o mtodo {@link android.app.Notification.Builder#setVisibility(int) setVisibility()} e defina o nvel de visibilidade da notificao como {@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC}.
</p>

<h4 id="NotificationsMediaPlayback">Reproduo de mdia</h4>
<p>Se voc estiver implementando notificaes que apresentam controles de transporte ou status de reproduo de mdia, considere a possibilidade de usar o novo modelo {@link android.app.Notification.MediaStyle}, em vez de um objeto {@link android.widget.RemoteViews.RemoteView} personalizado. Qualquer que seja a abordagem escolhida, defina a visibilidade da notificao como {@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC} de modo que seus controles sejam acessveis a partir da tela de bloqueio. Ao iniciar o Android 5.0, o sistema no mostra mais os objetos {@link android.media.RemoteControlClient} na tela de bloqueio. Para mais informaes, consulte <a href="#BehaviorMediaControl">Caso seu app use RemoteControlClient</a>.</p>

<h4 id="NotificationsHeadsup">Notificao de alerta</h4>
<p>As notificaes agora podem aparecer em uma pequena janela flutuante (tambm chamada de notificao de alerta) quando o dispositivo estiver ativo (isto , o dispositivo estiver desbloqueado e sua tela ativada). Essas notificaes aparecem de maneira semelhante  forma compacta da sua notificao, exceto que as de alerta tambm mostram botes de ao. Os usurios podem utilizar ou dispensar notificaes de alerta sem sair do app atual.</p>

<p>Exemplos de condies que podem acionar notificaes de alerta incluem:</p>

<ul>
  <li>As atividades do usurio em modo de tela cheia (o app usa {@link android.app.Notification#fullScreenIntent})</li>
  <li>A notificao tem prioridade alta e usa toques musicais ou vibraes</li>
</ul>

<p>Caso seu app implemente notificaes em qualquer um desses cenrios, verifique se as notificaes de alerta so exibidas corretamente.</p>

<h3 id="BehaviorMediaControl">Caso seu app use RemoteControlClient</h3>
<p>O uso da classe {@link android.media.RemoteControlClient} foi suspenso. Alterne para a nova {@link android.media.session.MediaSession} API assim que possvel.</p>

<p>O bloqueio de telas no Android 5.0 no mostra controles de transporte para {@link android.media.session.MediaSession} ou {@link android.media.RemoteControlClient}. Em vez disso, o app pode fornecer controle de reproduo de mdia de tela de bloqueio por meio de uma notificao. Isso d ao app mais controle sobre a apresentao dos botes de mdia ao mesmo tempo em que fornece uma experincia consistente para usurios de dispositivos bloqueados e desbloqueados.</p>

<p>O Android 5.0 apresenta um novo modelo {@link android.app.Notification.MediaStyle} para essa finalidade. {@link android.app.Notification.MediaStyle} converte as aes de notificao que voc adicionou com {@link android.app.Notification.Builder#addAction(int, java.lang.CharSequence, android.app.PendingIntent) Notification.Builder.addAction()} em botes compactos incorporados s notificaes de reproduo de mdia do seu app. Passar o token da sesso para o mtodo {@link android.app.Notification.MediaStyle#setMediaSession(android.media.session.MediaSession.Token) setSession()} para informar o sistema de que essa notificao controla uma sesso de mdia em andamento.</p>

<p>Defina a visibilidade da notificao como {@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC} para marcar a notificao como segura a fim de ser exibida em qualquer tela de bloqueio (protegida ou no). Para mais informaes, consulte <a href="#LockscreenNotifications">Notificaes na tela de bloqueio</a>.</p>

<p>Para exibir controles de reproduo de mdia se o app estiver em execuo na plataforma da Android <a href="{@docRoot}tv/index.html">TV</a> ou do Android <a href="{@docRoot}wear/index.html">Wear</a>, implemente a classe {@link android.media.session.MediaSession}. Voc tambm deve implementar {@link android.media.session.MediaSession} caso seu app precise receber eventos de boto de mdia em dispositivos Android.</p>

<h3 id="BehaviorGetRecentTasks">Se o app usar getRecentTasks()</h3>

<p>Com a introduo dos novos recursos de <em>tarefas de atividades e documentos simultneos</em> do Android 5.0 (consulte<a href="#Recents">Documentos simultneos e atividades na tela de recentes</a> abaixo), o mtodo {@link android.app.ActivityManager#getRecentTasks ActivityManager.getRecentTasks()} teve seu uso suspenso para aprimorar a privacidade do usurio. Para compatibilidade com verses anteriores, esse mtodo ainda retorna um pequeno subconjunto de seus dados, incluindo a chamada de tarefas do prprio app e, possivelmente, outras tarefas no confidenciais (como Incio). Se o app estiver usando esse mtodo para recuperar suas prprias tarefas, use {@link android.app.ActivityManager#getAppTasks() getAppTasks()} em vez de recuperar essas informaes.</p>

<h3 id="64BitSupport">Caso voc esteja usando o Kit de desenvolvimento nativo do Android (NDK, na sigla em ingls)</h3>

<p>O Android 5.0 apresenta o suporte a sistemas de 64 bits. O aprimoramento de 64 bits aumenta o espao de endereo e melhora o desempenho ao mesmo tempo em que oferece suporte integral aos apps existentes de 32 bits. O suporte a 64 bits tambm melhora o desempenho de OpenSSL para criptografia. Alm disso, a verso apresenta novas APIs do NDK de mdia nativas, bem como o suporte a OpenGL ES (GLES) 3.1.</p>

<p>Para usar o suporte a 64 bits fornecidos no Android 5.0, faa o download e instale o NDK Revision 10c a partir da <a href="{@docRoot}tools/sdk/ndk/index.html">pgina NDK do Android</a>. Consulte as <a href="{@docRoot}tools/sdk/ndk/index.html#Revisions">notas da verso</a> do Revision 10c para mais informaes sobre alteraes importantes e correes de bug no NDK.</p>

<h3 id="BindService">Caso seu app esteja associado a um servio</h3>

<p>O mtodo {@link android.content.Context#bindService(android.content.Intent, android.content.ServiceConnection, int) Context.bindService()} agora requer um {@link android.content.Intent} explcito e lana uma exceo se fornecido um propsito implcito. Para garantir que seu app  seguro, use um propsito explcito ao iniciar ou vincular seu {@link android.app.Service} e no declare filtros de inteno para o servio.</p>

<h3 id="BehaviorWebView">Caso seu app use WebView</h3>

<p>O Android 5.0 altera o comportamento padro para o app.</p>
<ul>
<li><strong>Caso seu app segmente o nvel 21 de API ou superior: </strong>
  <ul>
    <li>O sistema bloqueia o <a href="https://developer.mozilla.org/en-US/docs/Security/MixedContent" class="external-link">contedo misto</a> e cookies de terceiros por padro. Para permitir contedo misto e cookies de terceiros, use os mtodos {@link android.webkit.WebSettings#setMixedContentMode(int) setMixedContentMode()} e {@link android.webkit.CookieManager#setAcceptThirdPartyCookies(android.webkit.WebView, boolean) setAcceptThirdPartyCookies()} respectivamente.</li>
    <li>O sistema agora escolhe de modo inteligente as partes do documento HTML que sero desenhadas. Esse novo comportamento padro ajuda a reduzir a rea ocupada na memria e aumenta o desempenho. Se voc quiser processar o documento inteiro de uma s vez, desative essa otimizao chamando {@link android.webkit.WebView#enableSlowWholeDocumentDraw()}.</li>
  </ul>
</li>
<li><strong>Caso seu app segmente nveis de API inferiores a 21:</strong> o sistema permite contedo misto e cookies de terceiros, alm de sempre processar o documento inteiro de uma vez.</li>
</ul>

<h2 id="UI">Interface do usurio</h2>

<h3 id="MaterialDesign">Suporte ao material design</h3>

<p>O lanamento futuro adiciona o suporte ao novo estilo do <em>material design</em> do Android.  possvel criar apps com material design que  visualmente dinmico e tem transies de elemento de interface do usurio que parecem naturais para os usurios. Esse suporte inclui:</p>

<ul>

  <li>O tema do material</li>
  <li>Visualizao de sombras</li>
  <li>O widget {@link android.support.v7.widget.RecyclerView}</li>
  <li>Animao drawable e efeitos de estilo</li>
  <li>Animao de material design e efeitos de transio de atividade</li>
  <li>Animadores para propriedades de visualizao com base no estado da visualizao</li>
  <li>Elementos personalizveis da interface do usurio e barras de app com paletas de cores controladas por voc</li>
  <li>Drawables animados e no animados com base nos grficos de vetor XML</li>
</ul>

<p>Para saber mais sobre como adicionar a funcionalidade de material design ao seu app, consulte <a href="{@docRoot}training/material/index.html">Material design</a>.</p>

<h3 id="Recents">Documentos simultneos e atividades na tela de recentes</h3>

<p>Em verses anteriores, a <a href="{@docRoot}guide/components/recents.html">tela de recentes</a> podia exibir somente uma tarefa para cada app com o qual o usurio tivesse interagido mais recentemente. Agora seu app pode abrir mais tarefas conforme necessrio para outras atividades simultneas para documentos. Esse recurso facilita fazer muitas tarefas ao mesmo tempo ao permitir que os usurios alternem rapidamente entre atividades individuais e documentos da tela de recentes, com uma experincia consistente de alternao entre todos os apps. Exemplos de tarefas simultneas podem incluir guias abertas em um app para navegadores da Web, documentos em um app de produtividade, partidas simultneas em um jogo ou bate-papos em um app de mensagens. O app pode gerenciar tarefas por meio da classe {@link android.app.ActivityManager.AppTask}.</p>

<p>Para inserir uma interrupo lgica para que o sistema trate suas atividades como uma nova tarefa, use {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} ao iniciar a atividade com {@link android.app.Activity#startActivity(android.content.Intent) startActivity()}. Tambm  possvel ter esse comportamento definindo o atributo do elemento <a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a>{@code documentLaunchMode} como {@code "intoExisting"} ou {@code "always"} no seu manifesto.</p>

<p>Para evitar que a tela de recentes fique bagunada, defina o nmero mximo de tarefas do seu app que podem aparecer na tela. Para fazer isso, defina o atributo <a href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a> {@link android.R.attr#maxRecents android:maxRecents}. O mximo que pode ser especificado atualmente  50 tarefas por usurio (25 para dispositivos com pouca RAM).</a></p>

<p>As tarefas na tela de recentes podem ser definidas para persistirem em reinicializaes. Para controlar o comportamento de persistncia, use o atributo <a href="{@docRoot}reference/android/R.attr.html#persistableMode">android:persistableMode</a>. Tambm  possvel alterar as propriedades visuais de uma atividade na tela de recentes, como o rtulo, o cone e a cor da atividade, chamando o mtodo {@link android.app.Activity#setTaskDescription(android.app.ActivityManager.TaskDescription) setTaskDescription()}.</p>

<h3 id="WebView">Atualizaes de WebView</h3>
<p>O Android 5.0 atualiza a implementao de {@link android.webkit.WebView} para o Chromium M37, com aprimoramentos de segurana e estabilidade, bem como correes de bugs. A string de user-agent padro para um {@link android.webkit.WebView} executando no Android 5.0 foi atualizada para incorporar 37.0.0.0 como o nmero de verso.</p>

<p>Essa verso apresenta a classe {@link android.webkit.PermissionRequest}, que permite ao seu app conceder a {@link android.webkit.WebView} permisso para acessar recursos protegidos, como a cmera e o microfone, por meio de APIs da Web, como <a href="https://developer.mozilla.org/en-US/docs/NavigatorUserMedia.getUserMedia" class="external-link">getUserMedia()</a>. Seu app precisa ter as permisses de Android apropriadas para esses recursos a fim de conceder as permisses para {@link android.webkit.WebView}.</p>

<p>Com o novo mtodo <code><a href="{@docRoot}reference/android/webkit/WebChromeClient.html#onShowFileChooser(android.webkit.WebView, android.webkit.ValueCallback<android.net.Uri[]>, android.webkit.WebChromeClient.FileChooserParams)">onShowFileChooser()</a></code>,  possvel usar um campo de formulrio de entrada em {@link android.webkit.WebView} e iniciar um seletor de arquivos para selecionar imagens e arquivos do dispositivo Android.</p>

<p>Alm disso, essa verso oferece suporte aos padres abertos de <a href="http://webaudio.github.io/web-audio-api/" class="external-link">WebAudio</a>, <a href="https://www.khronos.org/webgl/" class="external-link">WebGL</a> e <a href="http://www.webrtc.org/" class="external-link">WebRTC</a>. Para saber mais sobre os novos recursos includos nessa verso, consulte <a href="https://developer.chrome.com/multidevice/webview/overview" class="external-link">WebView para Android</a>.</p>

<h3 id="ScreenCapture">Compartilhamento e captura de tela</h3>
<p>O Android 5.0 permite adicionar as funcionalidades de compartilhamento e captura de tela ao seu app com as novas APIs de {@link android.media.projection}. Essa funcionalidade  til, por exemplo, se voc desejar ativar o compartilhamento de tela em um app de conferncia de vdeo.</p>

<p>O novo mtodo {@link android.media.projection.MediaProjection#createVirtualDisplay(java.lang.String, int, int, int, int, android.view.Surface, android.hardware.display.VirtualDisplay.Callback, android.os.Handler) createVirtualDisplay()} permite ao seu app capturar o contedo da tela principal (a exibio padro) em um objeto {@link android.view.Surface}, que seu app pode enviar pela rede. A API permite capturar o contedo somente de telas no protegidas, e no captura udio do sistema. Para comear a captura de tela, o app precisa solicitar a permisso do usurio iniciando uma caixa de dilogo de captura de tela usando um {@link android.content.Intent} obtido por meio do mtodo {@link android.media.projection.MediaProjectionManager#createScreenCaptureIntent()}.</p>

<p>Para ver um exemplo de como usar as novas APIs, consulte a classe {@code MediaProjectionDemo} no projeto de amostra.</p>

<h2 id="Notifications">Notificaes</h2>

<h3 id="LockscreenNotifications">Notificaes na tela bloqueada</h3>
<p>As telas de bloqueio no Android 5.0 tm a capacidade de mostrar as notificaes. Os usurios podem optar por meio das <em>Configuraes</em> para permitir que contedo de notificao confidencial seja exibido em uma tela de bloqueio protegida.</p>

<p>O app pode controlar o nvel de detalhe visvel quando as notificaes so exibidas na tela de bloqueio segura. Para controlar o nvel de visibilidade, chame {@link android.app.Notification.Builder#setVisibility(int) setVisibility()} e especifique um dos seguintes valores:</p>

<ul>
<li>{@link android.app.Notification#VISIBILITY_PRIVATE VISIBILITY_PRIVATE}: exibe informaes bsicas, como o cone da notificao, mas oculta o contedo integral da notificao.</li>
<li>{@link android.app.Notification#VISIBILITY_PUBLIC VISIBILITY_PUBLIC}: mostra o contedo integral da notificao.</li>
<li>{@link android.app.Notification#VISIBILITY_SECRET VISIBILITY_SECRET}: mostra nada, exclui at o cone de notificao.</li>
</ul>

<p>Quando o nvel de visibilidade  {@link android.app.Notification#VISIBILITY_PRIVATE VISIBILITY_PRIVATE},  possvel fornecer uma verso redigida do contedo da notificao que oculta detalhes pessoais. Por exemplo, um app de mensagens SMS pode exibir uma notificao que mostra "Voc tem trs novas mensagens de texto", mas oculta o contedo da mensagem e os remetentes. Para fornecer essa notificao alternativa, crie primeiro a notificao de substituio usando {@link android.app.Notification.Builder}. Quando voc criar o objeto de notificao privada, anexe a notificao de substituio a ele por meio do mtodo {@link android.app.Notification.Builder#setPublicVersion(android.app.Notification) setPublicVersion()}.</p>

<h3 id="NotificationsMetadata">Metadados de notificaes</h3>
<p>O Android 5.0 usa os metadados associados com as notificaes do seu app para classific-las de modo mais inteligente. Para definir os metadados, chame os mtodos a seguir em {@link android.app.Notification.Builder} ao criar a notificao:</p>

<ul>
<li>{@link android.app.Notification.Builder#setCategory(java.lang.String) setCategory()}: informa ao sistema como lidar com as notificaes do app quando o dispositivo estiver no modo de <em>prioridade</em>. Por exemplo, se uma notificao representar uma chamada de entrada, uma chamada instantnea ou um alarme.
<li>{@link android.app.Notification.Builder#setPriority(int) setPriority()}: marca a notificao como mais ou menos importante do que as notificaes normais. Notificaes com o campo de prioridade definido como {@link android.app.Notification#PRIORITY_MAX PRIORITY_MAX} ou {@link android.app.Notification#PRIORITY_HIGH PRIORITY_HIGH} aparecem em uma pequena janela flutuante se a notificao tambm tem som ou vibrao.</li>
<li>{@link android.app.Notification.Builder#addPerson(java.lang.String) addPerson()}: permite adicionar uma ou mais pessoas que so relevantes para a notificao. O app pode usar isso para sinalizar para o sistema que ele deve agrupar notificaes das pessoas especificadas ou classificar as notificaes dessas pessoas como sendo mais importantes.</li>
</ul>

<h2 id="Graphics">Grficos</h2>

<h3 id="OpenGLES-3-1">Suporte para OpenGL ES 3.1 </h3>
<p>O Android 5.0 adiciona o suporte nativo ao OpenGL ES 3.1 e interfaces Java. As novas e importantes funcionalidades fornecidas no OpenGL ES 3.1 incluem:</p>

<ul>
<li>Sombreadores de clculo
<li>Objetos sombreadores separados
<li>Comandos draw indiretos
<li>Texturas de estncil e multiamostras
<li>Aprimoramentos na linguagem de sombreamento
<li>Extenses para os modos de mesclagem avanada e depurao
<li>Compatibilidade de verses mais antigas com OpenGL ES 2.0 e 3.0
</ul>

<p>A interface Java para o OpenGL ES 3.1 no Android  fornecida com {@link android.opengl.GLES31}. Ao usar o OpenGL ES 3.1, declare isso em seu arquivo de manifesto junto com a tag <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code <uses-feature>}</a> e o atributo {@code android:glEsVersion}. Por exemplo:</p>

<pre>
&lt;manifest&gt;
    &lt;uses-feature android:glEsVersion="0x00030001" /&gt;
    ...
&lt;/manifest&gt;
</pre>

<p>Para mais informaes sobre como usar o OpenGL ES, inclusive como verificar a verso do OpenGL ES compatvel do dispositivo no tempo de execuo, consulte o <a href="{@docRoot}guide/topics/graphics/opengl.html">Guia da OpenGL ES API</a>.</p>

<h3 id="AndroidExtensionPack">Pacote de extenses para Android</h3>

<p>Alm do OpenGL ES 3.1, essa verso fornece um pacote de extenses com interfaces Java e suporte nativo para a funcionalidade de grfico avanado. Essas extenses so tratadas como um nico pacote pelo Android. Se a extenso {@code ANDROID_extension_pack_es31a} estiver presente, seu app poder presumir que todas as extenses no pacote esto presentes e ativar os recursos de linguagem de sombreamento com uma nica instruo {@code #extension}.</p>

<p>O pacote de extenses oferece suporte a:</p>

<ul>
<li>Suporte garantido ao sombreador de fragmentos para buffers de armazenamento de sombreador, imagens e atomics (o suporte ao sombreador de fragmento  opcional no OpenGL ES 3.1.)</li>
<li>Sombreadores de geometria e mosaico</li>
<li>Formato de compactao de textura ASTC (LDR)</li>
<li>Sombreamento e interpolao por amostra</li>
<li>Modos diferentes de mesclagem para cada anexo colorido em um buffer de frame</li>
</ul>

<p>A interface Java para o pacote de extenses  fornecido com {@link android.opengl.GLES31Ext}. No manifesto do app,  possvel declarar que o app precisa ser instalado somente em dispositivos que oferecem suporte ao pacote de extenses. Por exemplo:</p>

<pre>
&lt;manifest&gt;
    &lt;uses-feature android:name=android.hardware.opengles.aep
        android:required="true" /&gt;
    ...
&lt;/manifest&gt;
</pre>

<h2 id="Media">Mdia</h2>

<h3 id="Camera-v2">Camera API para funcionalidades avanadas da cmera</h3>

<p>O Android 5.0 apresenta a nova <a href="{@docRoot}reference/android/hardware/camera2/package-summary.html">android.hardware.camera2</a> API para facilitar o processamento de imagens e a captura de fotos com granulao baixa. Agora  possvel acessar de maneira programtica os dispositivos da cmera disponveis para o sistema com {@link android.hardware.camera2.CameraManager#getCameraIdList() getCameraIdList()} e conectar um determinado dispositivo com {@link android.hardware.camera2.CameraManager#openCamera(java.lang.String, android.hardware.camera2.CameraDevice.StateCallback, android.os.Handler) openCamera()}. Para comear a capturar imagens, crie um {@link android.hardware.camera2.CameraCaptureSession} e especifique os objetos {@link android.view.Surface} para enviar imagens capturadas. O {@link android.hardware.camera2.CameraCaptureSession} pode ser configurado para tirar uma nica foto ou vrias imagens em uma sequncia.</p>

<p>Para ser notificado quando novas imagens so capturadas, implemente o listener {@link android.hardware.camera2.CameraCaptureSession.CaptureCallback} e defina-o na solicitao de captura. Agora quando o sistema conclui a solicitao de captura de imagem, seu listener {@link android.hardware.camera2.CameraCaptureSession.CaptureCallback} recebe uma chamada a {@link android.hardware.camera2.CameraCaptureSession.CaptureCallback#onCaptureCompleted(android.hardware.camera2.CameraCaptureSession, android.hardware.camera2.CaptureRequest, android.hardware.camera2.TotalCaptureResult) onCaptureCompleted()}, fornecendo a voc os metadados da captura de imagem em um {@link android.hardware.camera2.CaptureResult}.</p>

<p>A classe {@link android.hardware.camera2.CameraCharacteristics} permite que seu app detecte quais recursos de cmera esto disponveis em um dispositivo. A propriedade {@link android.hardware.camera2.CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL INFO_SUPPORTED_HARDWARE_LEVEL} do objeto representa o nvel de funcionalidade da cmera.</p>

<ul>
  <li>Todos os dispositivos oferecem suporte pelo menos ao nvel de hardware {@link android.hardware.camera2.CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY}, que tem recursos aproximadamente equivalentes aos da {@link android.hardware.Camera} API que teve seu uso suspenso.</li>
  <li>Os dispositivos que oferecem suporte ao nvel de hardware de {@link android.hardware.camera2.CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL INFO_SUPPORTED_HARDWARE_LEVEL_FULL} so capazes de controlar manualmente a captura e o ps-processamento, alm de capturar imagens em alta-resoluo em altas taxas de frame.</li>
</ul>

<p>Para ver como usar a <a href="{@docRoot}reference/android/hardware/camera2/package-summary.html">Camera</a> API atualizada, consulte as amostras de implementao de {@code Camera2Basic} e {@code Camera2Video} nessa verso.</p>

<h3 id="AudioPlayback">Reproduo de udio</h3>
<p>Essa verso inclui as seguintes alteraes em {@link android.media.AudioTrack}:</p>
<ul>
  <li>Seu app agora pode fornecer dados de udio no formato ponto flutuante ({@link android.media.AudioFormat#ENCODING_PCM_FLOAT ENCODING_PCM_FLOAT}). Isso permite uma maior escala dinmica, uma preciso mais consistente e mais espao. A aritmtica de ponto flutuante  til durante os clculos intermedirios. Os pontos de extremidade da reproduo usam o formato inteiro para dados de udio e com profundidade de bits inferior. No Android 5.0, as partes do fluxo interno ainda no so ponto flutuante.
  <li>Seu app agora pode fornecer dados de udio como um {@link java.nio.ByteBuffer} no mesmo formato fornecido por {@link android.media.MediaCodec}.
  <li>A opo {@link android.media.AudioTrack#WRITE_NON_BLOCKING WRITE_NON_BLOCKING} pode simplificar o armazenamento em buffer e multithreading de alguns apps.
</ul>

<h3 id="MediaPlaybackControl">Controle de reproduo de mdia</h3>
<p>Use a nova notificao e APIs de mdia para garantir que a interface do usurio do sistema saiba da sua reproduo de mdia e possa extrair e mostrar a capa do lbum. Controlar a reproduo de mdia em uma interface do usurio agora  mais fcil com as novas classes {@link android.media.session.MediaSession} e {@link android.media.session.MediaController}.</p>

<p>A nova classe {@link android.media.session.MediaSession} substitui a classe {@link android.media.RemoteControlClient} que teve seu uso suspenso e fornece um nico conjunto de mtodos de chamada de retorno para gerenciar os controles de transporte e os botes de mdia. Se o app fornecer a reproduo de mdia e for executado na plataforma Android <a href="{@docRoot}tv/index.html">TV</a> ou <a href="{@docRoot}wear/index.html">Android Wear</a>, use a classe {@link android.media.session.MediaSession} para lidar com os controles de transporte usando os mesmos mtodos de chamada de retorno.</p>

<p> possvel criar seu prprio app controlador de mdia com a nova classe {@link android.media.session.MediaController}. Essa classe oferece uma maneira de thread seguro para monitorar e controlar a reproduo de mdia do processo de interface do seu app. Ao criar um controlador, especifique um objeto {@link android.media.session.MediaSession.Token} para que seu app possa interagir com o {@link android.media.session.MediaSession} determinado. Usando os mtodos {@link android.media.session.MediaController.TransportControls},  possvel enviar comandos como {@link android.media.session.MediaController.TransportControls#play() play()}, {@link android.media.session.MediaController.TransportControls#stop() stop()}, {@link android.media.session.MediaController.TransportControls#skipToNext() skipToNext()} e {@link android.media.session.MediaController.TransportControls#setRating(android.media.Rating) setRating()} para controlar a reproduo de mdia nessa sesso. Com o controlador, tambm  possvel registrar um objeto {@link android.media.session.MediaController.Callback} para escutar os metadados e mudanas de estado da sesso.</p>

<p>Alm disso,  possvel criar notificaes ricas que permitem o controle de reproduo ligado a uma sesso de mdia com a nova classe {@link android.app.Notification.MediaStyle}.</p>

<h3 id="MediaBrowsing">Navegao de mdia</h3>
<p>O Android 5.0 apresenta a capacidade dos apps de procurar a biblioteca de contedo de mdia de outro app por meio da nova <a href="{@docRoot}reference/android/media/browse/package-summary.html">android.media.browse</a> API. Para expor o contedo de mdia no seu app, estenda a classe {@link android.service.media.MediaBrowserService}. Sua implementao de {@link android.service.media.MediaBrowserService} deve fornecer acesso a um {@link android.media.session.MediaSession.Token} para que apps possam reproduzir contedo de mdia fornecido por meio do seu servio.</p>
<p>Para interagir com o servio de navegador de mdia, use a classe {@link android.media.browse.MediaBrowser}. Especifique o nome do componente para um {@link android.media.session.MediaSession} ao criar uma instncia {@link android.media.browse.MediaBrowser}. Usando essa instncia do navegador, seu app pode se conectar ao servio associado e obter um objeto {@link android.media.session.MediaSession.Token} para reproduzir contedo exposto por meio do servio.</p>

<h2 id="Storage">Armazenamento</h2>

<h3 id="DirectorySelection">Seleo do diretrio</h3>

<p>O Android 5.0 estende a <a href="{@docRoot}guide/topics/providers/document-provider.html">Estrutura de acesso ao armazenamento</a> para permitir que os usurios selecionem uma subrvore inteira de diretrio, fornecendo aos apps o acesso de leitura/gravao a todos os documentos existentes sem exigir confirmao do usurio para cada item.</p>

<p>Para selecionar uma subrvore de diretrio, crie e envie um propsito {@link android.content.Intent#ACTION_OPEN_DOCUMENT_TREE OPEN_DOCUMENT_TREE}. O sistema exibe todas as instncias {@link android.provider.DocumentsProvider} que oferecem suporte  seleo de subrvore, permitindo que o usurio procure e selecione um diretrio. O URI retornado representa o acesso  subrvore selecionada.  possvel usar {@link android.provider.DocumentsContract#buildChildDocumentsUriUsingTree(android.net.Uri, java.lang.String) buildChildDocumentsUriUsingTree()} e {@link android.provider.DocumentsContract#buildDocumentUriUsingTree(android.net.Uri, java.lang.String) buildDocumentUriUsingTree()} juntamente com {@link android.content.ContentResolver#query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String) query()} para explorar a subrvore.</p>

<p>O novo mtodo {@link android.provider.DocumentsContract#createDocument(android.content.ContentResolver, android.net.Uri, java.lang.String, java.lang.String) createDocument()} permite criar novos documentos ou diretrios em qualquer lugar abaixo da subrvore. Para gerenciar documentos existentes, use {@link android.provider.DocumentsContract#renameDocument(android.content.ContentResolver, android.net.Uri, java.lang.String) renameDocument()} e {@link android.provider.DocumentsProvider#deleteDocument(java.lang.String) deleteDocument()}. Confira o {@link android.provider.DocumentsContract.Document#COLUMN_FLAGS COLUMN_FLAGS} para verificar o suporte do provedor para essas chamadas antes de emiti-las.</p>

<p>Se voc estiver implementando um {@link android.provider.DocumentsProvider} e desejar oferecer suporte  seleo de subrvore, implemente {@link android.provider.DocumentsProvider#isChildDocument(java.lang.String, java.lang.String) isChildDocument()} e inclua {@link android.provider.DocumentsContract.Root#FLAG_SUPPORTS_IS_CHILD FLAG_SUPPORTS_IS_CHILD} em {@link android.provider.DocumentsContract.Root#COLUMN_FLAGS COLUMN_FLAGS}.</p>

<p>O Android 5.0 tambm apresenta novos diretrios especficos ao pacote no armazenamento compartilhado no qual o app pode colocar arquivos de mdia para incluso em {@link android.provider.MediaStore}. O novo {@link android.content.Context#getExternalMediaDirs()} retorna caminhos para esses diretrios em todos os dispositivos de armazenamento compartilhado. De forma semelhante a {@link android.content.Context#getExternalFilesDir(java.lang.String) getExternalFilesDir()}, permisses adicionais no so necessrias para que o app acesse os caminhos retornados. A plataforma periodicamente verifica novas mdias nesses diretrios, mas tambm  possvel usar o {@link android.media.MediaScannerConnection} para verificar explicitamente se h novo contedo.</p>

<h2 id="Wireless">Conectividade e sem fio</h2>

<h3 id="Multinetwork">Vrias conexes de rede</h3>
<p>O Android 5.0 apresenta novas APIs de vrias redes que permitem ao seu app verificar dinamicamente as redes disponveis com recursos especficos, alm de estabelecer uma conexo com eles. Essa funcionalidade  til quando seu app exigir uma rede especializada, como SUPL, MMS ou uma rede de faturamento via operadora. Outro caso de uso  se voc desejar enviar os dados usando um determinado tipo de protocolo de transporte.</p>

<p>Para selecionar e se conectar a uma rede dinamicamente a partir do seu app, siga estas etapas:</p>

<ol>
 <li>Crie um {@link android.net.ConnectivityManager}.</li>
 <li>Use a classe {@link android.net.NetworkRequest.Builder} para criar um objeto {@link android.net.NetworkRequest} e especificar os recursos de rede e o tipo de transporte nos quais seu app est interessado.</li>
<li>Para buscar redes adequadas, chame {@link android.net.ConnectivityManager#requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) requestNetwork()} ou {@link android.net.ConnectivityManager#registerNetworkCallback(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) registerNetworkCallback()} e passe o objeto {@link android.net.NetworkRequest} e uma implementao de {@link android.net.ConnectivityManager.NetworkCallback}. Use o mtodo {@link android.net.ConnectivityManager#requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) requestNetwork()} se voc quiser alternar para uma rede adequada aps ela ser detectada. Para receber notificaes somente de redes verificadas sem alternar ativamente, use o mtodo {@link android.net.ConnectivityManager#registerNetworkCallback(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback) registerNetworkCallback()}.</li>
</ol>

<p>Quando o sistema detectar uma rede adequada, ele se conectar  rede e chamar a chamada de retorno {@link android.net.ConnectivityManager.NetworkCallback#onAvailable(android.net.Network) onAvailable()}.  possvel usar o objeto {@link android.net.Network} da chamada de retorno a fim de receber mais informaes sobre a rede ou direcionar o trfego para que a rede selecionada seja usada.</p>

<h3 id="BluetoothBroadcasting">Bluetooth Low Energy</h3>
<p>O Android 4.3 apresentou o suporte de plataforma para o <a href="{@docRoot}guide/topics/connectivity/bluetooth-le.html">Bluetooth Low Energy</a>(<em>Bluetooth LE</em>) na funo central. No Android 5.0, um dispositivo Android agora pode agir como um <em>dispositivo perifrico</em> de Bluetooth LE. Os apps podem usar esse recurso para fazer com que sua presena seja percebida pelos dispositivos vizinhos.  possvel, por exemplo, criar apps que permitem que um dispositivo funcione como um pedmetro ou um monitor de integridade de dados e envie seus dados para outro dispositivo Bluetooth LE.</p>
<p>As novas APIs de {@link android.bluetooth.le} permitem que seus apps divulguem anncios, verifiquem respostas e formem conexes com dispositivos Bluetooth LE vizinhos. Para usar os novos recursos de publicidade e varredura, adicione a permisso {@link android.Manifest.permission#BLUETOOTH_ADMIN BLUETOOTH_ADMIN} no manifesto. Quando os usurios atualizam ou fazem o download do seu app a partir da Play Store, eles so solicitados a conceder a seguinte permisso para seu app: "Informaes da conexo Bluetooth: permite que o app controle o Bluetooth, incluindo a divulgao para dispositivos Bluetooth vizinhos ou a busca de informaes sobre esses dispositivos."</p>

<p>Para comear a publicidade de Bluetooth LE para que outros dispositivos possam descobrir seu app, chame {@link android.bluetooth.le.BluetoothLeAdvertiser#startAdvertising(android.bluetooth.le.AdvertiseSettings, android.bluetooth.le.AdvertiseData, android.bluetooth.le.AdvertiseCallback) startAdvertising()} e passe uma implementao da classe {@link android.bluetooth.le.AdvertiseCallback}. O objeto de chamada de retorno recebe um relatrio do sucesso ou da falha da operao de publicidade.</p>

<p> O Android 5.0 apresenta a classe {@link android.bluetooth.le.ScanFilter} para que seu app possa buscar somente os tipos especficos de dispositivos nos quais est interessado. Para iniciar a busca de dispositivos Bluetooth LE, chame {@link android.bluetooth.le.BluetoothLeScanner#startScan(android.bluetooth.le.ScanCallback) startScan()} e passe uma lista de filtros. Na chamada de mtodo, voc precisa fornecer tambm uma implementao de {@link android.bluetooth.le.ScanCallback} para informar quando uma publicidade de Bluetooth LE for encontrada. </p>

<h3 id="NFCEnhancements">Aprimoramentos na NFC</h3>
<p>O Android 5.0 adiciona estas melhorias para permitir um uso mais amplo e flexvel da NFC:</p>

<ul>
<li>O Android Beam agora est disponvel no menu <em>Compartilhar</em>.</li>
<li>Seu app pode chamar o Android Beam no dispositivo do usurio para compartilhar dados chamando {@link android.nfc.NfcAdapter#invokeBeam(android.app.Activity) invokeBeam()}. Isso evita a necessidade de o usurio manualmente tocar no dispositivo em relao a outro com capacidade para NFC a fim de concluir a transferncia de dados.</li>
<li> possvel usar o novo mtodo {@link android.nfc.NdefRecord#createTextRecord(java.lang.String, java.lang.String) createTextRecord()} para criar um registro NDEF contendo dados de texto UTF-8.</li>
<li>Se voc estiver desenvolvendo um app de pagamentos, voc agora tem a capacidade de registrar um cdigo de app da NFC (AID, na sigla em ingls) dinamicamente chamando <code><a href="{@docRoot}reference/android/nfc/cardemulation/CardEmulation.html#registerAidsForService(android.content.ComponentName, java.lang.String, java.util.List<java.lang.String>)">registerAidsForService()</a></code>. Tambm  possvel usar {@link android.nfc.cardemulation.CardEmulation#setPreferredService(android.app.Activity, android.content.ComponentName) setPreferredService()} para definir o servio de emulao de carto preferencial que deve ser usado quando uma atividade especfica estiver em primeiro plano.</li>
</ul>

<h2 id="Power">Project Volta</h2>

<p>Alm de novos recursos, o Android 5.0 enfatiza melhorias na vida til da bateria. Use as novas APIs e a ferramenta para compreender e otimizar o consumo de energia de seu app.</p>

<h3 id="JobScheduler">Agendamento de tarefas</h3>
<p>O Android 5.0 apresenta uma nova {@link android.app.job.JobScheduler} API que permite otimizar a vida til da bateria definindo as tarefas para que o sistema execute de maneira assncrona em um momento posterior ou sob condies especificadas (como quando o dispositivo est carregando). O agendamento de tarefa  til em situaes como:</p>
<ul>
  <li>O app no tem trabalho que no ser visto pelo usurio, por isso  possvel adi-lo.</li>
  <li>O app tem trabalho que voc prefere fazer quando a unidade estiver ligada na tomada.</li>
  <li>O app tem uma tarefa que requer acesso  rede ou uma conexo Wi-Fi.</li>
  <li>O app tem uma srie de tarefas que voc deseja gerar como um lote em um agendamento regular.</li>

</ul>

<p>Uma unidade de trabalho est encapsulada por um objeto {@link android.app.job.JobInfo}. Esse objeto especifica os critrios de agendamento.</p>

<p>Use a classe {@link android.app.job.JobInfo.Builder} para configurar como a tarefa agendada deve ser executada.  possvel agendar a tarefa para ser executada em condies especficas, como:</p>

<ul>
  <li>Iniciar quando o dispositivo estiver carregando</li>
  <li>Iniciar quando o dispositivo estiver conectado a uma rede no medida</li>
  <li>Iniciar quando o dispositivo estiver ocioso</li>
  <li>Terminar antes de um determinado prazo ou com o mnimo de atraso</li>
</ul>

<p>Por exemplo,  possvel adicionar cdigo como este para executar a tarefa em uma rede no medida:</p>

<pre>
JobInfo uploadTask = new JobInfo.Builder(mJobId,
                                         mServiceComponent /* JobService component */)
        .setRequiredNetworkCapabilities(JobInfo.NetworkType.UNMETERED)
        .build();
JobScheduler jobScheduler =
        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
jobScheduler.schedule(uploadTask);
</pre>

<p>Se o dispositivo tiver energia estvel (ou seja, se ele estiver conectado por mais de dois minutos e a bateria estiver em um <a href="{@docRoot}reference/android/content/Intent.html#ACTION_BATTERY_OKAY">nvel de integridade</a>), o sistema executar a tarefa agendada que estiver pronta para execuo, mesmo se o prazo dela no tiver expirado.</p>

<p>Para ver um exemplo de como usar a {@link android.app.job.JobScheduler}API, consulte a amostra de implementao de {@code JobSchedulerSample} nesta verso.</p>

<h3 id="PowerMeasurementTools">Ferramentas do desenvolvedor para uso da bateria</h3>

<p>O novo comando {@code dumpsys batterystats} gera dados estatsticos interessantes sobre o uso da bateria em um dispositivo, organizados pelo cdigo nico do usurio (UID, na sigla em ingls). As estatsticas incluem:</p>

<ul>
<li>Histrico de eventos relacionados  bateria
<li>Estatsticas globais para o dispositivo
<li>Uso de energia aproximado por UID e o componente do sistema
<li>Dispositivo mvel por app ms por pacote
<li>Estatsticas agregadas de UID do sistema
<li>Estatsticas agregadas de UID do app
</ul>

<p>Use a opo {@code --help} para saber mais sobre as diversas opes para adequar a sada. Por exemplo, para imprimir estatsticas de uso da bateria de um determinado pacote de apps desde que o dispositivo foi carregado pela ltima vez, execute este comando:
<pre>
$ adb shell dumpsys batterystats --charged &lt;package-name&gt;
</pre>

<p> possvel usar a ferramenta <a href="https://github.com/google/battery-historian" class="external-link">Battery Historian</a> na sada do comando {@code dumpsys} para gerar uma visualizao de HTML de eventos relacionados  energia dos registros. Essa informao facilita para voc entender e diagnosticar problemas relacionados  bateria.</p>

<h2 id="Enterprise">Android no local de trabalho e na educao</h2>
<h3 id="ManagedProvisioning">Provisionamento gerenciado</h3>

<p>O Android 5.0 apresenta a nova funcionalidade para a execuo de apps em um ambiente corporativo. Um <a href="{@docRoot}guide/topics/admin/device-admin.html">administrador de dispositivo</a> pode iniciar um processo de provisionamento gerenciado para adicionar um <em>perfil gerenciado</em> copresente, mas separado, a um dispositivo se o usurio tiver uma conta pessoal existente. Os apps que esto associados aos perfis gerenciados so exibidos junto a apps no gerenciados no inicializador do usurio, na tela de recentes e nas notificaes.</p>

<p>Para iniciar o processo de provisionamento gerenciado, envie {@link android.app.admin.DevicePolicyManager#ACTION_PROVISION_MANAGED_PROFILE ACTION_PROVISION_MANAGED_PROFILE} em um {@link android.content.Intent}. Se a chamada ocorrer, o sistema acionar a chamada de retorno {@link android.app.admin.DeviceAdminReceiver#onProfileProvisioningComplete(android.content.Context, android.content.Intent) onProfileProvisioningComplete()}. Ser possvel ento chamar {@link android.app.admin.DevicePolicyManager#setProfileEnabled(android.content.ComponentName) setProfileEnabled()} para ativar esse perfil gerenciado.</p>

<p>Por padro, somente um pequeno subconjunto de apps so ativados no perfil gerenciado.  possvel instalar mais apps no perfil gerenciado chamando {@link android.app.admin.DevicePolicyManager#enableSystemApp(android.content.ComponentName, android.content.Intent) enableSystemApp()}.</p>

<p>Se voc estiver desenvolvendo um app inicializador, ser possvel usar a nova classe {@link android.content.pm.LauncherApps} para ter uma lista das atividades inicializveis do usurio atual e de quaisquer perfis gerenciados associados. O inicializador pode destacar visualmente os apps gerenciados acrescentando um selo de trabalho ao drawable do cone. Para recuperar o cone com selo, chame {@link android.content.pm.PackageManager#getUserBadgedIcon(android.graphics.drawable.Drawable, android.os.UserHandle) getUserBadgedIcon()}.</p>

<p>Para saber como usar a nova funcionalidade, consulte a amostra de implementao de {@code BasicManagedProfile} nesta verso.</p>

<h3 id="DeviceOwner">Proprietrio do dispositivo</h3>
<p>O Android 5.0 apresenta a capacidade de implantar um app do proprietrio do dispositivo. O <em>proprietrio do dispositivo</em>  um tipo especializado de <a href="{@docRoot}guide/topics/admin/device-admin.html">administrador de dispositivo</a> que tem a capacidade adicional de criar e remover usurios secundrios, bem como definir configuraes globais no dispositivo. Seu app de proprietrio do dispositivo pode usar os mtodos na classe {@link android.app.admin.DevicePolicyManager} para tirar o controle de granulao da configurao, da segurana e dos apps em dispositivos gerenciados. Um dispositivo pode ter somente um proprietrio ativo de cada vez.</p>

<p>Para implantar e ativar um proprietrio do dispositivo, voc precisa realizar uma transferncia de dados de NFC de um app de programao para o dispositivo enquanto o dispositivo estiver em seu estado no provisionado. Essa transferncia de dados envia as mesmas informaes presentes no propsito de provisionamento descrito no <a href="#ManagedProvisioning">Provisionamento gerenciado</a>.</p>

<h3 id="ScreenPinning">Fixao de tela</h3>

<p>O Android 5.0 apresenta uma nova API de fixao de tela que permite restringir temporariamente a sada dos usurios de sua tarefa ou que eles sejam interrompidos por notificaes. Isso pode ser usado, por exemplo, se voc desenvolve um app educacional compatvel com requisitos de avaliao de alto risco no Android ou em um app de quiosque com um nico objetivo. Depois que o app ativar a fixao de tela, os usurios no podem ver as notificaes, acessar outros apps ou retornar para a tela inicial do app at sarem do modo.</p>

<p>Existem duas maneiras de ativar a fixao de tela:</p>

<ul>
<li><strong>Manualmente:</strong> os usurios podem ativar a fixao de tela em <em>Configuraes &gt; Segurana &gt; Fixao de tela </em> e selecionar as tarefas que desejam fixar tocando no cone de fixao verde na tela de recentes.</li> <li><strong>De maneira programtica: </strong>para ativar a fixao de tela de maneira programtica, chame {@link android.app.Activity#startLockTask() startLockTask()} a partir do seu app. Se o app solicitante no for um proprietrio do dispositivo, o usurio ser solicitado a confirmar. Um app de proprietrio do dispositivo pode chamar o mtodo {@link android.app.admin.DevicePolicyManager#setLockTaskPackages(android.content.ComponentName, java.lang.String[]) setLockTaskPackages()} para ativar a opo para que os apps possam ser fixados sem a etapa de confirmao do usurio.</li>
</ul>

<p>Quando o bloqueio de tarefa estiver ativo, o seguinte comportamento ocorre:</p>

<ul>
<li>A barra de status est em branco e as notificaes do usurio e as informaes de status esto ocultas.</li>
<li>Os botes "Incio" e "Recentes" esto ocultos.</li>
<li>Outros apps no podem lanar novas atividades.</li>
<li>O app atual pode iniciar novas atividades, contanto que no crie novas tarefas.</li>
<li>Quando o recurso de fixao de tela  chamado por um proprietrio do dispositivo, o usurio permanece bloqueado para seu app, at que o app chame {@link android.app.Activity#stopLockTask() stopLockTask()}.</li>
<li>Se a fixao de tela  a atividade executada por outro app que no  proprietrio do dispositivo ou pelo usurio diretamente, o usurio pode sair mantendo pressionados os botes Voltar e Recentes.</li>

</ul>

<h2 id="Printing">Impresso de framework</h2>

<h3 id="PDFRender">Renderizar PDF como bitmap</h3>
<p>Agora  possvel processar pginas de documentos PDF para imagens de bitmap e imprimi-las usando a nova classe {@link android.graphics.pdf.PdfRenderer}. Voc deve especificar um {@link android.os.ParcelFileDescriptor} que seja buscvel (isto , o contedo poder ser acessado aleatoriamente) e no qual o sistema registre o contedo imprimvel. O app pode obter uma pgina para processar com {@link android.graphics.pdf.PdfRenderer#openPage(int) openPage()} e depois chamar {@link android.graphics.pdf.PdfRenderer.Page#render(android.graphics.Bitmap, android.graphics.Rect, android.graphics.Matrix, int) render()} para desativar o {@link android.graphics.pdf.PdfRenderer.Page} aberto em um bitmap. Tambm  possvel definir parmetros adicionais se voc somente deseja converter uma parte do documento em uma imagem de bitmap (por exemplo, para implementar uma <a href="http://en.wikipedia.org/wiki/Tiled_rendering" class="external-link">renderizao de bloco</a> para zoom no documento).</p>

<p>Para obter um exemplo de como usar as novas APIs, consulte o exemplo {@code PdfRendererBasic}.</p>

<h2 id="System">Sistema</h2>
<h3 id="AppUsageStatistics">Estatsticas de uso do app</h3>
<p>Agora  possvel acessar o histrico de utilizao em um dispositivo Android com a nova {@link android.app.usage} API. Essa API fornece informaes mais detalhadas sobre o uso do mtodo suspenso {@link android.app.ActivityManager#getRecentTasks(int, int) getRecentTasks()}. Para usar essa API, primeiro  preciso declarar a permisso {@code "android.permission.PACKAGE_USAGE_STATS"} em seu manifesto. O usurio tambm deve permitir o acesso do app por meio de <em>Configuraes &gt; Segurana &gt; Apps</em> com acesso de uso.</p>

<p>O sistema coleta os dados de uso por apps, agregando os dados em intervalos dirios, semanais, mensais e anuais. A durao mxima pela qual o sistema mantm esses dados :</p>

<ul>
  <li>Dados dirios: sete dias</li>
  <li>Dados semanais: quatro semanas</li>
  <li>Dados mensais: seis meses</li>
  <li>Dados anuais: dois anos</li>
</ul>

<p>Para cada app, o sistema registra os seguintes dados:</p>
<ul>
<li>A ltima vez em que o app foi usado</li>
<li>O tempo total em que o app esteve em primeiro plano pelo intervalo de tempo (por dia, semana, ms ou ano)</li>
<li>Captura de carimbo de hora de um componente (identificado por um pacote e pelo nome da atividade) movido ao primeiro plano ou ao plano de fundo durante um dia</li>
<li>Captura de carimbo de hora quando a configurao de um dispositivo foi alterada (por exemplo, quando a orientao do dispositivo foi alterada devido  rotao)</li>
</ul>

<h2 id="TestingA11y">Testes e acessibilidade </h2>

<h3 id="TestingA11yImprovements">Melhorias de testes e acessibilidade</h3>
<p>O Android 5.0 adiciona o seguinte suporte a testes e acessibilidade:</p>

<ul>
<li>Os novos mtodos {@link android.app.UiAutomation#getWindowAnimationFrameStats() getWindowAnimationFrameStats()} e {@link android.app.UiAutomation#getWindowContentFrameStats(int) getWindowContentFrameStats()} capturam estatsticas de frame para animaes de janelas e contedos. Esses mtodos permitem registrar testes de instrumentao para avaliar se o app processa quadros em uma frequncia de atualizao suficiente para fornecer uma experincia contnua ao usurio.</li>

<li>O novo mtodo {@link android.app.UiAutomation#executeShellCommand(java.lang.String) executeShellCommand()} permite executar comandos do shell no teste de instrumentao. A execuo do comando  semelhante  execuo de {@code adb shell} em um host conectado ao dispositivo, permitindo o uso de ferramentas de shell como {@code dumpsys}, {@code am}, {@code content} e {@code pm}.</li>

<li>Servios de acessibilidade e ferramentas de teste que usam APIs de acessibilidade (como <a href="{@docRoot}tools/help/uiautomator/index.html">{@code UiAutomator}</a>) podem agora recuperar informaes detalhadas sobre as propriedades das janelas na tela com as quais os usurios com problemas visuais podem interagir. Para recuperar uma lista de objetos {@link android.view.accessibility.AccessibilityWindowInfo}, chame o novo mtodo {@link android.accessibilityservice.AccessibilityService#getWindows() getWindows()}.</li>

<li>A nova classe {@link android.view.accessibility.AccessibilityNodeInfo.AccessibilityAction} permite definir aes padro ou personalizadas para executar em um {@link android.view.accessibility.AccessibilityNodeInfo}. A nova classe {@link android.view.accessibility.AccessibilityNodeInfo.AccessibilityAction} substitui as APIs relativas a aes anteriormente encontradas em {@link android.view.accessibility.AccessibilityNodeInfo}.</li>

<li>O Android 5.0 fornece um controle mais detalhado sobre sntese de converso de texto em voz. A nova classe {@link android.speech.tts.Voice} permite que o app use perfis de voz associados a locais especficos, classificao de qualidade e latncia e parmetros especficos de mecanismos de converso de texto em voz.</li>
</ul>

<h2 id="IME">IME</h2>

<h3 id="Switching">Troca facilitada entre idiomas de entrada</h3>

<p>A partir do Android 5.0, os usurios podem facilmente alternar entre todos os <a href="{@docRoot}guide/topics/text/creating-input-method.html">editores de mtodo de entrada (IME)</a> compatveis com a plataforma. Executar a ao de comutao designada (normalmente tocando o cone de globo no teclado virtual) percorre todos os IMEs. Essa mudana de comportamento foi implementada pelo mtodo {@link android.view.inputmethod.InputMethodManager#shouldOfferSwitchingToNextInputMethod(android.os.IBinder) shouldOfferSwitchingToNextInputMethod()}.</p>

<p>Alm disso, o framework agora verifica se o prximo IME inclui um mecanismo de alternao (e, portanto, se o IME  compatvel com a alternao posterior ao IME). Um IME com mecanismo de alternao no passar a outro IME sem esse mecanismo. Essa mudana de comportamento foi implementada pelo mtodo {@link android.view.inputmethod.InputMethodManager#switchToNextInputMethod(android.os.IBinder, boolean) switchToNextInputMethod()}.

<p>Para saber um exemplo de como usar as APIs de alternao de IME atualizadas, consulte o exemplo atualizado de implementao de teclado virtual nesta verso. Para saber mais sobre como implementar a troca entre IMEs, consulte <a href="{@docRoot}guide/topics/text/creating-input-method.html">Criao de um mtodo de entrada</a>.
</p>

<h2 id="Manifest">Declaraes de manifesto</h2>

<h3 id="ManifestFeatures">Recursos necessrios declarveis</h3>
<p>Os seguintes valores agora so compatveis no elemento <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code <uses-feature>}</a>, para garantir que o app seja instalado somente em dispositivos que fornecem os recursos necessrios.</p>

<ul>
<li>{@link android.content.pm.PackageManager#FEATURE_AUDIO_OUTPUT}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_CAMERA_CAPABILITY_MANUAL_POST_PROCESSING}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_CAMERA_CAPABILITY_MANUAL_SENSOR}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_CAMERA_CAPABILITY_RAW}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_CAMERA_LEVEL_FULL}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_GAMEPAD}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_LIVE_TV}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_MANAGED_USERS}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_LEANBACK}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_OPENGLES_EXTENSION_PACK}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_SECURELY_REMOVES_USERS}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_SENSOR_AMBIENT_TEMPERATURE}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_SENSOR_HEART_RATE_ECG}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_SENSOR_RELATIVE_HUMIDITY}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_VERIFIED_BOOT}</li>
<li>{@link android.content.pm.PackageManager#FEATURE_WEBVIEW}</li>
</ul>

<h3 id="Permissions">Permisses do usurio</h3>

<p>A seguinte permisso agora  compatvel com o elemento <a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">{@code <uses-permission>}</a> para declarar as permisses exigidas por seu app para o acesso a algumas APIs.</p>

<ul>
<li>{@link android.Manifest.permission#BIND_DREAM_SERVICE}: ao segmentar para a API nvel 21 ou superior, essa permisso  necessria por um servio do <a href="{@docRoot}about/versions/android-4.2.html#Daydream">Daydream</a>, para garantir que somente o sistema pode se vincular a ele.</li>
</ul>