APIs do Android 6.0

O Android 6.0 (M) oferece novos recursos para usuários e desenvolvedores de apps. Este documento apresenta uma introdução às APIs mais importantes.

Começar a desenvolver

Para começar a criar apps para o Android 6.0, primeiro é necessário fazer o download do SDK do Android. Em seguida, use o SDK Manager para fazer o download da plataforma do SDK e das imagens do sistema do Android 6.0.

Atualizar o nível desejado da API

Para otimizar melhor seu app para dispositivos com Android, defina o targetSdkVersion como "23", instale o app em uma imagem do sistema Android, teste-o e publique o app atualizado com essa mudança.

É possível usar as APIs do Android e, ao mesmo tempo, oferecer suporte a versões mais antigas adicionando condições ao código que verificam o nível da API do sistema antes de executar APIs não compatíveis com o minSdkVersion. Para saber mais sobre como manter a compatibilidade com versões anteriores, leia Suporte a diferentes versões da plataforma.

Para mais informações sobre como os níveis da API funcionam, leia O que é o nível da API?.

Autenticação por impressão digital

Esta versão oferece novas APIs para autenticar usuários usando as impressões digitais deles em dispositivos compatíveis. Use essas APIs em conjunto com o sistema Android Keystore.

Para autenticar usuários usando a leitura de impressão digital, acesse uma instância da nova classe FingerprintManager e chame o método authenticate(). O app precisa estar em execução em um dispositivo compatível com um sensor de impressão digital. É necessário implementar a interface do usuário para o fluxo de autenticação por impressão digital no app e usar o ícone padrão de impressão digital do Android na interface. O ícone de impressão digital do Android (c_fp_40px.png) está incluído no exemplo de autenticação biométrica. Se você estiver desenvolvendo vários apps que usam a autenticação por impressão digital, cada um deles precisará autenticar a impressão digital do usuário de forma independente.

Para usar esse recurso no app, adicione a permissão USE_FINGERPRINT ao manifesto.

<uses-permission
        android:name="android.permission.USE_FINGERPRINT" />
Dispositivo móvel mostrando a funcionalidade de autenticação por impressão digital

Para conferir uma implementação de app de autenticação por impressão digital, consulte o exemplo de autenticação biométrica. Para uma demonstração de como usar essas APIs de autenticação em conjunto com outras APIs do Android, assista ao vídeo APIs de impressão digital e pagamento.

Se você estiver testando esse recurso, siga estas etapas:

  1. Instale a revisão 24.3 das Ferramentas do SDK do Android, se ainda não tiver feito isso.
  2. Registre uma nova impressão digital no emulador acessando Configurações > Segurança > Impressão digital e siga as instruções de registro.
  3. Use um emulador para emular eventos de toque de impressão digital com o comando a seguir. Use o mesmo comando para emular eventos de toque de impressão digital na tela de bloqueio ou no app.
    adb -e emu finger touch <finger_id>
    

    No Windows, talvez seja necessário executar telnet 127.0.0.1 <emulator-id> seguido por finger touch <finger_id>.

Confirmação de credencial

Seu app pode autenticar usuários com base em quando eles desbloquearam o dispositivo pela última vez. Esse recurso evita que os usuários precisem se lembrar de outras senhas específicas do app e que você precise implementar sua própria interface do usuário de autenticação. O app precisa usar esse recurso em conjunto com uma implementação de chave pública ou secreta para autenticação do usuário.

Para definir o tempo limite em que a mesma chave pode ser reutilizada após a autenticação do usuário, chame o novo método setUserAuthenticationValidityDurationSeconds() ao configurar um KeyGenerator ou KeyPairGenerator.

Evite mostrar a caixa de diálogo de reautenticação em excesso. Seus apps precisam tentar usar o objeto criptográfico primeiro e, se o tempo limite expirar, usar o método createConfirmDeviceCredentialIntent() para reautenticar o usuário no app.

Vinculação de apps

Esta versão aprimora o sistema de intents do Android, oferecendo uma vinculação de apps mais eficiente. Esse recurso permite associar um app a um domínio da Web que você possui. Com base nessa associação, a plataforma pode determinar o app padrão a ser usado para processar um link da Web específico e não solicitar que os usuários selecionem um app. Para saber como implementar esse recurso, consulte Como processar links de apps.

