Módulo MediaProvider

O módulo MediaProvider otimiza metadados indexados (áudio, vídeo e imagens de cartões SD e dispositivos USB) e disponibiliza esses dados para apps pelas APIs públicas do MediaStore. Para manter a privacidade do usuário, o módulo MediaProvider aplica o modelo de segurança de armazenamento limitado introduzido no Android 10, que inclui a redação de metadados de local sensíveis. Esse módulo pode ser atualizado, permitindo que o Android responda mais rápido a problemas de segurança (mantendo os dados sensíveis do usuário protegidos) e adicione novos formatos de mídia mais rapidamente (oferecendo consistência para usuários e desenvolvedores).

Mudanças no Android 10

O Android 10 introduziu várias melhorias relacionadas à identificação e extração de dados de arquivos de mídia, especificamente:

  • Determinar o tipo de conteúdo do arquivo usando a primeira parte do tipo MIME dele. Por exemplo, o SO sabe que image/png e image/x-newly-invented-format são imagens e, portanto, pode descrever com precisão as permissões relevantes para o usuário final.

  • Determinar o tipo MIME usando apenas a extensão do arquivo (e sem usar detecção de conteúdo para evitar problemas de segurança).

  • Determinar o tipo MIME de um arquivo arbitrário usando uma combinação de mapeamentos upstream do Debian Linux e do Android.

  • Retornar dados relevantes dos arquivos video/* e audio/* (via MediaMetadataRetriever) e image/* (via ExifInterface).

Mudanças no Android 11

No Android 11, o módulo MediaProvider se baseia nas mudanças feitas no Android 10 com as seguintes melhorias:

  • Melhorias na indexação. O módulo MediaProvider agora indexa metadados reconciliando os metadados disponíveis com as APIs públicas do MediaStore. As mudanças incluem:

    • Nova coluna is_favorite e argumento QUERY_ARG_MATCH_FAVORITE para permitir que apps de estilo galeria filtrem rapidamente a mídia com base nessa coluna.

    • Indexação de metadados do espaço de cores.

    • Nova coluna "is_trashed" e argumento QUERY_ARG_MATCH_TRASHED para permitir que apps no estilo galeria filtrem com base nessa coluna.

    • Novas APIs que permitem a modificação em massa de vários itens com uma única solicitação de caixa de diálogo do usuário, incluindo createDeleteRequest(), createFavoriteRequest(), createTrashRequest() e createWriteRequest().

    • Novas colunas GENERATION_ADDED e GENERATION_MODIFIED para uso na detecção rápida e confiável de mudanças que ocorreram desde um ponto de sincronização anterior.

    • Nova API pública GROUP BY para uso com outras colunas de metadados não mencionadas acima.

  • Melhoria no ExifInterface para extrair metadados de contêineres PNG e WebP.

  • Melhorias no SystemUI para gravar metadados DateTimeOriginal em capturas de tela.

Além disso, agora é possível personalizar o MediaProvider adicionando novos formatos de mídia, marcando quais dispositivos de armazenamento precisam ser indexados e até mesmo substituindo a pilha MTP. Para mais detalhes, consulte Personalização.

Limite do módulo

O Android 11 migra todo o código em packages/providers/MediaProvider para um novo local, com a exceção notável da lógica relacionada ao MTP. Além disso, frameworks/base/core/java/android/provider/MediaStore.java agora está dentro do limite do módulo em packages/providers/MediaProvider.

Formato do pacote

O módulo MediaProvider está no formato APK-in-APEX.

Dependências

As dependências do MediaProvider estão relacionadas a personalizações. Ou seja, se você personalizar o MediaProvider, verifique se a implementação atende à dependência associada à personalização.

  • Ao usar formatos de arquivo de mídia personalizados ou não padrão (por exemplo, um formato gerado por um app de câmera específico do fornecedor), registre cada formato personalizado com MimeUtils e o módulo Media Extractor para ativar a indexação pelo MediaProvider.

  • Para garantir que o MediaProvider indexe um conjunto personalizado de dispositivos de armazenamento (como slots de cartão SD e portas USB) usados em uma implementação do StorageManagerService, defina a flag VolumeInfo.MOUNT_FLAG_INDEXABLE.

  • Ao usar uma implementação MTP personalizada (não AOSP), verifique se ela depende apenas de APIs públicas e do sistema para permitir que ela interaja com o MediaStore.

Personalização

Agora é possível adicionar novos formatos de mídia, influenciar quais dispositivos de armazenamento são indexados e substituir a pilha MTP.

  • Formatos de mídia personalizados. Para cada novo formato de mídia personalizado, você precisa fornecer um mapeamento da extensão de arquivo exclusiva para um tipo MIME. Recomendamos que você siga o processo de registro da IANA (em inglês).

    • Não é possível redefinir uma extensão ou um tipo MIME que já esteja definido no AOSP.

    • Para arquivos video/* e audio/*, o MediaProvider continua consultando MediaMetadataRetriever. Use os extratores de mídia do Android 10 para retornar metadados de formatos personalizados.

    • Para arquivos image/*, o MediaProvider continua padronizando Exif para metadados. É possível estender o android.media.ExifInterface para extrair e retornar metadados Exif de qualquer formato de imagem personalizado.

  • Flag de indexação de dispositivos de armazenamento. O MediaProvider indexa todos os volumes retornados por StorageManager.getStorageVolumes() em que StorageVolume.getMediaStoreVolumeName() não é nulo. É possível personalizar a lista de volumes retornados para influenciar o que é indexado, mas não recomendamos incluir volumes temporários, como unidades USB OTG.

  • Substituição da pilha MTP. O Android 11 coloca a pilha MTP inteiramente fora do limite do módulo e garante que ela funcione com APIs públicas.

Teste

É possível verificar a funcionalidade do MediaProvider usando os seguintes testes:

  • Para verificar a funcionalidade das APIs públicas do MediaStore, use testes no pacote CtsProviderTestCases do conjunto de teste de compatibilidade (CTS) do Android.

  • Para verificar a funcionalidade dos internos do MediaProvider, use testes em MediaProviderTests.

Para executar os dois conjuntos de testes juntos, use o seguinte comando atest:

atest --test-mapping packages/providers/MediaProvider