APIs do Android 6.0

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

Comece a desenvolver

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

Atualização do nível da API

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

Você pode usar APIs do Android e ainda 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 que não têm suporte da minSdkVersion. Para saber mais sobre como manter a compatibilidade com versões anteriores, leia Compatibilidade com 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 com impressão digital

Esta versão oferece novas APIs para permitir que você autentique usuários usando digitalizações de impressões digitais em dispositivos com suporte. Use essas APIs em conjunto com o sistema Android Keystore.

Para autenticar os usuários com a leitura de impressão digital, receba uma instância da nova classe FingerprintManager e chame o método authenticate(). Seu app precisa ser executado em um dispositivo compatível com um sensor de impressão digital. Implemente a interface do usuário para o fluxo de autenticação de impressão digital no app e use o ícone de impressão digital padrão do Android na sua 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 autenticação por impressão digital, observe que cada app precisa autenticar a impressão digital do usuário de maneira independente.

Para usar esse recurso no app, primeiro 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 da autenticação por impressão digital em um app, consulte o exemplo de autenticação biométrica. Para ver uma demonstração de como usar essas APIs de autenticação com outras APIs do Android, assista ao vídeo APIs de impressão digital e pagamento.

Se estiver testando esse recurso, siga estes passos:

  1. Instale o Android SDK Tools Revision 24.3, caso ainda não tenha instalado.
  2. Registre uma nova impressão digital no emulador acessando Settings > Security > Fingerprint e, em seguida, 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 os 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>.

credencial de confirmação

O aplicativo pode autenticar os usuários com base no quão recentemente o dispositivo foi desbloqueado pela última vez. Esse recurso evita que os usuários precisem se lembrar de outras senhas específicas do app e evita a necessidade de implementar uma interface do usuário de autenticação própria. 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 excessivamente a caixa de diálogo de reautenticação. Os apps precisam tentar usar o objeto criptográfico primeiro e, se o tempo limite expirar, usar o método createConfirmDeviceCredentialIntent() para autenticar novamente o usuário no app.

Vinculação de app

Esta versão aprimora o sistema de intent do Android fornecendo vínculo mais poderoso com o aplicativo. Este recurso permite que você associe um aplicativo a um domínio web próprio. 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 do app.

Backup automático para aplicativos

O sistema agora realiza backup automático completo e restauração de dados para aplicativos. Para ativar esse comportamento, o app precisa ser direcionado ao Android 6.0 (nível 23 da API). Não é necessário adicionar outros códigos. Se os usuários excluírem as contas Google, os dados de backup também serão excluídos. Para saber como esse recurso funciona e como configurar o backup no sistema de arquivos, consulte Configurar Backup automático para apps.

Compartilhamento direto

Parte inferior de um dispositivo móvel que exibe a funcionalidade de compartilhamento direto

Esta versão fornece APIs para tornar o compartilhamento intuitivo e rápido para os usuários. Agora você pode definir destinos de compartilhamento direto que iniciam uma atividade específica no seu app. Esses destinos de compartilhamento direto são expostos aos usuários por meio do menu Compartilhar. Esse recurso permite que os usuários compartilhem conteúdo com destinos, como contatos, dentro de outros apps. Por exemplo, o alvo 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 comunidade específica no app.

Para ativar os alvos de compartilhamento direto, é necessário definir 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 abaixo 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ê quiser 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 fornece uma nova API de interação por voz que, em conjunto com as Ações por voz, permite criar experiências de voz nos seus apps. Chame o método isVoiceInteraction() para determinar se uma ação por voz acionou a atividade. Nesse caso, o 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 por voz tem origem em um comando de voz do usuário. No entanto, uma atividade de interação por voz também pode ser iniciada sem a entrada do usuário. Por exemplo, outro app iniciado com 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 por voz do usuário ou por outro app de interação por voz, chame o método isVoiceInteractionRoot(). Se outro app iniciou sua atividade, o método retorna false. Seu app pode pedir que o usuário confirme que ele pretendia essa ação.

Para saber mais sobre a implementação de ações por voz, consulte o site para desenvolvedores sobre Ações por voz.

Assist API

Essa versão oferece uma nova maneira de os usuários se envolverem com os aplicativos 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 invocar o assistente dentro de qualquer app, mantendo o botão home pressionado.

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

Para fornecer contexto adicional do aplicativo ao assistente, siga estes passos:

  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. Adotar um dispositivo de armazenamento externo criptografa e formata o dispositivo para se comportar como um 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.

Caso seu app acesse as APIs ou os campos abaixo, saiba que os caminhos de arquivo retornados vão mudar dinamicamente quando o app for movido entre dispositivos de armazenamento interno e externo. Ao compilar caminhos de arquivo, recomendamos que essas APIs sempre sejam chamadas dinamicamente. Não use caminhos de arquivo criptografados nem persista em caminhos de arquivo totalmente qualificados que foram compilados anteriormente.

Para depurar esse recurso, você pode ativar a adoção de uma unidade USB que está conectada 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 de API para notificações:

Compatibilidade com Bluetooth Stylus

Esta versão oferece compatibilidade melhorada com entradas do usuário usando um Bluetooth Stylus. Os usuários podem parear e conectar uma stylus Bluetooth compatível com o smartphone ou tablet. Durante a conexão, as informações de posição da tela touchscreen são fundidas com as informações de botão e pressão da stylus para oferecer uma maior variedade de expressão do que 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 as constantes e os métodos MotionEvent para detectar interações do botão da stylus:

