Lista de verificação de testes da HAL da câmera

Esta página lista todos os testes disponíveis para avaliar a camada de abstração de hardware da câmera do Android (HAL). Ele é destinado a fabricantes de equipamentos originais (OEMs) e fornecedores de processadores de aplicativos (APs) para garantir a implementação adequada do HAL da câmera com o mínimo de defeitos. Embora seja uma adição voluntária ao Teste de compatibilidade do Android (CTS), ela aumenta muito a cobertura do teste da câmera e certamente identifica possíveis bugs.

Ao passar nesses testes, os OEMs validam se integraram corretamente as interfaces 3 da camada de abstração de hardware da câmera do Android. Quando em conformidade com todos os itens da lista de verificação, uma implementação de dispositivo pode ser considerada completa em relação às interfaces HAL da câmera do Android. Isso, por sua vez, vai permitir que um dispositivo ofereça suporte adequado ao pacote android.hardware.camera2 que os apps de câmera usam como base.

Especificação da HAL3 da câmera

A especificação HAL3 da câmera do Android é a fonte oficial de informações sobre o que os dispositivos precisam atender. Esta página fornece um resumo de todos os testes que podem ser usados como uma lista de verificação. Os implementadores da HAL da câmera (por exemplo, fornecedores de APs) precisam analisar a especificação da HAL da câmera 3 linha por linha e garantir que os dispositivos estejam em conformidade com ela.

A especificação atual do HAL é definida nestes arquivos no Android 5.0 e versões mais recentes do kit de desenvolvimento de plataforma (PDK, na sigla em inglês) genérico do Android:

Tipos de teste de câmera

Confira os principais tipos de testes disponíveis para a câmera mais recente do Android e as referências às instruções associadas abaixo:

Todos esses tipos de teste são descritos em detalhes abaixo. Esses testes são apresentados na ordem cronológica em que os OEMs devem executá-los.

Por exemplo, se um dispositivo falhar nos testes nativos, ele certamente falhará nos testes do conjunto de teste de compatibilidade (CTS) subsequentes. E se um dispositivo falhar no CTS, não há muito uso para prosseguir para o conjunto de teste de imagem (ITS). Recomendamos resolver falhas em cada tipo de teste antes de passar para o próximo conjunto de testes.

Testes do pacote de teste de fornecedor (VTS)

O Conjunto de teste de fornecedor do Android (VTS, na sigla em inglês) é um pacote de testes que funciona no nível da interface HIDL. Para mais informações sobre o uso do VTS, consulte Conjunto de teste de fornecedor.

Testes do conjunto de teste de compatibilidade (CTS)

Os testes do conjunto de teste de compatibilidade do Android (CTS) da câmera se concentram na compatibilidade do dispositivo. Para informações sobre como configurar um ambiente de teste, consulte Como configurar o CTS.

O caminho inicial para os testes de CTS da câmera é: platform/cts.

Ao executar o CTS da câmera para dispositivos com suporte a câmeras externas (como webcams USB), é necessário ter um dispositivo conectado ao executar o CTS, caso contrário, os testes vão falhar automaticamente. Exemplos de câmeras externas incluem: Logitech HD Pro Webcam C920 e Microsoft LifeCam HD-3000.

Consulte a introdução do CTS e as subpáginas para instruções gerais sobre como executar o CTS.

Testes do CTS para a API android.hardware.Camera

Encontre estes testes de câmera em cts/tests/tests/:

  • hardware/src/android/hardware/cts/CameraTest.java
  • hardware/src/android/hardware/cts/CameraGLTest.java
  • hardware/src/android/hardware/cts/Camera_SizeTest.java
  • permission/src/android/permission/cts/CameraPermissionTest.java

Testes do CTS para a API android.hardware.camera2