Backup automático para apps

Agora, o sistema realiza backup e restauração automáticos de dados completos para apps. Seu app precisa ser destinado ao Android 6.0 (nível 23 da API) para ativar esse comportamento. Não é necessário adicionar nenhum código extra. Se os usuários excluírem as Contas do Google, os dados de backup também serão excluídos. Para saber como esse recurso funciona e como configurar o que será armazenado em backup no sistema de arquivos, consulte Configurar o backup automático para apps.

Compartilhamento direto

Parte de baixo de um dispositivo móvel mostrando a funcionalidade de compartilhamento direto

Esta versão oferece APIs para tornar o compartilhamento intuitivo e rápido para os usuários. Agora é possível definir destinos de compartilhamento direto que iniciam uma atividade específica no seu app. Esses destinos de compartilhamento direto são mostrados aos usuários no menu Compartilhar. Esse recurso permite que os usuários compartilhem conteúdo com destinos, como contatos, em outros apps. Por exemplo, o destino de compartilhamento direto pode iniciar uma atividade em outro app de rede social, o que permite que o usuário compartilhe conteúdo diretamente com um amigo ou uma comunidade específica nesse app.

Para ativar os destinos de compartilhamento direto, defina uma classe que estenda a classe ChooserTargetService. Declare o serviço no manifesto. Nessa declaração, especifique a permissão BIND_CHOOSER_TARGET_SERVICE e um filtro de intent usando a ação SERVICE_INTERFACE.

O exemplo a seguir mostra como declarar o ChooserTargetService no manifesto.

<service android:name=".ChooserTargetService"
        android:label="@string/service_name"
        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
    <intent-filter>
        <action android:name="android.service.chooser.ChooserTargetService" />
    </intent-filter>
</service>

Para cada atividade que você quer expor ao ChooserTargetService, adicione um elemento <meta-data> com o nome "android.service.chooser.chooser_target_service" no manifesto do app.

<activity android:name=".MyShareActivity"
        android:label="@string/share_activity_label">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
    </intent-filter>
<meta-data
        android:name="android.service.chooser.chooser_target_service"
        android:value=".ChooserTargetService" />
</activity>

Interações por voz

Esta versão oferece uma nova API Interactions que, junto com os Comandos de voz, permite criar experiências de conversa por voz nos seus apps. Chame o método isVoiceInteraction() para determinar se um comando de voz acionou sua atividade. Se sim, seu app pode usar a classe VoiceInteractor para solicitar uma confirmação por voz do usuário, selecionar em uma lista de opções e muito mais.

A maioria das interações de voz se origina de um comando de voz do usuário. No entanto, uma atividade de interação por voz também pode ser iniciada sem entrada do usuário. Por exemplo, outro app iniciado por uma interação por voz também pode enviar uma intent para iniciar uma interação por voz. Para determinar se a atividade foi iniciada por uma consulta de voz do usuário ou por outro app de interação por voz, chame o método isVoiceInteractionRoot(). Se outro app tiver iniciado sua atividade, o método vai retornar false. O app pode pedir que o usuário confirme que essa era a intenção dele.

Para saber mais sobre como implementar comandos de voz, consulte o site para desenvolvedores de comandos de voz.

API Assist

Esta versão oferece uma nova maneira de os usuários interagirem com seus apps usando um assistente. Para usar esse recurso, o usuário precisa permitir que o assistente use o contexto atual. Depois de ativado, o usuário pode chamar o assistente em qualquer app, tocando e mantendo pressionado o botão home.

Seu app pode optar por não compartilhar o contexto atual com o assistente definindo a flag FLAG_SECURE. Além do repositório curricular de informações que a plataforma transmite ao assistente, seu app pode compartilhar outras informações usando a nova classe AssistContent.

Para fornecer ao assistente mais contexto do seu app, siga estas etapas:

  1. Implemente a interface Application.OnProvideAssistDataListener.
  2. Registre esse listener usando registerOnProvideAssistDataListener().
  3. Para fornecer informações contextuais específicas da atividade, substitua o callback onProvideAssistData() e, se quiser, o novo callback onProvideAssistContent().

Dispositivos de armazenamento adotáveis