Análise aprimorada de Bluetooth Low Energy

Se o app realizar buscas por Bluetooth de baixa energia, use o novo método setCallbackType() para especificar que você quer que o sistema notifique callbacks quando encontrar pela primeira vez ou vir após um longo tempo um pacote de publicidade correspondente ao conjunto ScanFilter. Essa abordagem para leitura é mais eficiente em termos de energia do que a fornecida na versão anterior da plataforma.

Compatibilidade com Hotspot 2.0 versão 1

Esta versão adiciona compatibilidade com Hotspot 2.0 versão 1 para os dispositivos Nexus 6 e Nexus 9. Para provisionar credenciais de ponto de acesso 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 de ponto de acesso 2.0.

Modo de exibição em 4K

A plataforma agora permite que os apps solicitem o upgrade da resolução da tela para renderização 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 for redimensionada para uma resolução física maior, a resolução física retornada pelo método getPhysicalWidth() poderá ser diferente da resolução lógica informada por getSize().

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

ColorStateLists com tema

Os atributos de tema agora têm suporte no ColorStateList para dispositivos executados no 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 via 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 a fonte de áudio e as propriedades do coletor para substituir os padrões do sistema.
  • Ganchos de API para a associação de dispositivos de entrada e áudio. 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, extraia 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 no momento. Você também pode registrar um objeto AudioDeviceCallback se quiser que o sistema notifique seu app quando um dispositivo de áudio for conectado ou desconectado.

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 streams de áudio e vídeo de forma síncrona. Os buffers de áudio são enviados sem bloqueio e retornados por um callback. Eles também suportam a taxa de reprodução 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 porque foi movido para o estado terminal.
  • Nova interface getMaxSupportedInstances() para receber uma dica do número máximo compatível de instâncias de codec simultâneas.
  • Novo método setPlaybackParams(), que define a taxa de reprodução de mídia para reprodução em movimento rápido ou lento. Ele também prolonga 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 reprocessar imagens:

Flashlight API

Se um dispositivo de câmera tiver uma unidade de flash, é possível chamar o método setTorchMode() para ativar ou desativar o modo de lanterna da unidade de flash sem abrir o dispositivo da câmera. O app não tem propriedade exclusiva da unidade de flash nem do dispositivo de câmera. O modo lanterna é desativado e fica indisponível sempre que o dispositivo da câmera ficar 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 lanterna for fechado, o modo será desativado.

É possível registrar um callback para receber notificações sobre o status do modo lanterna chamando o método registerTorchCallback(). Na primeira vez que o callback é registrado, ele é imediatamente chamado com o status do modo 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.

Reprocessing API

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

Use a classe ImageWriter para conectar o fluxo do buffer de entrada à entrada de reprocessamento da câmera. Para obter 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 à 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 do buffer.

A classe ImageReader agora oferece suporte a fluxos de imagem 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 ao ImageWriter para reprocessamento da câmera.

Recursos do Android for Work

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

  • Controles aprimorados para dispositivos corporativos de uso único:o proprietário do dispositivo agora pode controlar as seguintes configurações para melhorar o gerenciamento de dispositivos de uso único corporativos (COSU):
  • Instalação e desinstalação silenciosa de apps pelo proprietário do dispositivo:um proprietário do dispositivo agora pode instalar e desinstalar aplicativos silenciosamente usando as APIs PackageInstaller, independente do Google Play for Work. Agora é possível provisionar dispositivos por meio de um proprietário do dispositivo que busca e instala apps sem interação do usuário. Esse recurso é útil para ativar o provisionamento com um toque de quiosques e outros dispositivos sem ativar uma Conta do Google.
  • Acesso silencioso ao certificado empresarial : quando um app chama choosePrivateKeyAlias(), antes de o usuário ser solicitado a selecionar um certificado, o perfil ou o proprietário 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(), um proprietário do dispositivo pode aceitar automaticamente uma atualização do sistema, no caso de um dispositivo de quiosque, ou adiar a atualização e impedir que ela seja feita 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 realizada, por exemplo, durante os horários 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 do dispositivo definiu uma política de atualização do sistema e se comporta de acordo.
  • Instalação de certificado delegado:um perfil ou proprietário do dispositivo agora pode conceder a um app de terceiros a capacidade de chamar essas APIs de gerenciamento de certificados do DevicePolicyManager:
  • Dispositivo móvel exibindo o recurso de notificação de status profissional no Android for Work
  • Acompanhamento do uso de dados. Um proprietário de perfil ou dispositivo agora 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.
  • Gerenciamento de permissões de execução:

    Um proprietário de dispositivo ou perfil pode definir uma política de permissão para todas as solicitações de execução de todos os aplicativos que usam setPermissionPolicy(), seja para solicitar que o usuário conceda a permissão ou conceder ou negar automaticamente a permissão silenciosamente. Se a última política for definida, o usuário não poderá modificar a seleção feita pelo perfil ou proprietário 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 sobre como essa VPN é configurada. 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 determinar se a VPN está configurada para todo o dispositivo.
  • Notificação de status de trabalho:um ícone de pasta da 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, um aviso será exibido notificando o usuário de que ele está no perfil de trabalho.