Encontre estes testes de câmera em cts/tests/tests/:

  • hardware/src/android/hardware/camera2/cts/*
  • permission/src/android/permission/cts/Camera2PermissionTest.java

Testes de câmera do CTS Verifier

Encontre esses testes de câmera em: cts/apps/CtsVerifier/src/com/android/cts/verifier/camera/*

Testes do pacote de testes de imagem (ITS)

Os testes do pacote de testes de imagens da câmera (ITS, na sigla em inglês) se concentram na correção da imagem. Para realizar os testes, execute os scripts Python em uma estação de trabalho com o dispositivo Android conectado por USB.

A infraestrutura e os testes do ITS da câmera estão localizados no diretório cts/apps/CameraITS. Cada teste está em um subdiretório tests/scene#.

Para mais informações sobre como configurar e executar os testes, consulte Camera ITS.

Para descrições de cenas e testes, consulte Testes de ITS da câmera.

Os testes de ITS são aprovados ou reprovados. Todos os testes obrigatórios em cada pasta de cena precisam ser aprovados. Os testes que não são obrigatórios podem ser reprovados e ainda contar como uma aprovação em CtsVerifier.

Os testes do ITS testam cenários que não são testados no CTS e são um componente importante do plano de teste do HAL 3.2.

Testes do Media Framework

Aprovação de todos os testes de mídia relacionados à câmera no MediaFrameworkTest. Esses testes exigem que o mediaframeworktest.apk esteja instalado no dispositivo Android. Você vai precisar make mediaframeworktest e usar o adb para instalar o .apk resultante. Confira abaixo exemplos de comandos.

O caminho inicial para os testes do framework de mídia relacionado à câmera é: platform/frameworks/base

Encontre o código-fonte dos testes aqui: frameworks/base/media/tests/MediaFrameworkTest

Para configurar esses testes:

make mediaframeworktest
adb install out/target/product/name/data/app/mediaframeworktest.apk

em que a variável name representa o diretório que contém o produto do fornecedor.

Encontre todos os testes no diretório a seguir ou nos subdiretórios dele:

frameworks/base/media/tests/MediaFrameworkTest/src/com/android/mediaframeworktest

Cada subdiretório representa uma classe de testes:

  • functional/
  • integration/
  • performance/
  • power/
  • stress/
  • unit/

Executar testes do Media Framework

Para conferir todos os testes disponíveis:

adb shell pm list instrumentation

Isso vai gerar resultados semelhantes a estes:

instrumentation:com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaRecorderStressTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaFrameworkPowerTestRunner
(target=com.android.mediaframeworktest)

Identifique e extraia o componente (entre instrumentation: e (target=com.android.mediaframeworktest) de cada linha de teste). O componente é composto pelo nome do pacote de destino (com.android.mediaframeworktest) e pelo nome do executor de teste (MediaFrameworkTestRunner).

Por exemplo:

com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner
com.android.mediaframeworktest/.MediaRecorderStressTestRunner
com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner
com.android.mediaframeworktest/.MediaFrameworkPowerTestRunner

Em seguida, transmita cada componente para adb shell am instrument assim:

adb shell am instrument -w component.name

Em que component.name é igual ao valor extraído acima. Por exemplo:

adb shell am instrument -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Embora o caminho da classe seja o pacote Java + nome da classe, o pacote de instrumentação não é necessariamente o mesmo que o pacote Java. Use o pacote AndroidManifest.xml ao concatenar o nome do componente, não o pacote Java em que a classe de execução de teste está armazenada.

Para executar uma única classe de testes, transmita o argumento da classe -e, como este:

adb shell am instrument -e class com.android.mediaframeworktest.integration.CameraBinderTest -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Para executar apenas um método em uma classe de teste, anexe um sinal de número (#) e o nome do método (neste caso, testConnectPro) ao nome da classe, como este:

adb shell am instrument -e class 'com.android.mediaframeworktest.integration.CameraBinderTest#testConnectPro' -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Testes funcionais das configurações de mídia

Confira um exemplo de execução de um teste funcional. Esse teste verifica a funcionalidade básica de diferentes combinações de configurações da câmera. (por exemplo, flash, exposição, WB, cena, tamanho da imagem e geotag)

Execute o comando de teste:

adb shell am instrument -w -r  -e delay_msec 15 -e log true -e class com.android.mediaframeworktest.functional.camera.CameraPairwiseTest com.android.mediaframeworktest/com.android.mediaframeworktest.CameraStressTestRunner

Testes de integração de mídia

Confira um exemplo de execução de um teste de integração, neste caso mediaframeworktest/integration/CameraBinderTest.java e mediaframeworktest/CameraStressTestRunner.java:

adb  shell am instrument -e class \ 'com.android.mediaframeworktest.integration.CameraBinderTest' -w \ 'com.android.mediaframeworktest/.CameraStressTestRunner'

Se for bem-sucedido, o resultado será semelhante a este:

-----

com.android.mediaframeworktest.integration.CameraBinderTest:...........
Test results for CameraStressTestRunner=...........
Time: 3.328

OK (11 tests)

-----

Testes de performance de mídia

Esse teste de memória de visualização vai abrir e liberar a visualização da câmera 200 vezes. Em cada 20 iterações, o snapshot do ps mediaserver será gravado e vai comparar o uso da memória de forma diferente após 200 iterações. O teste vai falhar se a diferença for maior que 150 mil.

Execute o comando de teste:

adb shell am instrument -w -r  -e class com.android.mediaframeworktest.performance.MediaPlayerPerformance#testCameraPreviewMemoryUsage com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner

Confira uma saída mais detalhada em: /sdcard/mediaMemOutput.txt

Testes de unidade de mídia

Os comandos para executar testes de unidade são semelhantes. Por exemplo, para CameraMetadataTest.java, o comando seria:

adb shell am instrument -e class 'com.android.mediaframeworktest.unit.CameraMetadataTest' -w 'com.android.mediaframeworktest/.CameraStressTestRunner'

Testes de estresse de mídia

O objetivo do teste é sobrecarregar a captura de imagens da câmera e a gravação de vídeo.

Execute o comando de teste:

adb shell am instrument -w com.google.android.camera.tests/com.android.camera.stress.CameraStressTestRunner

Todos os testes precisam ser aprovados.

Testes manuais da Câmera de teste

O app TestingCam precisa ser executado manualmente com as seguintes verificações. A fonte da TestingCam está aqui: pdk/apps/TestingCamera/

Foco infinito com inclinação da câmera

Inicie o TestingCam, ative a visualização e verifique se o modo de foco automático está definido como infinito. Usando o botão Tirar foto, capture imagens de sujeitos distantes (pelo menos 10 m de distância) com a câmera apontada horizontalmente, para cima (quase vertical) e para baixo (quase vertical). Um exemplo de imagem para cima pode ser folhas/galhos altos de uma árvore vistos de baixo, e um exemplo de imagem para baixo pode ser a rua vista do telhado de um prédio. Em todos os casos, o objeto distante precisa estar nítido e em foco. Salve e confira as fotos na visualização de galeria para poder aumentar o zoom e inspecionar a nitidez com mais facilidade.

Para que uma câmera com um atuador VCM seja aprovada neste teste, ela precisa ter um sistema de controle de AF de circuito fechado ou algum tipo de correção de software com base no uso de dados do acelerômetro para determinar a orientação da câmera. Também será necessária uma calibração confiável de fábrica da posição de infinito da lente.

Testes manuais do Teste de câmera 2

O app TestingCam2 precisa ser executado manualmente, com as seguintes verificações realizadas. A origem da TestingCam2 está aqui: pdk/apps/TestingCamera2/

Captura de JPEG

Inicie o TestingCam2 e pressione o botão JPEG. A imagem que aparece à direita da imagem do visor precisa ser igual à do visor, incluindo a mesma orientação.