Com essa versão, os usuários podem adotar dispositivos de armazenamento externo, como cartões SD. A adoção de um dispositivo de armazenamento externo criptografa e formata o dispositivo para que ele se comporte como armazenamento interno. Esse recurso permite que os usuários movam apps e dados particulares desses apps entre dispositivos de armazenamento. Ao mover apps, o sistema respeita a preferência android:installLocation no manifesto.

Se o app acessar as APIs ou os campos a seguir, os caminhos de arquivo retornados vão mudar dinamicamente quando o app for movido entre dispositivos de armazenamento interno e externo. Ao criar caminhos de arquivo, é altamente recomendável sempre chamar essas APIs de forma dinâmica. Não use caminhos de arquivo fixados no código nem persista caminhos de arquivo totalmente qualificados que foram criados anteriormente.

Para depurar esse recurso, você pode ativar a adoção de um drive USB conectado a um dispositivo Android por um cabo USB On-The-Go (OTG) executando este comando:

$ adb shell sm set-force-adoptable true

Notificações

Esta versão adiciona as seguintes mudanças na API para notificações:

Suporte para stylus Bluetooth

Esta versão oferece suporte aprimorado para entrada do usuário usando uma stylus Bluetooth. Os usuários podem parear e conectar uma stylus Bluetooth compatível com o smartphone ou tablet. Enquanto estiver conectada, as informações de posição da tela touchscreen serão combinadas com as informações de pressão e botão da stylus para oferecer uma gama maior de expressão do que apenas com a tela touchscreen. Seu app pode detectar pressionamentos de botão da stylus e realizar ações secundárias registrando objetos View.OnContextClickListener e GestureDetector.OnContextClickListener na atividade.

Use os métodos e as constantes de MotionEvent para detectar interações com o botão da caneta stylus:

Melhoria na busca por Bluetooth de baixa energia

Se o app realizar verificações de Bluetooth de baixa energia, use o novo método setCallbackType() para especificar que você quer que o sistema notifique os callbacks quando encontrar pela primeira vez, ou depois de muito tempo, um pacote de anúncio que corresponda ao ScanFilter definido. Essa abordagem de verificação é mais eficiente em termos de energia do que a fornecida na versão anterior da plataforma.

Suporte ao Hotspot 2.0 Release 1

Esta versão adiciona suporte à especificação Hotspot 2.0 Release 1 em dispositivos Nexus 6 e Nexus 9. Para provisionar credenciais do Hotspot 2.0 no app, use os novos métodos da classe WifiEnterpriseConfig, como setPlmn() e setRealm(). No objeto WifiConfiguration, é possível definir os campos FQDN e providerFriendlyName. O novo método isPasspointNetwork() indica se uma rede detectada representa um ponto de acesso do Hotspot 2.0.

Modo de exibição 4K

Agora, a plataforma permite que os apps solicitem que a resolução da tela seja atualizada para renderização em 4K em hardware compatível. Para consultar a resolução física atual, use as novas APIs Display.Mode. Se a interface for desenhada em uma resolução lógica mais baixa e ampliada para uma resolução física maior, a resolução física retornada pelo método getPhysicalWidth() pode ser diferente da resolução lógica informada por getSize().

É possível solicitar que o sistema mude a resolução física no app enquanto ele é executado, definindo a propriedade preferredDisplayModeId da janela do app. Esse recurso é útil se você quiser mudar para a resolução de tela 4K. No modo de exibição 4K, a interface continua sendo renderizada na resolução original (como 1080p) e é ampliada para 4K, mas os objetos SurfaceView podem mostrar conteúdo na resolução nativa.

ColorStateLists com suporte a temas

Os atributos de tema agora são compatíveis com ColorStateList para dispositivos com o Android 6.0 (nível 23 da API). Os métodos Resources.getColorStateList() e Resources.getColor() foram descontinuados. Se você estiver chamando essas APIs, chame os novos métodos Context.getColorStateList() ou Context.getColor(). Esses métodos também estão disponíveis na biblioteca appcompat v4 usando ContextCompat.

Recursos de áudio

Esta versão adiciona melhorias ao processamento de áudio no Android, incluindo:

  • Suporte ao protocolo MIDI, com as novas APIs android.media.midi. Use essas APIs para enviar e receber eventos MIDI.
  • Novas classes AudioRecord.Builder e AudioTrack.Builder para criar objetos de captura e reprodução de áudio digital, respectivamente, e configurar as propriedades de origem e destino de áudio para substituir os padrões do sistema.
  • Hooks de API para associar dispositivos de áudio e entrada. Isso é particularmente útil se o app permite que os usuários iniciem uma pesquisa por voz em um controle de jogo ou controle remoto conectado ao Android TV. O sistema invoca o novo callback onSearchRequested() quando o usuário inicia uma pesquisa. Para determinar se o dispositivo de entrada do usuário tem um microfone integrado, recupere o objeto InputDevice desse callback e chame o novo método hasMicrophone().
  • Novo método getDevices(), que permite recuperar uma lista de todos os dispositivos de áudio conectados ao sistema. Você também pode registrar um objeto AudioDeviceCallback se quiser que o sistema notifique seu app quando um dispositivo de áudio se conectar ou desconectar.

Recursos de vídeo

Esta versão adiciona novos recursos às APIs de processamento de vídeo, incluindo:

  • Nova classe MediaSync que ajuda os aplicativos a renderizar de forma síncrona streams de áudio e vídeo. Os buffers de áudio são enviados de maneira não bloqueante e são retornados usando um callback. Ele também é compatível com a velocidade do vídeo dinâmica.
  • Novo evento EVENT_SESSION_RECLAIMED, que indica que uma sessão aberta pelo app foi recuperada pelo gerenciador de recursos. Se o app usa sessões de DRM, processe esse evento e não use uma sessão recuperada.
  • Novo código de erro ERROR_RECLAIMED, que indica que o gerenciador de recursos recuperou o recurso de mídia usado pelo codec. Com essa exceção, o codec precisa ser liberado, já que foi movido para o estado terminal.
  • Nova interface getMaxSupportedInstances() para receber uma dica sobre o número máximo de instâncias de codec simultâneas com suporte.
  • Novo método setPlaybackParams() para definir a velocidade do vídeo para reprodução rápida ou em câmera lenta. Ele também estica ou acelera a reprodução de áudio automaticamente em conjunto com o vídeo.

Recursos da câmera

Esta versão inclui as seguintes novas APIs para acessar a lanterna da câmera e para reprocessamento de imagens da câmera:

API Flashlight

Se um dispositivo de câmera tiver uma unidade de flash, você poderá chamar o método setTorchMode() para ativar ou desativar o modo de lanterna da unidade de flash sem abrir o dispositivo de câmera. O app não tem propriedade exclusiva da unidade de flash ou do dispositivo de câmera. O modo lanterna é desativado e fica indisponível sempre que o dispositivo de câmera fica indisponível ou quando outros recursos da câmera que mantêm a lanterna ligada ficam indisponíveis. Outros apps também podem chamar setTorchMode() para desativar o modo lanterna. Quando o último app que ativou o modo de lanterna é fechado, o modo de lanterna é desativado.

Você pode registrar um callback para receber notificações sobre o status do modo de lanterna chamando o método registerTorchCallback(). Na primeira vez que o callback é registrado, ele é chamado imediatamente com o status do modo de lanterna de todos os dispositivos de câmera conhecidos com uma unidade de flash. Se o modo lanterna for ativado ou desativado, o método onTorchModeChanged() será invocado.

API de reprocessamento

A API Camera2 foi estendida para oferecer suporte ao reprocessamento de imagens em formato opaco particular e YUV. Para determinar se esses recursos de reprocessamento estão disponíveis, chame getCameraCharacteristics() e verifique a chave REPROCESS_MAX_CAPTURE_STALL. Se um dispositivo for compatível com o reprocessamento, será possível criar uma sessão de captura de câmera reprocessável chamando createReprocessableCaptureSession() e criar solicitações para o reprocessamento do buffer de entrada.

Use a classe ImageWriter para conectar o fluxo do buffer de entrada à entrada de reprocessamento da câmera. Para receber um buffer vazio, siga este modelo de programação:

  1. Chame o método dequeueInputImage().
  2. Preencha os dados no buffer de entrada.
  3. Envie o buffer para a câmera chamando o método queueInputImage().

Se você estiver usando um objeto ImageWriter com uma imagem PRIVATE, o app não poderá acessar os dados da imagem diretamente. Em vez disso, transmita a imagem PRIVATE diretamente para o ImageWriter chamando o método queueInputImage() sem nenhuma cópia de buffer.

A classe ImageReader agora oferece suporte a streams de imagens no formato PRIVATE. Esse suporte permite que o app mantenha uma fila circular de imagens de saída ImageReader, selecione uma ou mais imagens e as envie para o ImageWriter para reprocessamento da câmera.

Recursos do Android for Work

Esta versão inclui as seguintes novas APIs para o Android for Work:

  • Controles aprimorados para dispositivos de uso único de propriedade corporativa: o proprietário do dispositivo agora pode controlar as seguintes configurações para melhorar o gerenciamento de dispositivos de uso único de propriedade corporativa (COSU, na sigla em inglês):
  • Instalação e desinstalação silenciosas de apps pelo proprietário do dispositivo: agora, um proprietário de dispositivo pode instalar e desinstalar aplicativos silenciosamente usando as APIs PackageInstaller, independentemente do Google Play para empresas. Agora é possível provisionar dispositivos por um proprietário que busca e instala apps sem interação do usuário. Esse recurso é útil para permitir o provisionamento com um toque de quiosques ou outros dispositivos sem ativar uma Conta do Google.
  • Acesso silencioso ao certificado corporativo: quando um app chama choosePrivateKeyAlias(), antes que o usuário seja solicitado a selecionar um certificado, o proprietário do perfil ou do dispositivo agora pode chamar o método onChoosePrivateKeyAlias() para fornecer o alias silenciosamente ao aplicativo solicitante. Esse recurso permite que você conceda aos apps gerenciados acesso a certificados sem interação do usuário.
  • Aceitação automática de atualizações do sistema. Ao definir uma política de atualização do sistema com setSystemUpdatePolicy(), o proprietário do dispositivo pode aceitar automaticamente uma atualização do sistema, por exemplo, no caso de um dispositivo de quiosque, ou adiar a atualização e impedir que ela seja realizada pelo usuário por até 30 dias. Além disso, um administrador pode definir uma janela de tempo diária em que uma atualização precisa ser feita, por exemplo, durante as horas em que um dispositivo de quiosque não está em uso. Quando uma atualização do sistema está disponível, o sistema verifica se o app controlador de política de dispositivo definiu uma política de atualização do sistema e se comporta de acordo.
  • Instalação de certificado delegada: agora, um proprietário de perfil ou dispositivo pode conceder a um app de terceiros a capacidade de chamar estas APIs de gerenciamento de certificados DevicePolicyManager:
  • Dispositivo móvel mostrando o recurso de notificação de status de trabalho no Android for Work
  • Monitoramento do uso de dados. Agora, um proprietário de perfil ou dispositivo pode consultar as estatísticas de uso de dados visíveis em Configurações > Uso de dados usando os novos métodos NetworkStatsManager. Os proprietários de perfil recebem automaticamente permissão para consultar dados no perfil que gerenciam, enquanto os proprietários de dispositivo têm acesso aos dados de uso do usuário principal gerenciado.
  • Gestão de permissões de execução:

    Um proprietário de perfil ou dispositivo pode definir uma política de permissões para todas as solicitações de execução de todos os aplicativos usando setPermissionPolicy(), para solicitar que o usuário conceda a permissão ou conceder ou negar a permissão automaticamente. Se a última política for definida, o usuário não poderá modificar a seleção feita pelo proprietário do perfil ou do dispositivo na tela de permissões do app em Configurações.

  • VPN em Configurações: os apps de VPN agora estão visíveis em Configurações > Mais > VPN. Além disso, as notificações que acompanham o uso da VPN agora são específicas para a configuração dela. Para o proprietário do perfil, as notificações são específicas para saber se a VPN está configurada para um perfil gerenciado, um perfil pessoal ou ambos. Para um proprietário do dispositivo, as notificações são específicas para indicar se a VPN está configurada para todo o dispositivo.
  • Notificação de status de trabalho: um ícone de pasta na barra de status agora aparece sempre que um app do perfil gerenciado tem uma atividade em primeiro plano. Além disso, se o dispositivo for desbloqueado diretamente para a atividade de um app no perfil gerenciado, uma mensagem será exibida notificando o usuário de que ele está no perfil de trabalho.